GPFS: Administration and Programming Reference - IRA Home

mmchcluster Command
Name
mmchcluster – Changes GPFS cluster configuration data.
Synopsis
mmchcluster {[-p PrimaryServer] [-s SecondaryServer]}
Or,
mmchcluster -p LATEST
Or,
mmchcluster {[-r RemoteShellCommand] [-R RemoteFileCopyCommand]}
Or,
mmchcluster -C ClusterName
Or,
mmchcluster -N {NodeDesc[,NodeDesc...] | NodeFile}
Description
The mmchcluster command serves several purposes:
1. Change the primary or secondary GPFS cluster configuration server.
2. Synchronize the primary GPFS cluster configuration server.
3. Change the remote shell and remote file copy programs to be used by the nodes in the cluster.
4. Change the cluster name.
5. Specify node interfaces to be used by the GPFS administration commands.
To display current system information for the cluster, issue the mmlscluster command.
For general information on how to specify node names, see “Specifying nodes as input to GPFS
commands” on page 4.
When issuing the mmchcluster command with the -p or -s flags, the nodes specified for these
parameters must be available in order for the command to succeed. If any of the nodes listed are not
available when the command is issued, a message listing those nodes is displayed. You must correct the
problem on each node and reissue the command.
Attention: The mmchcluster command, when issued with either the -p or -s option, is designed to
operate in an environment where the current primary and secondary cluster configuration servers are not
available. As a result, the command can run without obtaining its regular serialization locks. To assure
smooth transition to a new cluster configuration server, no other GPFS commands (mm commands)
should be running when the command is issued, nor should any other command be issued until the
mmchcluster command has successfully completed.
Parameters
-C ClusterName
Specifies a new name for the cluster. If the user-provided name contains dots, it is assumed to be a
84 GPFS: Administration and Programming Reference