The tarantella array join command

Syntax

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

Description

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

Option Description
--primary pserv Specifies the peer DNS name of the primary server in the array. Defaults to the server on which the command is run.
--secondary sserv Specifies the peer DNS name of the server to add. The sserv must be the only member of an array (a "standalone" server). Defaults to the server on which the command is run.

You can only add one secondary server at a time.

Note After running this command, it is advisable to wait until Tarantella has copied the changes to all array members before running any further tarantella array commands. This is complete when the tarantella status command returns the same result for each array member.

If the server joining the array has an Activation license key, you will be warned that the joining server will have its Activation license key discarded.

If the server you add has been load balancing application servers using Tarantella Advanced Load Management, we recommend that you do a warm restart (tarantella restart --warm) of the new server after it has joined the array. If the array to which the new server is joined is using Tarantella Advanced Load Management, we recommend you do a warm restart of the whole array after the new server has joined.

If the server you add has been part of an array which uses named user licensing, the joining server discards its list of users who are using licenses.

Tarantella Enterprise 3 allows you to create an array of two Tarantella servers. You can increase the number of servers allowed in an array by adding an Extended Array license key. If you are using Tarantella Enterprise 3 EX, there is no restriction on the size of the array.

Examples

tarantella array join \
  --primary newyork.indigo-insurance.com \
  --secondary boston.indigo-insurance.com

Adds the server boston to the array with newyork as its primary server.

tarantella array join \
  --primary newyork.indigo-insurance.com

Adds the server on which the command is run to the array with newyork as its primary server.

Related topics
  • The tarantella array command
  • Setting up and dismantling a Tarantella array
  • What is an array?
  • Introducing Array Manager