mmaddnode command

Availability

Available on all IBM Spectrum Scale™ editions.

Description

Use the mmaddnode command to add nodes to an existing GPFS cluster. On each new node, a mount point directory and character mode device is created for each GPFS file system.

Parameters

-N NodeDesc[,NodeDesc...] | NodeFile

Specifies node descriptors, which provide information about nodes to be added to the cluster.

NodeFile

Specifies a file containing a list of node descriptors, one per line, to be added to the cluster.

NodeDesc[,NodeDesc...]

Specifies the list of nodes and node designations to be added to the GPFS cluster. Node descriptors are defined as:

NodeName:NodeDesignations:AdminNodeName

where:

NodeName

Specifies the host name or IP address of the node for GPFS daemon-to-daemon communication.

The host name or IP address must refer to the communication adapter over which the GPFS daemons communicate. Aliased interfaces are not allowed. Use the original address or a name that is resolved by the host command to that original address. You can specify a node using any of these forms:

• Short host name (for example, h135n01)
• Long, fully-qualified, host name (for example, h135n01.ibm.com)
• IP address (for example, 7.111.12.102). IPv6 addresses must be enclosed in brackets (for example, [2001:192::192:168:115:124]).

Regardless of which form you use, GPFS will resolve the input to a host name and an IP address and will store these in its configuration files. It is expected that those values will not change while the node belongs to the cluster.

NodeDesignations

An optional, "-" separated list of node roles:

• manager | client – Indicates whether a node is part of the node pool from which file system managers and token managers can be selected. The default is client.
• quorum | nonquorum – Indicates whether a node is counted as a quorum node. The default is nonquorum.
  Note: If you are designating a new node as a quorum node, and adminMode central is in effect for the cluster, GPFS must be down on all nodes in the cluster. Alternatively, you may choose to add the new nodes as nonquorum and once GPFS has been successfully started on the new nodes, you can change their designation to quorum using the mmchnode command.

AdminNodeName

Specifies an optional field that consists of a node interface name to be used by the administration commands to communicate between nodes. If AdminNodeName is not specified, the NodeName value is used.

Note: AdminNodeName must be a resolvable network host name. For more information, see GPFS node adapter interface names.

You must provide a NodeDesc for each node to be added to the GPFS cluster.

Exit status

0

Successful completion.

nonzero

A failure has occurred.

Security

You must have root authority to run the mmaddnode command.

The node on which the command is issued must be able to execute remote shell commands on any other node in the cluster without the use of a password and without producing any extraneous messages. For more information, see Requirements for administering a GPFS file system.

See also

Location