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}]

Availability

Available on all IBM Spectrum 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.

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.

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

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.

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