mmexportfs command

Retrieves the information needed to move a file system to a different cluster.

Synopsis

mmexportfs {Device | all} -o ExportfsFile

Availability

Available on all IBM Spectrum Scale™ editions.

Description

The mmexportfs command, in conjunction with the mmimportfs command, can be used to move one or more GPFS™ file systems from one GPFS cluster to another GPFS cluster, or to temporarily remove file systems from the cluster and restore them at a later time. The mmexportfs command retrieves all relevant file system and disk information and stores it in the file specified with the -o parameter. This file must later be provided as input to the mmimportfs command. When running the mmexportfs command, the file system must be unmounted on all nodes.

When all is specified in place of a file system name, any disks that are not associated with a file system will be exported as well.

Exported file systems remain unusable until they are imported back with the mmimportfs command to the same or a different GPFS cluster.

Results

Upon successful completion of the mmexportfs command, all configuration information pertaining to the exported file system and its disks is removed from the configuration data of the current GPFS cluster and is stored in the user specified file ExportfsFile.

Parameters

Device | all

The device name of the file system to be exported. File system names need not be fully-qualified. fs0 is as acceptable as /dev/fs0. Specify all to export all GPFS file systems, as well as all disks that do not currently belong to a file system.

If the specified file system device is a IBM Spectrum Scale RAID-based file system, then all affected IBM Spectrum Scale RAID objects will be exported as well. This includes recovery groups, declustered arrays, vdisks, and any other file systems that are based on these objects. For more information about IBM Spectrum Scale RAID, see IBM Spectrum Scale RAID: Administration.

This must be the first parameter.

-o ExportfsFile

The path name of a file to which the file system information is to be written. This file must be provided as input to the subsequent mmimportfs command.

Exit status

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

Security

You must have root authority to run the mmexportfs 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 export all file systems in the current cluster, issue this command:

mmexportfs all -o /u/admin/exportfile

The output is similar to this:

mmexportfs: Processing file system fs1 ...

mmexportfs: Processing file system fs2 ...

mmexportfs: Processing disks that do not belong to any file system ...
mmexportfs: 6027-1371 Propagating the cluster configuration data to all
  affected nodes.  This is an asynchronous process.

Location

/usr/lpp/mmfs/bin