Chapter 3: Network Setup Up Main page Chapter 5: The Load Balancer 

4 Installation

4.1 Basic Installation

  1. If using an external shared storage device
    1. External NFS Server must support quotas through NFS (rquotad).
    2. NFS export must be on a partition with a filesystem that supports quotas. That partition should be mounted with quotas enabled.
  2. Install OS and assign IPs to NICs on all servers.
  3. If using an external shared storage device (not the cluster manager) Create the NFS export on the fileserver or appliance.
  4. Ensure that every intra-cluster communication IP in the cluster has access to this NFS share.
  5. Configure /home on the cluster manager to point to this storage device via NFS. [D][D]Note: If this shared storage device is mounted after InterWorx is installed, you may need to create the following symlinks:
    • /home/interworx to /usr/local/interworx
    /home/vpopmail to /var/vpopmail
  6. Install InterWorx and activate your licenses on all servers.
  7. Setup the cluster manager.
  8. (Optional) Add all additional public IPs used to host servers to the same NIC which contains the primary public IP on the IP Management Page. [E][E]This can be done after the cluster is setup if you wish.
  9. Add your cluster nodes using the private IPs (if you use the two network device scenario).
  10. Test SiteWorx account creation by creating a temporary SiteWorx account to make sure that the clustering works properly.
  11. You’re done!

4.2 Manager Setup

You should always set up the Cluster Manager first. Ideally, do so before you have any SiteWorx accounts installed on it.
  1. In NodeWorx, open the Clustering menu item if it is not already open.
  2. Click the Setup menu item.
  3. Click the Setup button under InterWorx-CP Cluster Manager to begin the process.
  4. Choose the quorum IP from the list of available IP addresses.
  5. The quorum IP is the IP address that will be used by all nodes in this cluster to communicate with the manager (and vice versa).
  6. The quorum IP will not be available to use for website accounts.
  7. Verify that you have sufficient space on the /home partition as listed on the Cluster Manager setup page.
  8. This will be the single storage device for all nodes in your cluster.
  9. Press the Complete button to complete the setup of the Cluster Manager.

4.3 Node Setup

You MUST set up the Cluster Nodes before they have any SiteWorx accounts installed.

4.3.1 Node Preparation

  1. On the Node, in NodeWorx, open 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 next section.

4.3.2 Adding a Node to a Cluster

  1. 1. In NodeWorx on the Cluster Manager, open 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. [F][F]Doing a pre-addition test weeds out 90% of Node addition errors that can occur.
  6. After a successful test run [G][G]Successful tests are denoted by the message: “» Node passed all pre-cluster tests” at the top of the screen. press the Add button to complete the node addition.
  7. The add will return with either: “» Node added successfully” or an error regarding what happened at the top of the screen.[H][H]Node addition may take from several seconds to many minutes depending on the network speed and Manager/Node server speed.

4.3.3 Removing a Node from a Cluster

Sometimes, a node needs to be taken out of service permanently. Elegantly removing it from the cluster prevents a great deal of problems that can result in damage to your customers’ data.
  1. In NodeWorx, open 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. Click “Remove.”
 Chapter 3: Network Setup Up Main page Chapter 5: The Load Balancer 

(C) 2017 by InterWorx LLC