This CLI command adds a new un-launched server to an existing cluster.


This action is usually performed by the server already part of a cluster, but can be performed also by the joining server.

Command Specific Arguments

This table specifies the various arguments used in the command:

Abbreviated Full Description Required/Optional



Name of the new server.




New server's IP.




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




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


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-add-server:

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

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

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

If performed by a server in a cluster:

/usr/local/zend/bin/zs-manage cluster-add-server -n <new server name> -u <new server IP> -N <existing key name> -K <existing key secret>

If performed by the server joining the cluster: 

/usr/local/zend/bin/zs-manage cluster-add-server -n <new server name> -u <new server IP> -N <existing key name> -K <existing key secret> -U <cluster server URL>

The server is added to the cluster.

3 SERVER3 restarting