GPFS: Administration and Programming Reference - IRA Home

mmrestripefile Command
Name
mmrestripefile - Performs a repair operation over the specified list of files.
Synopsis
mmrestripefile {-m | -r | -b | -p} {[-F FilenameFile] | Filename [Filename...]}
Description
The mmrestripefile command performs a repair operation over the specified list of files. The -F flag allows
the user to specify a file containing the list of file names to be restriped, with one file name per line.
The mmrestripefile command attempts to restore the metadata or data replication factor of the file.
You must specify one of the four options (-b, -m, -p, or -r) to indicate how much file data to move.
If you do not use replication, the -m and -r options are equivalent. Their behavior differs only on replicated
files. After a successful replicate (-r option), all suspended disks are empty. A migrate operation, using the
-m option, leaves data on a suspended disk as long as at least one other replica of the data remains on a
disk that is not suspended. Restriping a file system includes replicating it. The -b option performs all the
operations of the -m and -r options.
When using SANergy, consider these points:
v If the mmrestripefile command is issued on a file that is locked by SANergy, the command waits until it
is unlocked before proceeding.
v I/O operations from SANergy clients must terminate before using the mmrestripefile command. If not,
the client applications receive an error.
Parameters
-F FilenameFile
Specifies a file containing a list of names of files to be restriped, one name per line.
Filename
Specifies the names of one or more files to be restriped.
Options
-b Rebalances all files across all disks that are not suspended, even if they are stopped. Although
blocks are allocated on a stopped disk, they are not written to a stopped disk, nor are reads
allowed from a stopped disk, until that disk is started and replicated data is copied onto it. The
mmrestripefile command rebalances and restripes the file.
-m Migrates all critical data off any suspended disk in this file system. Critical data is all data that
would be lost if currently suspended disks were removed.
-p Directs mmrestripefile to repair the file placement within the storage pool.
Files assigned to one storage pool, but with data in a different pool, will have their data migrated
to the correct pool. These files are called ill-placed. Utilities, such as the mmchattr command,
may change a file’s storage pool assignment, but not move the data. The mmrestripefile
command may then be invoked to migrate all of the data at once, rather than migrating each file
individually. Note that the rebalance operation, specified by the -b option, also performs data
placement on all files, whereas the placement option, specified by -p, rebalances only the files that
it moves.
252 GPFS: Administration and Programming Reference