IBM General Parallel File System for AIX: Administration and Programming Reference

mmshutdown Command

Name

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

Synopsis

mmshutdown [-t unmountTimeout ] [ -a | -C NodesetId | -W NodeFilename | [ -w NodeName[,NodeName...]] [-n NodeNumber[,NodeNumber...] ] ]

Description

Use the mmshutdown command to stop the GPFS daemons on one or more nodes. If no operand is specified, GPFS is only stopped 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 execution 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 all GPFS nodesets.

-C NodesetId

Stop GPFS on all nodes in the indicated nodeset NodesetId. If a period (.) is used for theNodesetId, the nodeset is assumed to be that of the node you are running on.

-n NodeNumber

A comma-separated list of node numbers on which to stop GPFS. This list is combined with the nodes specified on the -w option.

-W NodeFilename

Stop GPFS on all nodes whose hostnames are listed in the file. The hostnames must be listed one per line.

-w NodeName[,NodeName...]

A comma-separated list of hostnames on which to stop GPFS. This list is combined with the nodes specified on the -n option.

The hostname or IP address used for a node must refer to the adapter port over which the GPFS daemons communicate. Alias interfaces are not allowed. Use the original address or a name that is resolved by the host command to that original address. You may specify a node using any of these forms:

Format	Example
Short hostname	k145n01
Long hostname	k145n01.kgn.ibm.com
IP address	9.119.19.102

Options

-t unmountTimeout

The maximum amount of time, in seconds, that the unmount command is given to complete. The default time-out 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.

Exit status

0

Successful completion.

1

A failure has occurred.

Security

You must have root authority to run the mmshutdown command.

In an SP environment:

• Verify the authentication method set for SP security services:
  1. If your authentication method is set to compatibility, Kerberos authentication is required. Issue the k4init command.
  2. If your authentication method is set to DCE, dce_login authentication is required.
  3. If your authentication method is set to NONE/std, there must be an entry in the /etc/sysctl.mmcmd.acl file on every node in the nodeset for the root user at every other node in the nodeset.

  For further information, see the latest IBM Parallel System Support Programs for AIX: Administration Guide, IBM Parallel System Support Programs for AIX: Command and Technical Reference, and RS/6000: Planning Volume 2, Control Workstation and Software Environment manuals at www.rs6000.ibm.com/resource/aix_resource/sp_books/pssp. Search for information on sysctl.

• You may issue the mmshutdown command from any node running GPFS or the CWS. When issuing the command from the CWS, you must specify the -C NodesetId option.
• If you are executing the mmshutdown command from the CWS on a multi-partitioned system, the SP_NAME environment variable must be properly set. It is suggested that you use a separate window for each partition and set the environment variable accordingly. For further information, see the IBM Parallel System Support Programs for AIX: Administration Guide and search for understanding system partitioning.

In an HACMP environment:

1. When using rcp and rsh for remote communication, a properly configured /.rhosts 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 mmcrcluster or the mmchcluster command, you must insure:
   1. Proper authorization is granted to all nodes in the GPFS cluster.
   2. The nodes in the GPFS cluster can communicate without the use of a password.
2. You may issue the mmshutdown command from any node in the GPFS cluster.

Examples

1. To stop GPFS on all nodes in all GPFS nodesets, enter:

   mmshutdown -a
   

   The system displays information similar to:

   Wed Aug 16 17:19:03 EDT 2000: 6027-1341 mmshutdown: Starting force unmount of GPFS filesystems
   k145n01:  forced unmount of /fs2
   k145n01:  forced unmount of /fs1
   k145n02:  forced unmount of /fs2
   k145n02:  forced unmount of /fs1
   Wed Aug 16 17:19:09 EDT 2000: 6027-1344 mmshutdown: Shutting down GPFS daemons
   k145n01:  Shutting down!
   k145n01:  0513-044 The mmfs Subsystem was requested to stop.
   k145n02:  Shutting down!
   k145n02:  0513-044 The mmfs Subsystem was requested to stop.
   Wed Aug 16 17:19:16 EDT 2000: 6027-1345 mmshutdown: Finished
    
   

2. To stop GPFS on only nodes k145n05 and k145n08, enter:

   mmshutdown -w k145n05,k145n08
   

   The system displays information similar to:

   Wed Aug 16 17:27:01 EDT 2000: 6027-1341 mmshutdown: Starting force unmount of GPFS filesystems
   k145n08:  forced unmount of /fs2
   k145n08:  forced unmount of /fs1
   k145n05:  forced unmount of /fs2
   k145n05:  forced unmount of /fs1
   Wed Aug 16 17:27:06 EDT 2000: 6027-1344 mmshutdown: Shutting down GPFS daemons
   k145n08:  Shutting down!
   k145n08:  0513-044 The mmfs Subsystem was requested to stop.
   k145n05:  Shutting down!
   k145n05:  0513-044 The mmfs Subsystem was requested to stop.
   Wed Aug 16 17:27:10 EDT 2000: 6027-1345 mmshutdown: Finished
    
   

3. To stop GPFS on all nodes in nodeset set5 allowing not more than 3 minutes for unmounting of the file systems, enter:

   mmshutdown -C set5 -t 180
   

   The system displays information similar to:

   Wed Aug 16 17:29:07 EDT 2000: 6027-1341 mmshutdown: Starting force unmount of GPFS filesystems
   k145n01:  forced unmount of /fs2
   k145n01:  forced unmount of /fs1
   k145n02:  forced unmount of /fs2
   k145n02:  forced unmount of /fs1
   k145n03:  forced unmount of /fs2
   k145n03:  forced unmount of /fs1
   Wed Aug 16 17:29:12 EDT 2000: 6027-1344 mmshutdown: Shutting down GPFS daemons
   k145n01:  Shutting down!
   k145n01.kgn.ibm.com:  0513-044 The mmfs Subsystem was requested to stop.
   k145n02.kgn.ibm.com:  Shutting down!
   k145n02.kgn.ibm.com:  0513-044 The mmfs Subsystem was requested to stop.
   k145n03.kgn.ibm.com:  Shutting down!
   k145n03.kgn.ibm.com:  0513-044 The mmfs Subsystem was requested to stop.
   Wed Aug 16 17:29:19 EDT 2000: 6027-1345 mmshutdown: Finished
   

See also

mmlsnode Command

Location

/usr/lpp/mmfs/bin