Note

You are viewing the documentation for an older release of Interworx (6.x). To see documentation for the current generally available release of Interworx, click here: 7.13.

How to: Set up a new node on an InterWorx Control Panel cluster.

Prerequisites:

  • Fully configured Cluster Manager

  • Node and Cluster Manager must run the same version of InterWorx.

  • Node must have at least 1 IP address.

  • If using LVS/DR (Direct Routing) the Node must be on the same physical network segment as the Cluster Manager.

  • Node must not have any SiteWorx accounts.

Preparing the Clustered Node:

The following are to be performed on the CLUSTERED NODE:

  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 below.

Adding Clustered Node to Cluster Manager:

The following are to be performed on the CLUSTER MANAGER

  • Click the Clustering menu item if it is not already open.

  • Click the Nodes menu item.

  • Enter the hostname or IP address of the Node you are adding to the hostname field.

  • Enter the API key from the previous procedure into the Node API Key field.

  • 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.

  • 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.

  • 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.

Node addition may take from several seconds to many minutes depending on the network speed and Manager/Node server speed.

Troubleshooting:

Common Problems / Pointers:

  • Both boxes must be on the same physical network segment if LVS/DR (Direct Routing) will be used. If you get the error: » not on same physical network segment please check that the boxes are in fact on the same segment.

  • 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.  This goes for both the Cluster Manager and the Node being added.

Specific Errors and Tips:

  • 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.

  • 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.