source: gpfs_3.1_ker2.6.20/share/man/man8/mmshutdown.8 @ 219

.TH mmshutdown 02/16/06
mmshutdown Command
.SH "Name"
.PP
\fBmmshutdown\fR - Unmounts all GPFS file systems and stops GPFS on
one or more nodes.
.SH "Synopsis"
.PP
\fBmmshutdown\fR [\fB-t\fR \fIUnmountTimeout\fR ]
[\fB-a\fR | \fB-N\fR
{\fINode\fR[,\fINode\fR...] | \fINodeFile\fR |
\fINodeClass\fR}]
.SH "Description"
.PP
Use the \fBmmshutdown\fR command to stop the GPFS daemons on one or more
nodes. If no operand is specified, GPFS is stopped only on the node
from which the command was issued.
.PP
The \fBmmshutdown\fR command first attempts to unmount all GPFS file
systems. If the unmount does not complete within the specified
\fItimeout\fR period, the GPFS daemons shut down anyway.
.PP
\fBResults\fR
.PP
Upon successful completion of the \fBmmshutdown\fR command, these tasks
are completed: 
.RS +3
.HP 3
\(bu GPFS file systems are unmounted.
.HP 3
\(bu GPFS daemons are stopped.
.RE
.SH "Parameters"
.PP
.RS +3
\fB\fB-a\fR
\fR
.RE
.RS +9
Stop GPFS on all nodes in a GPFS cluster.
.RE
.PP
.RS +3
\fB-N {\fINode\fR[,\fINode\fR...] |
\fINodeFile\fR | \fINodeClass\fR}
\fR
.RE
.RS +9
Directs the \fBmmshutdown\fR command to process a set of nodes.
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
.RS +3
\fB-t \fIUnmountTimeout\fR
\fR
.RE
.RS +9
The maximum amount of time, in seconds, that the unmount command is given
to complete. The default timeout period is equal to: 
.PP
\fB60 + 3 * \fInumber of nodes\fR\fR
.PP
If the unmount does not complete within the specified amount of time, the
command times out and the GPFS daemons shut down.
.RE
.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 \fBmmshutdown\fR command.
.PP
You may issue the \fBmmshutdown\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 \fBstop\fR GPFS on all nodes in the GPFS cluster, issue this
command:
.sp
.nf
mmshutdown -a
.fi
.sp
The system displays information similar to:
.sp
.nf
Thu Aug 12 13:10:40 EDT 2004: 6027-1341 mmshutdown: Starting
force unmount of GPFS file systems.
k164n05.kgn.com:  forced unmount of /fs1
k164n04.kgn.ibm.com:  forced unmount of /fs1
k164n06.kgn.ibm.com:  forced unmount of /fs1
Thu Aug 12 13:10:45 EDT 2004: 6027-1344 mmshutdown: Shutting 
down GPFS daemons
k164n04.kgn.ibm.com:  Shutting down!
k164n06.kgn.ibm.com:  Shutting down!
k164n05.kgn.ibm.com:  Shutting down!
k164n04.kgn.ibm.com:  'shutdown' command about to kill process
49682
k164n05.kgn.ibm.com:  'shutdown' command about to kill process
28194
k164n06.kgn.ibm.com:  'shutdown' command about to kill process
\ 
Thu Aug 12 13:10:54 EDT 2004: 6027-1345 mmshutdown: Finished
.fi
.sp
.HP 3
2. To stop GPFS on only node \fBk164n04\fR, issue this command:
.sp
.nf
mmshutdown -N k164n04
.fi
.sp
The system displays information similar to:
.sp
.nf
mmshutdown -N k164n04
Thu Aug 12 13:12:06 EDT 2004: 6027-1341 mmshutdown: Starting
force unmount of GPFS file systems
k164n04:  forced unmount of /fs1
Thu Aug 12 13:12:11 EDT 2004: 6027-1344 mmshutdown: Shutting
down GPFS daemons
k164n04:  Shutting down!
k164n04:  'shutdown' command about to kill process 65036
Thu Aug 12 13:12:20 EDT 2004: 6027-1345 mmshutdown: Finished
.fi
.sp
.RE
.SH "See also"
.PP
mmgetstate Command
.PP
mmlscluster Command
.PP
mmstartup Command
.SH "Location"
.PP
\fB/usr/lpp/mmfs/bin\fR
.PP