essaddnode command

Adds a node, such as EMS, to an IBM Storage Scale cluster.

Synopsis


essaddnode -N ADD-NodeList { --cluster-node ClusterNode } 
           [ --prefix Prefix ] [ --suffix Suffix ]
           [--accept-license] [--no-fw-update]
           [--nodetype NodeType] 
           [-h |--help]

Availability

Available with IBM Storage Scale System.

Description

The essaddnode command adds nodes to an IBM Storage Scale cluster. It can be used to add an EMS or I/O server or ESS 3000 nodes to the cluster. This command must run on the EMS node when the EMS node is being added to the cluster. The EMS node must be upgraded to the correct software levels (such as RHEL and GPFS) before adding the node to the cluster. This command updates firmware levels in the SAS host adapter, firmware in the enclosure and drives.

Parameters

-h | --help: Displays usage information about this command and exits.
-N ADD-NodeList: Provides a comma-separated list of nodes to add to an existing IBM Storage Scale cluster. In case of an EMS node, it must be the host name of the EMS (For example, ems1).
--cluster-node ClusterNode: Provides the name of a node that exists in an IBM Storage Scale cluster where nodes will be added. This node must be able to run GPFS administrative commands. For example, --cluster-node essio1 where essio1 is an existing node in the cluster. Either --cluster-node or --cluster-group must be provided.
--nodetype NodeType: Indicates the type of the node being added. The default node type is ems. For EMS node, specify ems. For I/O server nodes, specify gss. For IBM Elastic Storage® Scale System 3000 nodes, specify ess3k.
--prefix Prefix: Provides the hostname prefix. PREFIX is used with the node names provided in the ADD-NODE-LIST to create the actual node names. Use = between --prefix and value if the value starts with -.
--suffix Suffix: Provides the hostname suffix. SUFFIX is used with the node names in the ADD-NODE-LIST to create the actual node names. For example, with an ADD-NodeList of gssio1,gssio2, and prefix A- and suffix -ib, node names A-gssio1-ib and A-gssio2-ib are used to form the actual node names. The node name must resolvable. Use = between --suffix and the value, if the value starts with -.
--accept-license: Specifies that the applicable licensing terms are accepted. If not provided, user is prompted for license acceptance after addition of the node.
--no-fw-update: This option skips SAS adapter, storage enclosure and drive firmware update after addition of the nodes into the cluster.

Exit status

0: Successful completion.
nonzero: A failure has occurred.

Security

You must have root authority to run the essaddnode command.

Examples

This example shows EMS node ems1 being added to the cluster. In the first example, group name of the existing cluster nodes is provided. In the second example, a node of the existing cluster is provided.
```
essaddnode -N ems1 --nodetype ems --accept-license --no-fw-wupdate
```
```
essaddnode -N ems1 --cluster-node gssio1 --nodetype ems --accept-license --no-fw-wupdate
```
This example shows the new I/O server nodes gssio3 and gssio4 being added to the existing cluster. In the first example, group name of the existing cluster nodes is provided. In the second example, a node of the existing cluster is provided. While adding I/O node, make sure to use --nodetype as gss. The gss node type indicates that the newly added node is an NSD server I/O node.
```
essaddnode -N gssio3 --nodetype gss --accept-license
essaddnode -N gssio4 --cluster-node gssio1 --nodetype gss --accept-license
```

Location

/opt/ibm/ess/tools/bin