GPFS: Administration and Programming Reference - IRA Home

-r {uid:gid | no}
Specifies a root credentials remapping (root squash) option. The UID and GID of all
processes with root credentials from the remote cluster will be remapped to the specified
values. The default is not to remap the root UID and GID. The uid and gid must be
specified as unsigned integers or as symbolic names that can be resolved by the
operating system to a valid UID and GID. Specifying no, off, or DEFAULT turns off the
remapping.
Exit status
For more information, see General Parallel File System: Advanced Administration Guide
and search on root squash.
0 Successful completion. After a successful completion of the mmauth command, the
configuration change request will have been propagated to all nodes in the cluster.
nonzero A failure has occurred.
Security
You must have root authority to run the mmauth command.
You may issue the mmauth command from any node in the GPFS cluster.
Examples
1. This is an example of an mmauth genkey new command:
mmauth genkey new
The output is similar to this:
Generating RSA private key, 512 bit long modulus
............++++++++++++.++++++++++++
e is 65537 (0x10001)
mmauth: Command successfully completed
mmauth: Propagating the cluster configuration data to all
affected nodes. This is an asynchronous process.
2. This is an example of an mmauth genkey commit command:
mmauth genkey commit
The output is similar to this:
mmauth: Command successfully completed
mmauth: Propagating the cluster configuration data to all
affected nodes. This is an asynchronous process.
3. This is an example of an mmauth add command:
mmauth add clustA.kgn.ibm.com -k /u/admin/keys/clustA.pub
The output is similar to this:
mmauth: Propagating the changes to all affected nodes.
This is an asynchronous process.
4. This is an example of an mmauth update command:
mmauth update clustA.kgn.ibm.com -k /u/admin/keys/clustA_new.pub
The output is similar to this:
mmauth Command
Chapter 8. GPFS commands 75