mmmigratefs command

Performs needed conversions to support new file system features.

Synopsis

mmmigratefs Device [--fastea] [--online | --offline]

Availability

Available on all IBM Spectrum Scale™ editions.

Description

Use the mmmigratefs command to enable features that require existing on-disk data structures to be converted to a new format.

Before issuing the mmmigratefs command, see the topic about migration, coexistence, and compatibility in the IBM Spectrum Scale: Concepts, Planning, and Installation Guide. You must ensure that all nodes in the cluster have been migrated to the latest level of GPFS™ code and that you have successfully run the mmchconfig release=LATEST command. You must also ensure that the new features have been enabled by running mmchfs -V full.

The mmmigratefs command can be run with the file system mounted or unmounted. If mmmigratefs is run without the --online or --offline parameters specified, the command will determine the mount status of the file system and run in the appropriate mode.

Parameters

Device: The device name of the file system to be migrated. File system names need not be fully qualified; for example, fs0 is just as acceptable as /dev/fs0. This must be the first parameter.
--fastea: Convert the existing extended attributes to the new format required for storing the attributes in the file's inode and thereby allowing for faster extended-attribute access.
--online: Allows the mmmigratefs command to run while the file system is mounted.
--offline: Allows the mmmigratefs command to run while the file system is unmounted.

Exit status

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

Security

You must have root authority to run the mmmigratefs 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 enable fast extended attribute access for file system fs3, issue this command:

mmmigratefs fs3 --fastea

The system displays information similar to the following:

Enabling fastea support
  11.19 % complete on Thu Nov 14 13:50:24 2013  (    167936 inodes        328 MB)
  33.21 % complete on Thu Nov 14 13:51:56 2013  (    498260 inodes        973 MB)
 100.00 % complete on Thu Nov 14 13:52:04 2013
Finalizing upgrade
  11.19 % complete on Thu Nov 14 13:52:27 2013  (    167936 inodes        328 MB)
  26.78 % complete on Thu Nov 14 13:53:07 2013  (    401834 inodes        785 MB)
 100.00 % complete on Thu Nov 14 13:53:27 2013
Feature 'fastea' is now enabled on "fs3".

Location

/usr/lpp/mmfs/bin