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

	Read Also
	CLI Tools
	Working with CLI Tools

Open this topic with navigation

	Zend.com
	Knowledge Base
	Support Center
	Zend Forums
	DevZone
	PHP Manual

	Zend Server 6.2
	Zend Server 6.1
	Zend Server 6.0
	Zend Server 5.6