addnode

You can use the addnode command to add a new (candidate) node to an existing cluster. You can enter this command any time after a cluster has been created. If you are adding a new node to a cluster, you must ensure that the model type of the new node is supported by the SAN Volume Controller software version of the cluster. If the model type is not supported by the cluster software, you must upgrade the cluster to a software version that supports the model type of the new node.

Syntax


>>- svctask -- -- addnode -- ----------------------------------->

>--+- -panelname -- -- panel_name -+-- ------------------------->
   '- -wwnodename -- -- wwnn_arg --'      

>--+----------------------------+-- ---------------------------->
   '- -name -- -- new_name_arg -'      

>-- -iogrp -- --+- iogroup_name -+-----------------------------><
                '- iogroup_id ---'

Parameters

-panelname panel_name: (Required if you do not specify the -wwnodename parameter) Specifies the node that you want to add to a cluster by the name that is displayed on the display panel. You cannot use this parameter with the -wwnodename parameter.
-wwnodename wwnn_arg: (Required if you do not specify the -panelname parameter) Specifies the node that you want to add to the cluster by the worldwide node name (WWNN). You cannot use this parameter with the -panelname parameter.
-name new_name_arg: (Optional) Specifies a name for the node that you want to add to the cluster.
-iogrp iogroup_name | iogroup_id: (Required) Specifies the I/O group to which you want to add this node.

Description

This command adds a new node to the cluster. You can obtain a list of candidate nodes (those that are not already assigned to a cluster) by typing svcinfo lsnodecandidate.

Before you add a node to the cluster, you must check to see if any of the following conditions are true. If the following conditions exist, failure to follow the procedures that are documented here might result in the corruption of all data that is managed by the cluster.

Is the new node being used to replace a failed node in the cluster?
Does the node being added to the cluster use physical node hardware that has been used as a node in another cluster, and are both clusters recognized by the same hosts?

If any of the previous conditions are true, you must take the following actions:

Add the node to the same I/O group that it was previously in. You can use the command-line interface command svcinfo lsnode or the SAN Volume Controller Console to determine the WWNN of the cluster nodes.
Shut down all of the hosts that use the cluster, before you add the node back into the cluster.
Add the node back to the cluster before the hosts are restarted. If the I/O group information is unavailable or it is inconvenient to shut down and restart all of the hosts that use the cluster, you can do the following:
1. On all of the hosts that are connected to the cluster, unconfigure the fibre-channel adapter device driver, the disk device driver, and the multipathing driver before you add the node to the cluster.
2. Add the node to the cluster and then reconfigure the fibre-channel adapter device driver, the disk device driver, and multipathing driver.

If you are adding a new node to a cluster, take the following actions:

Ensure that the model type of the new node is supported by the SAN Volume Controller software version of the cluster. If the model type is not supported by the cluster software, you must upgrade the cluster to a software version that supports the model type of the new node.
Record the node serial number, the WWNN, all WWPNs, and the I/O group to which the node has been added. You might need to use this information later. Having it available can prevent possible data corruption if the node must be removed from and re-added to the cluster.

Other considerations when you add a node to a cluster:

When you add a node to the cluster using the svctask addnode command or the cluster GUI, you must confirm whether the node has previously been a member of the cluster. If it has, follow one of these two procedures:

Add the node to the same I/O group that it was previously in. You can determine the WWNN of the nodes in the cluster using the svcinfo lsnode command.
If you cannot determine the WWNN of the nodes in the cluster, call the support team to add the node back into the cluster without corrupting the data.

When a node is added to a cluster, it displays a state of adding. It can take as long as 30 minutes for the node to be added to the cluster, particularly if the software version of the node has changed.

Attention: If the node remains in the adding state for more than 30 minutes, contact your support representative to assist you in resolving this issue.

Optionally, you can assign a name to the new node. You can use this name in subsequent commands to refer to the node, instead of using the node ID. If you assign a label, this label is displayed as the node name from then on. If you do not assign a label, the default label is nodeX, where X is the node ID.

An invocation example

svctask addnode -wwnodename 5005076801e08b -iogrp io_grp0

The resulting output

Node, id [6], successfully added