source: gpfs_3.1_ker2.6.20/share/man/man8/mmsanrepairfs.8 @ 249

.TH mmsanrepairfs 02/16/06

mmsanrepairfs Command

.SH "Name"

.PP

\fBmmsanrepairfs\fR - Repair a file system under the control of

SANergy.

.SH "Synopsis"

.PP

\fBmmsanrepairfs\fR \fIDevice\fR [\fB-n\fR |

\fB-f\fR]

.SH "Description"

.PP

Use the \fBmmsanrepairfs\fR command to remove leftover hyper-allocated

blocks caused by SANergy client failure or SANergy protocol application

failure. This command can be run on a mounted or unmounted file

system.

.SH "Parameters"

.PP

.RS +3

\fB\fIDevice\fR

\fR

.RE

.RS +9

The device name of the file system. File system names need not be

fully-qualified. \fBfs0\fR is as acceptable as

\fB/dev/fs0\fR.

.RE

.SH "Options"

.PP

.RS +3

\fB\fB-f\fR

\fR

.RE

.RS +9

Specifies to force unlock SANergy locked files after an existing SANergy

lease has expired for those files.

.RE

.PP

.RS +3

\fB\fB-n\fR

\fR

.RE

.RS +9

Specifies to query the current SANergy hyper-allocated blocks state on the

file system. Does not perform the actual removal of the data

blocks.

.RE

.SH "Exit status"

.PP

.PP

.RS +3

\fB0

\fR

.RE

.RS +9

Successful completion.

.RE

.PP

.RS +3

\fBnonzero

\fR

.RE

.RS +9

A failure has occurred.

.RE

.SH "Security"

.PP

You must have root authority to run the \fBmmsanrepairfs\fR

command.

.PP

When using the \fBrcp\fR and \fBrsh\fR commands for remote

communication, a properly configured \fB.rhosts\fR file must exist

in the root user's home directory on each node in the GPFS

cluster. If you have designated the use of a different remote

communication program on the

\fBmmcrcluster\fR or the

\fBmmchcluster\fR command, you must ensure:

.RS +3

.HP 3

1. Proper authorization is granted to all nodes in the GPFS cluster.

.HP 3

2. The nodes in the GPFS cluster can communicate without the use of a

password, and without any extraneous messages.

.RE

.SH "Examples"

.RS +3

.HP 3

1. Issue this command to remove the hyper-allocated blocks from the file

system named \fBgpfsfc\fR:

.sp

.nf

mmsanrepairfs gpfsfc\ 

.fi

.sp

Output is similar to:

.sp

.nf

"gpfsfc" number of disks: 6, number of inodes: 25920,

      blockSize 16384

Warning: "gpfsfc" is mounted on 1 node(s) and in use on 2 nodes

Scanning user file metadata...

  Repairing hyper allocated inode 21888...repaired

  Repairing hyper allocated inode 21891...repaired

  Repairing hyper allocated inode 21893...repaired

  Repairing hyper allocated inode 21897...repaired

  Repairing hyper allocated inode 21900...repaired

  Total number of sanergy hyper allocated files 35,

     inconsistent 0, repaired 35

.fi

.sp

.HP 3

2. Issue this command to unlock SANergy-locked files in the file system named

\fBgpfsfc\fR:

.sp

.nf

mmsanrepairfs gpfsfc -f

.fi

.sp

Output is similar to:

.sp

.nf

"gpfsfc" number of disks: 6, number of inodes: 25920,

         blockSize 16384

Warning: "gpfsfc" is mounted on 1 node(s) and in use on 2 nodes

Scanning user file metadata...

  18432: sanergy unlocked

    71 % complete on Thu Jul 10 16:52:01 2003

Total number of sanergy hyper allocated files 0, inconsistent 0,\ 

           repaired 0

.fi

.sp

.RE

.SH "See also"

.PP

\fISANergy export considerations\fR in

\fIGeneral Parallel File System: Advanced

Administration Guide\fR.

.SH "Location"

.PP

\fB/usr/lpp/mmfs/bin\fR

.PP