mmbackupconfig command

Collects GPFS™ file system configuration information.

Synopsis

mmbackupconfig Device -o OutputFile

Availability

Available with IBM Spectrum Scale™ Standard Edition or higher. Available on AIX® and Linux.

Description

The mmbackupconfig command, in conjunction with the mmrestoreconfig command, can be used to collect basic file system configuration information that can later be used to restore the file system. The configuration information backed up by this command includes block size, replication factors, number and size of disks, storage pool layout, filesets and junction points, policy rules, quota information, and a number of other file system attributes.

This command does not back up user data or individual file attributes.

For more information about the mmimgbackup and mmimgrestore commands, see Scale Out Backup and Restore (SOBAR).

Parameters

Device
The device name of the file system to be backed up. File system names need not be fully-qualified. fs0 is as acceptable as /dev/fs0.

This must be the first parameter.

-o OutputFile
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 mmrestoreconfig command.

Exit status

0
Successful completion.
nonzero
A failure has occurred.

Security

You must have root authority to run the mmbackupconfig 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 backup file system fsiam2 to output file backup.config.fsiam2 issue:
mmbackupconfig fsiam2 -o backup.config.fsiam2

The system displays information similar to:
mmbackupconfig: Processing file system fsiam2 ...
mmbackupconfig: Command successfully completed

Location

/usr/lpp/mmfs/bin