mmmount command

Mounts GPFS file systems on one or more nodes in the cluster.

Synopsis

mmmount {Device | DefaultMountPoint | DefaultDriveLetter |
         all | all_local | all_remote | {-F DeviceFileName}}
        [-o MountOptions] [-a | -N {Node[,Node...] | NodeFile | NodeClass}]

mmmount Device {MountPoint | DriveLetter}
        [-o MountOptions] [-a | -N {Node[,Node...] | NodeFile | NodeClass}]

Availability

Available on all IBM Storage Scale editions.

Description

The mmmount command mounts the specified GPFS file system on one or more nodes in the cluster. If no nodes are specified, the file systems are mounted only on the node from which the command was issued. A file system can be specified using its device name or its default mount point, as established by the mmcrfs, mmchfs or mmremotefs commands.

When all is specified in place of a file system name, all GPFS file systems will be mounted. This also includes remote GPFS file systems to which this cluster has access.

Important: The mmmount command fails if you run it while file system maintenance mode is enabled. For more information about file system maintenance mode, see File system maintenance mode.

Note: The time that is required to mount a file system for the first time is greater if the file system uses one or more thin provisioned disks. The extra time is used by the mount operation to reserve physical space for error recovery on each thin provisioned disk. For more information, see IBM Storage Scale with data reduction storage devices.

Parameters

Device | DefaultMountPoint | DefaultDriveLetter | all | all_local | all_remote | {-F DeviceFileName}

Indicates the file system or file systems to be mounted.

Device: The device name of the file system to be mounted. File system names need not be fully-qualified. fs0 is just as acceptable as /dev/fs0.
DefaultMountPoint: The mount point associated with the file system as a result of the mmcrfs, mmchfs, or mmremotefs commands.
DefaultDriveLetter: The Windows drive letter associated with the file system as a result of the mmcrfs or mmchfs command.
all: Indicates all file systems known to this cluster.
all_local: Indicates all file systems owned by this cluster.
all_remote: Indicates all files systems owned by another cluster to which this cluster has access.
-F DeviceFileName: Specifies a file containing the device names, one per line, of the file systems to be mounted.

This must be the first parameter.

DriveLetter

The location where the file system is to be mounted. If not specified, the file system is mounted at its default drive letter. This option can be used to mount a file system at a drive letter other than its default one or to mount a file system that does not have an established default drive letter.

MountPoint

The location where the file system is to be mounted. If not specified, the file system is mounted at its default mount point. This option can be used to mount a file system at a mount point other than its default mount point.

Options

-a

Mount the file system on all nodes in the GPFS cluster.

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

Specifies the nodes on which the file system is to be mounted.

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.

-o MountOptions

Specifies the mount options to pass to the mount command when mounting the file system. For a detailed description of the available mount options, see Mount options specific to IBM Storage Scale.

Exit status

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

Security

You must have root authority to run the mmmount 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 mount all GPFS file systems on all of the nodes in the cluster, issue this command:
```
mmmount all -a
```
The output is similar to this:
```
Mon Mar 23 06:56:53 EDT 2020: mmmount: Mounting file systems ...
```
To mount file system fs2 read-only on the local node, issue this command:
```
mmmount fs2 -o ro
```
The output is similar to this:
```
Mon Mar 23 08:14:49 EDT 2020: mmmount: Mounting file systems ...
```
To mount file system fs1 on all NSD server nodes, issue this command:
```
mmmount fs1 -N nsdsnodes
```
The output is similar to this:
```
Mon Mar 23 08:18:53 EDT 2020: mmmount: Mounting file systems ...
```

Location

/usr/lpp/mmfs/bin