Zend Server User Guide > Tasks > Working with CLI Tools > cluster-add-server

cluster-add-server

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

Note:

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
-n	--name	Name of the new server.	Required
-u	--url	New server's IP.	Required
-r	--retry	Retry action <value> times if server is locked; default is 3.	Optional
-w	--wait	Wait <value> seconds between retries; default is 5.	Optional

Common Arguments

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

Abbreviated	Full	Description	Required/Optional
-N	--key-name	WebAPI key name.	Required
-K	--secret-key	WebAPI secret key.	Required
-U	--server-url	Zend Server URL. Default: http://localhost:10081/ZendServer.	Required - when action is performed on a remote server.
-h	--help	Show usage information and exit.	Optional

Instructions on how to complete a procedure

To use cluster-add-server:

Open your CLI.

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

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 10.9.183.85 restarting