.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