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

mmstartup Command

Name

mmstartup - Starts the GPFS subsystem on one or more nodes.

Synopsis

mmstartup [ -a | -C NodesetId | -W NodeFilename | [ -w NodeName[,NodeName...]] [-n NodeNumber[,NodeNumber...] ] ]

Description

Use the mmstartup command to start the GPFS daemons on one or more nodes. If no operand is specified, GPFS is only started on the node from which the command was issued.

Results

Upon successful execution of the mmstartup command, the GPFS subsystem is started on the specified nodes.

Note:

The actual start of the GPFS daemons on the nodes also depends upon:

• the availability of all required software for your environment
• the availability of required hardware for your environment
• quorum requirements

For the actual requirements for your operating environment, see the IBM General Parallel File System for AIX: Concepts, Planning, and Installation Guide and search for installing GPFS.

Parameters

-a

Start GPFS on all nodes in all GPFS nodesets.

-C NodesetId

Start GPFS on all nodes in the indicated nodeset NodesetId. If a period (.) is used for the NodesetId, 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 start GPFS. This list is combined with the nodes specified on the -w option.

-w NodeName[,NodeName...]

A comma-separated list of hostnames on which to start 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

-W NodeFilename

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

Options

NONE

Exit status

0

Successful completion.

1

A failure has occurred.

Security

You must have root authority to run the mmstartup 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 mmstartup command from any node running GPFS or the CWS.
• If you are executing the mmstartup 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 mmstartup command from any node in the GPFS cluster.

Examples

To start GPFS on all nodes in the GPFS nodeset set1, enter:

mmstartup -C set1

The system displays information similar to:

Wed Sep 13 09:49:04 EDT 2000: mmstartup: Starting GPFS ...
k145n01:  0513-059 The mmfs Subsystem has been started. Subsystem PID is 9206.
k145n02:  0513-059 The mmfs Subsystem has been started. Subsystem PID is 9694.
k145n03:  0513-059 The mmfs Subsystem has been started. Subsystem PID is 26878.
k145n04:  0513-059 The mmfs Subsystem has been started. Subsystem PID is 17550.
k145n05:  0513-059 The mmfs Subsystem has been started. Subsystem PID is 24088.
 

See also

mmchfs Command

mmcrfs Command

mmlsnode Command

Location

/usr/lpp/mmfs/bin