mmshutdown command

Unmounts all GPFS file systems and stops GPFS on one or more nodes.

Synopsis

mmshutdown [-t UnmountTimeout] [-a | -N {Node[,Node...] | NodeFile | NodeClass}] [--accept]

Availability

Available on all IBM Storage Scale editions.

Description

Use the mmshutdown 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.

The mmshutdown command first attempts to unmount all GPFS file systems. If the unmount does not complete within the specified timeout period, the GPFS daemons shut down anyway.

Note: Before you shut down the current cluster manager node, run the mmchmgr command to move the cluster manager role to another node to avoid unexpected I/O interruption.

If shutting down the specified nodes cause problems in the cluster, the command prompts for confirmation. These checks can be bypassed by setting the confirmShutdownIfHarmful parameter value. To bypass these checks, issue the following command:

mmchconfig confirmShutdonwIfHarmful=no

Currently, the command checks only whether the shutdown causes loss of node quorum.

Results

Upon successful completion of the mmshutdown command, these tasks are completed:

GPFS file systems are unmounted.
GPFS daemons are stopped.

Parameters

-a

Stop GPFS on all nodes in a GPFS cluster.

-N {Node[,Node...] | NodeFile | NodeClass}

Directs the mmshutdown command to process a set of nodes.

For general information on how to specify node names, see Specifying nodes as input to GPFS commands.

This command does not support a NodeClass of mount.

--accept: Bypasses the user confirmation, if the command detects that shutting down the specified nodes cause a harmful condition.

Options

-t UnmountTimeout

The maximum amount of time, in seconds, that the unmount command is given to complete. The default timeout period is equal to:

60 + 3 × number of nodes

If the unmount does not complete within the specified amount of time, the command times out and the GPFS daemons shut down.

Many factors influence the time that it takes for all file systems to unmount in the allotted time. For example, the total number of mounted file systems or the number of unsaved file system changes. If the mmshutdown command has not completed in the allotted time, and there are many file systems mounted (greater than 10), you can use the -t option to define a time out value, which is long enough to allow for all file system unmount processing to complete.

Exit status

0: Successful completion.
nonzero: A failure has occurred.

Security

You must have root authority to run the mmshutdown command.

The node on which the command is issued must be able to execute remote shell commands on any other node in the cluster without the use of a password and without producing any extraneous messages. For more information, see Requirements for administering a GPFS file system.

Examples

To stop GPFS on all nodes in the GPFS cluster, issue this command:

mmshutdown -a

The system displays information similar to:

Thu Mar 15 14:02:50 EDT 2012: mmshutdown: Starting force unmount of GPFS file systems
c6f1c3vp2.gpfs.net:  forced unmount of /gpfs/fs1
c6f1c3vp1.gpfs.net:  forced unmount of /gpfs/fs1
Thu Mar 15 14:03:00 EDT 2012: mmshutdown: Shutting down GPFS daemons
c6f1c3vp3.gpfs.net:  Shutting down!
c6f1c3vp4.gpfs.net:  Shutting down!
c6f1c3vp4.gpfs.net:  'shutdown' command about to kill process 23649
c6f1c3vp4.gpfs.net:  Unloading modules from /lib/modules/2.6.27.19-5-ppc64/extra
c6f1c3vp4.gpfs.net:  Unloading module mmfs26
c6f1c3vp1.gpfs.net:  Shutting down!
c6f1c3vp4.gpfs.net:  Unloading module mmfslinux
c6f1c3vp1.gpfs.net:  'shutdown' command about to kill process 7667944
c6f1c3vp2.gpfs.net:  Shutting down!
c6f1c3vp2.gpfs.net:  'shutdown' command about to kill process 5701764
c6f1c3vp2.gpfs.net:  Master did not clean up; attempting cleanup now
c6f1c3vp2.gpfs.net:  Thu Mar 15 14:04:05.114 2012: mmfsd is shutting down.
c6f1c3vp2.gpfs.net:  Thu Mar 15 14:04:05.115 2012: Reason for shutdown: mmfsadm shutdown command timed out
c6f1c3vp2.gpfs.net:  Thu Mar 15 14:04:06 EDT 2012: mmcommon mmfsdown invoked.  Subsystem: mmfs Status: down
c6f1c3vp2.gpfs.net:  Thu Mar 15 14:04:06 EDT 2012: mmcommon: Unmounting file systems ...
Thu Mar 15 14:04:10 EDT 2012: mmshutdown: Finished

To stop GPFS on only node k164n04, issue this command:

mmshutdown -N k164n04