2015-09-15 00:40:49 +00:00
|
|
|
---
|
|
|
|
layout: "docs"
|
2015-09-22 18:08:36 +00:00
|
|
|
page_title: "Commands: server-force-leave"
|
|
|
|
sidebar_current: "docs-commands-server-force-leave"
|
2015-09-15 00:40:49 +00:00
|
|
|
description: >
|
2015-09-22 18:08:36 +00:00
|
|
|
Force a server into the "left" state.
|
2015-09-15 00:40:49 +00:00
|
|
|
---
|
|
|
|
|
2015-09-22 18:08:36 +00:00
|
|
|
# Command: server-force-leave
|
2015-09-15 00:40:49 +00:00
|
|
|
|
2015-09-22 18:08:36 +00:00
|
|
|
The `server-force-leave` command forces a server to enter the "left" state.
|
2015-09-15 20:52:02 +00:00
|
|
|
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
|
|
|
|
|
|
|
|
```
|
2015-09-22 18:08:36 +00:00
|
|
|
nomad server-force-leave [options] <node>
|
2015-09-15 00:40:49 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
This command expects only one argument - the node which should be forced
|
|
|
|
to enter the "left" state.
|
|
|
|
|
|
|
|
## General Options
|
|
|
|
|
2016-10-28 00:46:20 +00:00
|
|
|
<%= partial "docs/commands/_general_options" %>
|
2015-09-15 03:24:04 +00:00
|
|
|
|
|
|
|
## Examples
|
|
|
|
|
2015-09-22 18:08:36 +00:00
|
|
|
Force-leave the server "node1":
|
2015-09-15 03:24:04 +00:00
|
|
|
|
|
|
|
```
|
2015-09-22 18:08:36 +00:00
|
|
|
$ nomad server-force-leave node1
|
2015-09-15 03:24:04 +00:00
|
|
|
```
|