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

mmlsnode Command

Name

mmlsnode - Displays the nodes of a GPFS nodeset.

Synopsis

mmlsnode { -a | -C NodesetId | -n NodeName}

Description

The mmlsnode command displays the nodes contained in GPFS nodesets. The nodesets are listed in ascending order. Nodes which have been deleted are not displayed.

Parameters

-a

Display all GPFS nodesets.

-C NodesetId

The identifier of the GPFS nodeset whose nodes are to be listed. If a period (.) is used for the NodesetId, the nodes are listed for the nodeset from which the mmlsnode command was issued.

-n NodeName

Display the GPFS nodeset to which NodeName belongs.

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

Options

NONE

Exit status

0

Successful completion.

1

A failure has occurred.

Security

You must have root authority to run the mmlsnode command.

In an SP environment:

• You may issue the mmlsnode command from any node running GPFS or the CWS.
• 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.

• If you are executing the mmlsnode 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:

1. 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.
2. You may issue the mmlsnode command from any node in the GPFS cluster.

Examples

1. To display the nodes in GPFS nodeset set1, enter:

   mmlsnode -C set1
   

   The system displays information similar to:

   Nodeset         Node list
   -------------   -----------------------------------
   set1            k145n06,9.119.19.102,k145n08
    
   

2. To display the nodes for all GPFS node sets, enter:

   mmlsnode -a
   

   The system displays information similar to:

   Nodeset         Node list
   -------------   -----------------------------------
   set1            k145n06,9.119.19.102,k145n08
   set2            k145n11,k145n12
   set3            k145n01,k145n02,k145n03,k145n04
    
   

3. To display the GPFS nodeset to which k145n11 belongs, enter:

   mmlsnode -n k145n11
   

   The system displays information similar to:

   Nodeset         Node list
   -------------   -----------------------------------
   set2            k145n11,k145n12
    
   

See also

mmaddnode Command

mmchconfig Command

mmconfig Command

mmdelnode Command

Location

/usr/lpp/mmfs/bin