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

server-add-to-cluster

This CLI command adds a launched server to a new cluster, connecting directly to the MySQL database.

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
-i	--nodeIP	IP of the new server.	Required
-o	--dbHost	Database host address to join the cluster.	Required
-u	--dbUsername	Database credentials - username.	Required
-p	--dbPassword	Database credentials - password.	Required
-d	--dbname	Database (Schema) name to connect or create. Default "ZendServer".	Required
-s	--sync	Run synchronously - wait until the server has completed all related actions such as deploying all applications.	Optional
-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 server-add-to-cluster:

Open your CLI.

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

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

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

/usr/local/zend/bin/zs-manage server-add-to-cluster -n <server name> -i <server IP> -o <DB host IP> -u <DB user name> -p <DB password> -d <DB schema name> -N <existing key name> -K <existing key secret>

The server is added to a new cluster.

NODE_ID = 1

WEB_API_KEY = admin

WEB_API_KEY_HASH = 13b6ff8ba4d559a3340327b2f7b213ad2f5e5a2ecab185a4cf6bf417978c9dee