source: gpfs_3.1_ker2.6.20/share/man/man8/mmdelnode.8 @ 195

.TH mmdelnode 03/02/06
mmdelnode Command
.SH "Name"
.PP
\fBmmdelnode\fR Removes one or more nodes from a GPFS cluster.
.SH "Synopsis"
.PP
\fBmmdelnode\fR {\fB-a\fR | \fB-N\fR
\fINode\fR[,\fINode\fR...] |
\fINodeFile\fR | \fINodeClass\fR]}
.SH "Description"
.PP
Use the \fBmmdelnode\fR command to delete one or more nodes from the
GPFS cluster. You may issue the \fBmmdelnode\fR command on any GPFS
node.
.PP
You must follow these rules when deleting nodes:
.RS +3
.HP 3
1. 
The node being deleted cannot be the primary or secondary GPFS cluster
configuration server unless you intend to delete the entire cluster.
Verify this by issuing the
\fBmmlscluster\fR
command. If a node to be deleted is one of the servers and you intend
to keep the cluster, issue the
\fBmmchcluster\fR
command to assign another node as the server before deleting the node.
.HP 3
2. 
A node being deleted cannot be the primary or backup NSD server for any disk
unless you intend to delete the entire cluster. Verify this by issuing
the
\fBmmlsnsd\fR command. If a node to be
deleted is an NSD server for one or more disks, use the \fBmmchnsd\fR command to assign another node as an NSD
server for the affected disks.
.HP 3
3. Unless all nodes in the cluster are being deleted, run the
\fBmmdelnode\fR command from a node that will remain in the cluster.
.HP 3
4. Before you can delete a node, you must unmount all of the GPFS file
systems and stop GPFS on the node to be deleted.
.HP 3
5. 
Exercise caution when shutting down GPFS on quorum nodes. If the number
of remaining quorum nodes falls below the requirement for a quorum, you will
be unable to perform file system operations. See the
\fIGeneral Parallel File System: Concepts,
Planning, and Installation Guide\fR and search for
\fIquorum\fR.
.RE
.RS +3
\fBNote:\fR
.RE
.RS +9
Since each cluster is managed independently, there is no automatic
coordination and propagation of changes between clusters like there is between
the nodes within a cluster. This means that if you permanently delete
nodes that are being used as contact nodes by other GPFS clusters that can
mount your file systems, you should notify the administrators of those GPFS
clusters so that they can update their own environments.
.RE
.PP
\fBResults\fR
.PP
Upon successful completion of the \fBmmdelnode\fR command, the specified
nodes are deleted from the GPFS cluster.
.SH "Parameters"
.PP
.RS +3
\fB-a
\fR
.RE
.RS +9
Delete all nodes in the cluster.
.RE
.PP
.RS +3
\fB-N {\fINode\fR[,\fINode\fR...] |
\fINodeFile\fR | \fINodeClass\fR}
\fR
.RE
.RS +9
Specifies the set of nodes to be deleted from the cluster. For
information on how to specify node names, see \fISpecifying nodes as input to GPFS commands\fR
in \fIGPFS: Administration and Programming Reference\fR.
.PP
This command does not support a \fINodeClass\fR of
\fBmount\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 \fBmmdelnode\fR command.
.PP
You may issue the \fBmmdelnode\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"
.RS +3
.HP 3
1. To delete all of the nodes in the cluster, issue this command:
.sp
.nf
mmdelnode -a
.fi
.sp
The system displays information similar to:
.sp
.nf
Verifying GPFS is stopped on all affected nodes ...
mmdelnode: Command successfully completed
mmdelnode: 6027-1371 Propagating the cluster configuration data to
all affected nodes. This is an asynchronous process.
.fi
.sp
.HP 3
2. To delete nodes \fBk145n12\fR, \fBk145n13\fR, and \fBk145n14\fR,
issue this command:
.sp
.nf
mmdelnode -N k145n12,k145n13,k145n14
.fi
.sp
The system displays information similar to:
.sp
.nf
Verifying GPFS is stopped on all affected nodes ...
mmdelnode: Command successfully completed
mmdelnode: 6027-1371 Propagating the cluster configuration data to
all affected nodes. This is an asynchronous process.
.fi
.sp
.RE
.SH "See also"
.PP
mmaddnode Command
.PP
mmcrcluster Command
.PP
mmchconfig Command
.PP
mmlsfs Command
.PP
mmlscluster Command
.SH "Location"
.PP
\fB/usr/lpp/mmfs/bin\fR
.PP