IBM General Parallel File System for AIX: Administration and Programming Reference

mmaddnode Command

Name

mmaddnode - Adds nodes to a GPFS nodeset.

Synopsis

mmaddnode [-C NodesetId] NodeName[:manager | client][,NodeName[:manager | client]...]

Description

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

You must follow these rules when adding nodes to a GPFS nodeset:

A node may belong to only one nodeset at a time.
If multi-node quorum has been specified for the nodeset, the existing nodeset must meet quorum for the nodes to be added. For example, if GPFS is currently configured on eight nodes, all of which are up and running, the quorum value is met and the new nodes join the nodeset. Conversely, if GPFS is currently configured on eight nodes and only four are up and running, a quorum of five does not exists and the new nodes may not join the nodeset. When five of the original eight nodes are up and running, the new nodes are added.
After the nodes have been added and GPFS is started on the new nodes, the quorum value for the nodeset is adjusted accordingly. This allows new nodes to join a running nodeset without causing quorum to be lost. You must start GPFS manually the first time it is started on the new nodes by issuing the mmstartup command.
When adding nodes to a nodeset using the single-node quorum algorithm, the GPFS daemon must be stopped on all of the nodes. If after adding the nodes, the number of nodes in the nodeset exceeds two, the quorum algorithm is automatically changed to the multi-node quorum algorithm.
In an SP environment, ensure the new node is an active member of the virtual shared disk (see the IBM Parallel System Support Programs for AIX: Managing Shared Disks).

Parameters

-C NodesetId

The identifier of the GPFS nodeset you want to add nodes to. If this option is not specified or a period (.) is used for the NodesetId, the nodes are added to the nodeset from which the mmaddnode command was issued. To determine the nodeset of the node you are running on, issue the mmlsnode -C . command.

In an SP environment, if this option is not specified and the command is issued from the CWS or from a node not belonging to a nodeset, the command fails.

NodeName[:manager | client][,NodeName[:manager | client]...]

A comma-separated list of nodes to be added to the nodeset. Nodes are specified by a NodeName and may be optionally followed by a use designation. A designation of manager specifies that the node should be included in the pool of nodes from which the File System Manager node is chosen. For further information on the role of a node as the File System Manager, see the IBM General Parallel File System for AIX: Concepts, Planning, and Installation Guide and search for File System Manager. The default is to have the node included in the pool.

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

Format Example
Short hostname k145n01
Long hostname k145n01.kgn.ibm.com
IP address 9.119.19.102

Format	Example
Short hostname	k145n01
Long hostname	k145n01.kgn.ibm.com
IP address	9.119.19.102

Options

NONE

Exit status

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

Security

You must have root authority to run the mmaddnode command.

In an SP environment:

Verify the authentication method set for SP security services:
1. If your authentication method is set to compatibility, Kerberos authentication is required. Issue the k4init command.
2. If your authentication method is set to DCE, dce_login authentication is required.
3. If your authentication method is set to NONE/std, there must be an entry in the /etc/sysctl.mmcmd.acl file on every node in the nodeset for the root user at every other node in the nodeset.
For further information, see the latest IBM Parallel System Support Programs for AIX: Administration Guide, IBM Parallel System Support Programs for AIX: Command and Technical Reference, and RS/6000: Planning Volume 2, Control Workstation and Software Environment manuals at www.rs6000.ibm.com/resource/aix_resource/sp_books/pssp. Search for information on sysctl.
You may issue the mmaddnode command from any node running GPFS or the CWS when using the -C option.
If you are executing the mmaddnode command from the CWS on a multi-partitioned system, the SP_NAME environment variable must be properly set. It is suggested that you use a separate window for each partition and set the environment variable accordingly. For further information, see the IBM Parallel System Support Programs for AIX: Administration Guide and search for understanding system partitioning.

In an HACMP environment:

When using rcp and rsh for remote communication, a properly configured /.rhosts file must exist in the root user's home directory on each node in the GPFS cluster. If you have designated the use of a different remote communication program on either the mmcrcluster or the mmchcluster command, you must insure:
1. Proper authorization is granted to all nodes in the GPFS cluster.
2. The nodes in the GPFS cluster can communicate without the use of a password.
You may issue the mmaddnode command from any node in the GPFS cluster.

Examples

To add nodes k145n04 and k145n05, designating k145n04 to be available as a client node only, and by default add the nodes to the GPFS nodeset on which you are running, enter:
```
 mmaddnode k145n04:client,k145n05
```
To confirm the addition, enter:
```
mmlsnode -C .
```
The system displays information similar to:
```
GPFS nodeset    Node list
-------------   -------------------------------------------------------
   set1         k145n01 k145n02 k145n03 k145n04 k145n05
 
```

In an SP environment, to add nodes k145n06 and k145n07 to the GPFS nodeset set1 from the CWS, enter:

 mmaddnode -C set1 k145n06,k145n07

To confirm the addition, enter:

mmlsnode -C set1

The system displays information similar to:

GPFS nodeset    Node list
-------------   -------------------------------------------------------
   set1         k145n01 k145n02 k145n03 k145n04 k145n05 k145n06 k145n07

See also

Location

/usr/lpp/mmfs/bin

[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]