This CLI command removes a server from a cluster.

Command Specific Arguments

This table specifies the various arguments used in the command:

Abbreviated Full Description Required/Optional



Retry action <value> times if server is locked; default is 3.




Wait <value> seconds between retries; default is 5.




Run synchronously- wait for Graceful Shutdown to complete.




Force remove the server - do not wait for Graceful Shutdown.


Common Arguments

This table lists arguments common to all zs-manage commands:

Abbreviated Full Description Required/Optional



WebAPI key name.




WebAPI secret key.




Zend Server URL. Default: http://localhost:10081/ZendServer.

Required - when action is performed on a remote server.



Show usage information and exit.




Instructions on how to complete a procedure

To use cluster-remove-server:

  1. Open your CLI.
  1. Enter a help command for the cluster-remove-server action to learn which arguments your command should include:

/usr/local/zend/bin/zs-manage cluster-remove-server --help

  1. Enter the command with the required arguments (replace brackets with your value):

/usr/local/zend/bin/zs-manage cluster-remove-server <server ID> [optional parameters- see table above] -N <existing key name> -K <existing key secret>

The server is removed from the cluster.

2 ubuntu1204-b Error


Use cluster-list-servers to see all the servers in your cluster and their status.