mmlsmount command

Lists the nodes that have a given GPFS™ file system mounted.

Synopsis

mmlsmount {Device | all | all_local | all_remote | {-F DeviceFileName}} [-L]
             [-C {all | all_remote | ClusterName[,ClusterName...]}]

Availability

Available on all IBM Spectrum Scale™ editions.

Description

The mmlsmount command reports if a file system is in use at the time the command is issued. A file system is considered to be in use if it is explicitly mounted with the mount or mmmount command, or if it is mounted internally for the purposes of running some other GPFS command. For example, when you run the mmrestripefs command, the file system will be internally mounted for the duration of the command. If mmlsmount is issued in the interim, the file system will be reported as being in use by the mmlsmount command but, unless it is explicitly mounted, will not show up in the output of the mount or df commands.

Parameters

Device | all | all_local | all_remote | {-F DeviceFileName}
Indicates the file system or file systems for which information is displayed.
Device
Indicates the device name of the file system for which information is displayed. File system names need not be fully-qualified. fs0 is just as acceptable as /dev/fs0.
all
Indicates all file systems known to this cluster.
all_local
Indicates all file systems owned by this cluster.
all_remote
Indicates all file systems owned by another cluster.
-F DeviceFileName
Specifies a file containing the device names, one per line, of the file systems for which information is displayed.

This must be the first parameter.

Options

-C {all | all_remote | ClusterName[,ClusterName...]}
Specifies the clusters for which mount information is requested. If one or more ClusterName is specified, only the names of nodes that belong to these clusters and have the file system mounted are displayed. The dot character ('.') can be used in place of the cluster name to denote the local cluster.

Option -C all_remote denotes all clusters other than the one from which the command was issued.

Option -C all refers to all clusters, local and remote, that can have the file system mounted. Option -C all is the default.

-L
Specifies to list the nodes that have the file system mounted.

Exit status

0
Successful completion.
nonzero
A failure has occurred.

Security

If you are a root user, 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 file system in IBM Spectrum Scale: Administration and Programming Reference.

If you are a non-root user, you may specify only file systems that belong to the same cluster as the node on which the mmlsmount command was issued.

Examples

  1. To see how many nodes have file system fs2 mounted, issue this command:
    mmlsmount fs2
    The system displays output similar to:
    File system fs2 is mounted on 3 nodes.
  2. To display all mounted file systems:
    mmlsmount all
    The system displays output similar to:
    File system fs1 is mounted on 17 nodes.
    File system remotefs1 (remote.cluster:fs1) is mounted on 17 nodes.
  3. To display all remotely mounted file systems:
    mmlsmount all_remote
    The system displays output similar to:
    File system remotefs1 (remote.cluster:fs1) is mounted on 17 nodes.
  4. To list the nodes having all file systems mounted:
    mmlsmount all -L
    The system displays output similar to:
    File system fs1 is mounted on 3 nodes:
      192.168.105.32  c6f1c3vp2
      192.168.105.31  c6f1c3vp1
      192.168.105.34  c6f1c3vp4
    File system gpfs1 is not mounted.

Location

/usr/lpp/mmfs/bin