Add a node to the cluster
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 running 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 the preceding topic.
- Check if the licenses that are available on the appliance match that are available 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. And which 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.
Add a node to the cluster by using the CLI
Note:
When you add a node to a cluster setup, make sure that the default static route configured in the node is present in the cluster coordinator node (CCO). If the node has a static route not present in the CCO, the command fails with the following error.
Node cannot join cluster as static default gateway route is not present in CCO
- Log on to the cluster IP address, at the command prompt, do the following:
- Add the appliance (for example, 10.102.29.70) to the cluster.
Note:
For an L3 cluster:
- The node group parameter must be set to a node group 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 node group that was used for that node.
- If this node belongs to a different network, then create a node group and bind this node to the node group.
- The backplane parameter is mandatory for nodes that are associated with a node group that has more than one node, so that the nodes within the network can communicate with each other.
add cluster node <nodeId> <IPAddress> -state <state> -backplane <interface_name> -nodegroup <name> Example: add cluster node 1 10.102.29.70 -state PASSIVE -backplane 1/1/1 Warning: Add spotted configurations using the cluster IP for this node. Spotted configurations include: IPv4 addresses, IPv6 addresses, ARP entries, interface settings, route6s, IP tunnel, IPv6 tunnels, RNATs, PBRs, PBR6, Cluster LAGs, ND6s entries, FISs, linksets, SNMP MIB / engine ID, diameters, Citrix ADC VPX param, and hostname. If a backup is taken using the spottedconfig script for this node, apply it using the cluster IP after the node has joined the setup. Done <!--NeedCopy-->- Save the configuration.
save ns config <!--NeedCopy--> -
Log on to the newly added node (for example, 10.102.29.70) and join the node to the cluster.
join cluster -clip <ip_addr> -password <password> Example: join cluster -clip 10.102.29.61 -password nsroot <!--NeedCopy--> -
Configure the following commands on the CLIP.
-
Bind VLAN to an interface
bind vlan <id> -ifnum <interface_name> <!--NeedCopy-->Example:
bind vlan 1 -ifnum 2/1/2 <!--NeedCopy--> -
Add spotted IP address to the newly added node
add ns ip <IpAddress> <netmask> -ownerNode <positive_interger> <!--NeedCopy-->Example:
add ns ip 97.131.0.3 255.0.0.0 -ownerNode 2 <!--NeedCopy--> -
Verify VLAN on NSIP
show vlan <id> <!--NeedCopy-->Example:
show vlan 1 <!--NeedCopy-->
-
-
Perform the following configurations:
- 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.
- Define the required spotted configurations.
- Set the MTU for the backplane interface.
-
Save the configuration.
save ns config <!--NeedCopy--> -
Warm reboot the appliance.
reboot -warm <!--NeedCopy--> -
After the node is UP and sync is successful, change the RPC credentials for the node from the cluster IP address. For more information about changing an RPC node password, see Change an RPC node password.
set rpcNode <node-NSIP> -password <passwd> Example: set rpcNode 192.0.2.4 -password mypassword <!--NeedCopy--> -
Set the cluster node to Active.
set cluster node <nodeID> -state active. Example: set cluster node 1 -state active <!--NeedCopy-->
Add a node to the cluster by using the GUI
-
Log on to the cluster IP address.
-
Navigate to System > Cluster > Nodes.
-
In the details pane, click Add to add the new node (for example, 10.102.29.70).
-
In the Create Cluster Node dialog box, we recommend to configure the new node in a PASSIVE state. For a description of a parameter, hover the mouse cursor over the corresponding text box.
-
Click Create. When prompted to perform a warm reboot, click Yes.
-
After the node is UP and sync is successful:
-
Change RPC credentials for the node from the cluster IP address. For more information about changing an RPC node password, see Change an RPC node password.
-
Ensure that you configure the necessary spotted configuration on the cluster nodes. For more information on the list of spotted configuration, see List of spotted configuration and Supportability matrix for NetScaler cluster.
-
Go to Configuration > System > Cluster and click Force cluster sync to avoid any configuration inconsistencies.
-
-
Navigate to System > Cluster > Nodes > Edit.
-
Modify the State to ACTIVE and confirm.
Join a previously added node to the cluster by using the GUI
If you have used the CLI 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.
-
Log on to the node that you want to join to the cluster (for example, 10.102.29.70).
-
Navigate to System > Cluster.
-
In the details pane, under Get Started, click the Join Cluster link.
-
In the Join to existing cluster dialog box, set the cluster IP address and the
nsrootpassword of the configuration coordinator. For a description of a parameter, hover the mouse cursor over the corresponding text box. -
Click OK.