Setting up and dismantling a Tarantella array

You set up and dismantle an array of Tarantella servers:

Note After making a change to the structure of an array, it is advisable to wait until Tarantella has copied the changes to all array members before making any further changes. The changes have been copied when the tarantella status command returns the same result for each array member.

Adding a server to an array

In Array Manager, you add a Tarantella server to an array by clicking New Secondary and then typing the server's DNS name.

From the command line, you use the tarantella array join command.

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.

Removing a server from an array

In Array Manager, you remove a Tarantella server from an array by right-clicking it in the tree and then clicking Detach Server.

From the command line, you use the tarantella array detach command.

To remove the primary server from an array, first make another server the primary server and then remove the old primary server.

When you remove a server from an array, it loses its license keys.

Changing the primary server in an array

In Array Manager, you change the primary server in the array by right-clicking the server you want to become the primary server and then clicking Make Primary.

From the command line, you use the tarantella array make_primary command.

Note The previous primary server becomes a secondary server.

Upgrading an array

Instructions for how to upgrade a Tarantella array to a new version of Tarantella can be found in Upgrading Tarantella.

Related topics
  • What is an array?
  • Introducing Array Manager
  • The tarantella array command