Product Documentation

Adding a Node to the Cluster

Aug 31, 2016

You can seamlessly scale the size of a cluster to include a maximum of 32 nodes. When a NetScaler appliance is added to the cluster, the configurations from that appliance are cleared (by internally executing the clear ns config -extended command). The SNIP addresses, MTU settings of the backplane interface, and all VLAN configurations (except the default VLAN and NSVLAN) are also cleared from the appliance.

The cluster configurations are then synchronized on this node. There can be an intermittent drop in traffic while the synchronization is in progress.

Important: Before you add a NetScaler appliance to a cluster:
  • Set up the backplane interface for the node. Check preceding topic.
  • Check if the licenses that are available on the appliance match those availabe on the configuration coordinator. The appliance is added only if the licenses match.
  • If you want the NSVLAN on the cluster, make sure that the NSVLAN is created on the appliance before it is added to the cluster.
  • Citrix recommends that you add the node as a passive node. Then, after joining the node to the cluster, complete the node specific configuration from the cluster IP address. Run the force cluster sync command if the cluster has only spotted IP addresses, has L3 VLAN binding, or has static routes.
  • When an appliance with a preconfigured link aggregate (LA) channel is added to a cluster, the LA channel continues to exist in the cluster environment. The LA channel is renamed from LA/x to nodeId/LA/x, where LA/x is the LA channel identifier.

To add a node to the cluster by using the command line interface

  1. Log on to the cluster IP address and, at the command prompt, do the following:
    1. Add the appliance (for example, 10.102.29.70) to the cluster.

      add cluster node <nodeId> <IPAddress> -state <state> -backplane <interface_name> -nodegroup <name>

      Note: For an L3 cluster:
      • The nodegroup parameter must be set to a nodegroup that has nodes of the same network.
        • If this node belongs to the same network as the first node that was added, then configure the nodegroup that was used for that node.
        • If this node belongs to a different network, then create a nodegroup and bind this node to the nodegroup.
      • The backplane parameter is mandatory for nodes that are associated with a nodegroup that has more than one node, so that the nodes within the network can communicate with each other.
      Example
      > add cluster node 1 10.102.29.70 -state PASSIVE -backplane 1/1/1
    2. Save the configuration.

      save ns config

  2. Log on to the newly added node (for example, 10.102.29.70) and do the following:
    1. Join the node to the cluster.

      join cluster -clip <ip_addr> -password <password>

      Example
      > join cluster -clip 10.102.29.61 -password nsroot
    2. Perform the following configurations:
      1. If the node is added to a cluster that has only spotted IPs, the configurations are synchronized before the spotted IP addresses are assigned to that node. In such cases, L3 VLAN bindings can be lost. To avoid this loss, either add a striped IP or add the L3 VLAN bindings.
      2. Define the required spotted configurations.
      3. Set the MTU for the backplane interface.
    3. Save the configuration.

      save ns config

    4. Warm reboot the appliance.

      reboot -warm

To add a node to the cluster by using the configuration utility

  1. Log on to the cluster IP address.
  2. Navigate to System > Cluster > Nodes.
  3. In the details pane, click Add to add the new node (for example, 10.102.29.70).
  4. In the Create Cluster Node dialog box, configure the new node. For a description of a parameter, hover the mouse cursor over the corresponding text box.
  5. Click Create. When prompted to perform a warm reboot, click Yes.

To join a previously added node to the cluster by using the configuration utility

If you have used the command line to add a node to the cluster, but have not joined the node to the cluster, you can use the following procedure.

Note: When a node joins the cluster, it takes over its share of traffic from the cluster and hence an existing connection can get terminated.
  1. Log on to the node that you want to join to the cluster (for example, 10.102.29.70).
  2. Navigate to System > Cluster.
  3. In the details pane, under Get Started, click the Join Cluster link.
  4. In the Join to existing cluster dialog box, set the cluster IP address and the nsroot password of the configuration coordinator. For a description of a parameter, hover the mouse cursor over the corresponding text box.
  5. Click OK.