How-To:

• Add a Clustered Node
• Delete a Clustered Node

Related Documentation: • Cluster Manager How-To

• Fully configured Cluster Manager
• Node must have 1 IP address.
• Node must be on the same physical network segment as the Cluster Manager.
• Node must not have any SiteWorx accounts.

The purpose of this how-to is to walk you through the process of setting up a new node on an InterWorx Control Panel cluster.

1. Click the Clustering menu item if it is not already open.
2. Click the Setup menu item.
3. Click the Setup button under InterWorx-CP Clustered Server to begin the process.
4. Copy the API key text blob to your local clipboard as you will need the copied API key for the next step.
5. Proceed to the Adding Clustered Node to Cluster Manager step.

1. Click the Clustering menu item if it is not already open.
2. Click the Nodes menu item.
3. Enter the hostname or IP address of the Node you are adding to the hostname field.
4. Enter the API key from the previous procedure into the Node API Key field.
5. It is recommended that you test your setup using the Test button. Doing a pre-addition test weeds out 90% of Node addition errors that can occur.
6. After a successful test run (denoted by the message: You will see the following message at the top of the screen: » Node passed all pre-cluster tests) press the Add button to complete the node addition.
7. The add will return with either: You will see the following message at the top of the screen: » Node added successfully or an error regarding what happened. Please check the troubleshooting guide below for general solutions to common errors.

• Both boxes must be on the same physical network segment. If you get the error: » <server> not on same physical network segment please check that the boxes are in fact on the same segment. Boxes with similar IP addresses may not be on the same segment depending on how your IP network is architected.
• Clustered Nodes must be running a version of InterWorx Control Panel which is 2.1.0 or greater, please verify that all nodes have at least InterWorx-CP 2.1.0.
• If you use a hostname for the Node instead of an IP address be sure that the hostname is resolvable from the Cluster Manager itself. It is not enough that you can resolve it from your local PC. Login to the Cluster Manager and verify that you can "ping" the hostname from the Manager.
• Clustered Nodes must be clear of all SiteWorx accounts before adding, if you get an error regarding the new Node not being empty just delete all SiteWorx accounts from the Node before proceeding.
• If the Node addition fails for any reason, it is often helpful to look at the InterWorx Control Panel logfile located at /usr/local/interworx/var/log/iworx.log. You can often grep this file for the term "node" to get a list of what happened during Node addition. This goes for both the Cluster Manager and the Node being added.

• » Node already exists - There is a Node already known to the Cluster Manager that has the same hostname or IP address. Verify that you haven't added the same Node twice to the Cluster Manager.
• » Invalid node hostname - The hostname provided doesn't appear to be valid nor does it resolve to an IP address. Verify that it's the hostname you meant and that it's resolvable to an IP from the Cluster Manager.
• » Could not resolve hostname - The hostname given isn't resolvable to an IP address from the Cluster Manager. Verify that it's resolvable to an IP from the Cluster Manager before proceeding.
• » Node not on same physical network segment - The new Node isn't on the same physical network segment. This error is inferred from your IP configuration on the Cluster Manager (IP address, netmask, etc.) so it may either be that your IP configuration is incorrect or that in fact the boxes aren't on the same segment.
• » API Failure - This may be due to the Node not being InterWorx-CP 2.1.0 or above.
• » Node is already clustered - The Node that you're trying to add is already setup for clustering either with this Cluster Manager or another. You must un-cluster the Node before proceeding to re-cluster it on the current Manager.
• » Node already has SiteWorx accounts present - The node has SiteWorx accounts present on the box. You must remove the accounts before proceeding with clustering.

Cluster Manager with at least 1 Clustered Node.

The purpose of this how-to is to walk you through the process of deleting a Clustered Node from an InterWorx Control Panel Cluster.

1. Click the Clustering menu item if it is not already open.
2. Click the Nodes menu item.
3. Mark the checkbox that corresponds to the Node or Nodes you'd like to delete.
4. Select Delete … from the drop-down list at the bottom of the Node Management table.
5. <bp cstc>Remove.</bp>

• Depending on the number of accounts on the Clustered Node which is being deleted the deletion process may take some time.