2015-09-15 01:10:11 +00:00
|
|
|
---
|
|
|
|
layout: "docs"
|
|
|
|
page_title: "Commands: node-drain"
|
|
|
|
sidebar_current: "docs-commands-node-drain"
|
|
|
|
description: >
|
|
|
|
Toggle drain mode for a given node.
|
|
|
|
---
|
|
|
|
|
2015-09-15 03:24:04 +00:00
|
|
|
# Command: node-drain
|
2015-09-15 01:10:11 +00:00
|
|
|
|
|
|
|
The `node-drain` command is used to toggle drain mode on a given node. Drain
|
2015-09-15 20:52:02 +00:00
|
|
|
mode prevents any new tasks from being allocated to the node, and begins
|
|
|
|
migrating all existing allocations away.
|
2015-09-15 01:10:11 +00:00
|
|
|
|
2015-09-15 03:24:04 +00:00
|
|
|
The [node-status](/docs/commands/node-status.html) command compliments this
|
|
|
|
nicely by providing the current drain status of a given node.
|
|
|
|
|
2015-09-15 01:10:11 +00:00
|
|
|
## Usage
|
|
|
|
|
|
|
|
```
|
|
|
|
nomad node-drain [options] <node>
|
|
|
|
```
|
|
|
|
|
|
|
|
This command expects exactly one argument to specify the node ID to enable or
|
|
|
|
disable drain mode for. It is also required to pass one of `-enable` or
|
|
|
|
`-disable`, depending on which operation is desired.
|
|
|
|
|
|
|
|
## General Options
|
|
|
|
|
2015-09-15 20:39:57 +00:00
|
|
|
<%= general_options_usage %>
|
|
|
|
|
|
|
|
## Node Drain Options
|
|
|
|
|
|
|
|
* `-enable`: Enable node drain mode.
|
|
|
|
* `-disable`: Disable node drain mode.
|
2015-09-15 03:24:04 +00:00
|
|
|
|
|
|
|
## Examples
|
|
|
|
|
|
|
|
Enable drain mode on node1:
|
|
|
|
|
|
|
|
```
|
2015-09-15 20:39:57 +00:00
|
|
|
$ nomad node-drain -enable node1
|
2015-09-15 03:24:04 +00:00
|
|
|
```
|