.TH mmchmgr 02/16/06
mmchmgr Command
.SH "Name"
.PP
\fBmmchmgr\fR - Assigns a file system manager node.
.SH "Synopsis"
.PP
\fBmmchmgr\fR \fIDevice\fR [\fINode\fR]
.SH "Description"
.PP
The \fBmmchmgr\fR command assigns a file system manager node.
.SH "Parameters"
.PP
.RS +3
\fB\fIDevice\fR
\fR
.RE
.RS +9
The device name of the file system for which the file system manager node
is to be changed. File system names need not be fully-qualified.
\fBfs0\fR is just as acceptable as \fB/dev/fs0\fR.
.PP
This must be the first parameter.
.RE
.PP
.RS +3
\fB\fINode\fR
\fR
.RE
.RS +9
The target node to be appointed as the new file system manager. If
no \fINode\fR is specified, the configuration manager selects the new file
system manager node. 
.PP
For information on how to specify node names, see \fISpecifying nodes as input to GPFS commands\fR
in \fIGPFS: Administration and Programming Reference\fR.
.RE
.SH "Options"
.PP
NONE
.SH "Exit status"
.PP
.PP
.RS +3
\fB0
\fR
.RE
.RS +9
Successful completion.
.RE
.PP
.RS +3
\fBnonzero
\fR
.RE
.RS +9
A failure has occurred.
.RE
.SH "Security"
.PP
You must have root authority to run the \fBmmchmgr\fR command.
.PP
You may issue the \fBmmchmgr\fR command from any node in the GPFS
cluster.
.PP
When using the \fBrcp\fR and \fBrsh\fR commands for remote
communication, a properly configured \fB.rhosts\fR 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
\fBmmcrcluster\fR
or the
\fBmmchcluster\fR command, you must
ensure:
.RS +3
.HP 3
1. Proper authorization is granted to all nodes in the GPFS cluster.
.HP 3
2. The nodes in the GPFS cluster can communicate without the use of a
password, and without any extraneous messages.
.RE
.SH "Examples"
.PP
Assume the file system manager for the file system \fBgpfs1\fR is
currently \fBk164n05\fR. To migrate the file system manager
responsibilities to \fBk164n06\fR, issue this command:
.sp
.nf
mmchmgr gpfs1 k164n06
.fi
.sp
.PP
The system displays information similar to:
.sp
.nf
GPFS: 6027-628 Sending migrate request to current manager node
      9.114.68.69 (k164n05).
GPFS: 6027-629 Node 9.14.68.69 (k164n05) resigned as manager for gpfs1
GPFS: 6027-630 Node 9.14.68.70 (k164n06) appointed as manager for gpfs1
.fi
.sp
.SH "See also"
.PP
mmlsmgr Command
.SH "Location"
.PP
\fB/usr/lpp/mmfs/bin\fR
.PP