D.8. tarantella array join

Adds a server to an array of SGD servers, either as a primary or a secondary server.

Syntax

tarantella array join [ --primary pserv ]
                      [ --secondary sserv ]

Description

The clock on the server joining the array must be in synchronization with the clocks on the other servers in the array. If the time difference is more than one minute, this command will fail.

After running this command, it is advisable to wait until SGD has copied the changes to all SGD servers in the array before running any further tarantella array commands. Run the tarantella status command on the primary SGD server to check the status of the array.

It is best to use a fully-qualified DNS name when specifying the server to add to an array.

The following table shows the available options for this command.

Option

Description

--primary

Specifies the peer DNS name of the primary server in the array. Defaults to the server where the command is run.

--secondary

Specifies the peer DNS name of the server to add. The secondary server must be the only member of an array. Defaults to the server where the command is run.

You can only add one secondary server at a time.

When you use this command, the secondary server is added to the end of the backup primaries list for the SGD array.

If the server you add has been load balancing application servers using Advanced Load Management, use the tarantella restart sgd --warm command to do a warm restart of the new server after it has joined the array. If the array to which the new server is joined is using Advanced Load Management, do a warm restart of the whole array after the new server has joined.

If you are using secure intra-array communication, you are prompted to accept the CA certificate of either the primary server or the secondary server, depending on where you ran the command. In a standard installation, secure intra-array communication is enabled for an SGD server.

Examples

The following example adds the server boston to the array with newyork as its primary server.

$ tarantella array join \
--primary newyork.example.com \
--secondary boston.example.com

The following example adds the server where the command is run to the array with newyork as its primary server.

$ tarantella array join \
--primary newyork.example.com