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

mmlsmgr Command

Name

mmlsmgr - Displays which node is the File System Manager for the specified file systems.

Synopsis

mmlsmgr [-C NodesetId] | [Device [Device ...]]

Description

Use the mmlsmgr command to display which node is the File System Manager for the file system.

You may either specify a NodesetId or a Device, but not both. If you do not provide any operands, File System Managers for all file systems within the current nodeset for which a File System Manager has been appointed are displayed.

In an SP environment, if the command is issued from the CWS, you must specify a Device or a NodesetId as the CWS is not part of a nodeset.

Parameters

Device

The device names of the file systems for which the File System Manager information is displayed.

If more than one file system is listed, the names should be delimited by a space. File system names need not be fully qualified. fs0 is just as acceptable as /dev/fs0.

If no file system is specified, information about all file systems, for which a File System Manager is appointed, is displayed. This includes all file systems that are currently mounted and may include other file systems that had been mounted or were previously accessed.

-C NodesetId

The identifier of the GPFS nodeset you want to display the File System Manager information for. All File System Managers for all file systems in the nodeset are displayed. If a period (.) is used for theNodesetId, the nodeset is assumed to be that of the node you are running on. To determine the nodeset of the node you are running on, issue the mmlsnode -C . command.

This operand is ignored when the mmlsmgr command is issued by a non-root user.

Options

NONE

Exit status

0

Successful completion.

1

A failure has occurred.

Security

In an SP environment:

• If you are a root user:
  • You may issue the mmlsmgr 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 mmlsmgr 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. If you are a root user, 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 mmlsmgr command from any node in the GPFS cluster.

If you are a non-root user, you may only specify file systems that belong to the same nodeset as the node on which the mmlsmgr command was issued.

Examples

1. To display the File System Manager node information for all the file systems, enter:

   mmlsmgr 
   

   The system displays information similar to:

   File System     Manager Node
   -------------   -----------------------------------
   gpfs1           15 (k145n15)
   gpfs2           16 (k145n16)  
   

   The output shows the device name of the file system and the File System Manager's node number and name, in parenthesis, as they are registered in the GPFS cluster data.

2. To display the File System Manager information for file systems gpfs2 and gpfs3, enter:

   mmlsmgr gpfs2 gpfs3
   

   The system displays information similar to:

   File System     Manager Node
   -------------   -----------------------------------
   gpfs2           16 (k145n16)
   gpfs3           (none appointed)
    
   

3. To display the File System Manager information for all of the file systems in the nodeset you are running on, enter:

   mmlsmgr -C . 
   

   The system displays information similar to:

   File System     Manager Node
   -------------   -----------------------------------
   gpfs4           8  (k145n08)
   gpfs6           10 (k145n10)
    
   

See also

mmchmgr Command

Location

/usr/lpp/mmfs/bin