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 upgrade, coexistence, and compatibility considerations in Upgrading. You must ensure that all nodes in the cluster have been upgraded 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".