2015-09-15 00:40:49 +00:00
|
|
|
---
|
|
|
|
|
layout: "docs"
|
|
|
|
|
page_title: "Commands: agent-force-leave"
|
|
|
|
|
sidebar_current: "docs-commands-agent-force-leave"
|
|
|
|
|
description: >
|
|
|
|
|
Force a node into the "left" state.
|
|
|
|
|
---
|
|
|
|
|
|
2015-09-15 01:04:56 +00:00
|
|
|
# Command: agent-force-leave
|
2015-09-15 00:40:49 +00:00
|
|
|
|
2015-09-15 20:52:02 +00:00
|
|
|
The `agent-force-leave` command forces a server to enter the "left" state.
|
|
|
|
|
This can be used to eject server nodes which have failed and will not rejoin
|
|
|
|
|
the cluster. Note that if the server is actually still alive, it will
|
|
|
|
|
eventually rejoin the cluster again.
|
2015-09-15 00:40:49 +00:00
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
nomad agent-force-leave [options] <node>
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
This command expects only one argument - the node which should be forced
|
|
|
|
|
to enter the "left" state.
|
|
|
|
|
|
|
|
|
|
## General Options
|
|
|
|
|
|
2015-09-15 20:39:57 +00:00
|
|
|
<%= general_options_usage %>
|
2015-09-15 03:24:04 +00:00
|
|
|
|
|
|
|
|
## Examples
|
|
|
|
|
|
|
|
|
|
Force-leave the node "node1":
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
$ nomad agent-force-leave node1
|
|
|
|
|
```
|
