source: gpfs_3.1_ker2.6.20/share/man/man8/mmcheckquota.8 @ 16

.TH mmcheckquota 02/16/06
mmcheckquota Command
.SH "Name"
.PP
\fBmmcheckquota\fR - Checks file system user, group and fileset
quotas.
.SH "Synopsis"
.PP
\fBmmcheckquota\fR [\fB-v\fR] {\fIDevice\fR
[\fIDevice\fR...] | \fB-a\fR}
.PP
Or,
.PP
\fBmmcheckquota\fR {[\fB-u \fR \fIUserQuotaFilename\fR]
| [\fB-g\fR \fIGroupQuotaFileName\fR] | [\fB-j\fR
\fIFilesetQuotaFilename\fR]} \fIDevice\fR
.PP
\fBDescription\fR
.PP
The \fBmmcheckquota\fR command serves two purposes:
.RS +3
.HP 3
1. Count inode and space usage in a file system by user, group and
fileset, and write the collected data into quota files.
.HP 3
2. Replace either the user, group, or fileset quota files, for the file
system designated by \fIDevice\fR, thereby restoring the quota files for
the file system. These files must be contained in the root directory of
\fIDevice\fR. If a backup copy does not exist, an empty file is
created when the \fBmmcheckquota\fR command is issued.
.RE
.PP
The \fBmmcheckquota\fR command counts inode and space usage for a file
system and writes the collected data into quota files. Indications
leading you to the conclusion you should run the \fBmmcheckquota\fR command
include:
.RS +3
.HP 3
1. \fBMMFS_QUOTA\fR error log entries. This error log entry is
created when the quota manager has a problem reading or writing the quota
file.
.HP 3
2. Quota information is lost due to a node failure. A node failure
could leave users unable to open files or deny them disk space that their
quotas should allow.
.HP 3
3. 
The in-doubt value is approaching the quota limit. 
.sp
The sum of the in-doubt value and the current usage may not exceed the hard
limit. Consequently, the actual block space and number of files
available to the user of the group may be constrained by the in-doubt
value. Should the in-doubt value approach a significant percentage of
the quota, use the \fBmmcheckquota\fR command to account for the lost space
and files.
.HP 3
4. User, group, or fileset quota files are corrupted.
.RE
.PP
The result of an online quota check may be incomplete when files are being
accessed through SANergy at the time of the file system quota check.
See
\fISANergy export considerations\fR in
\fIGeneral Parallel File System: Advanced
Administration Guide\fR. To get an accurate online quota check
result, rerun \fBmmcheckquota\fR when SANergy is not active.
.PP
The \fBmmcheckquota\fR command is I/O intensive and should be run when
the system load is light. When issuing the \fBmmcheckquota\fR
command on a mounted file system, negative in-doubt values may be reported if
the quota server processes a combination of up-to-date and back-level
information. This is a transient situation and may be ignored.
.SH "Parameters"
.PP
.RS +3
\fB-a
\fR
.RE
.RS +9
Checks all GPFS file systems in the cluster from which the command is
issued.
.RE
.PP
.RS +3
\fB\fI\fR\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
.PP
.RS +3
\fB-g \fIGroupQuotaFileName\fR
\fR
.RE
.RS +9
Replace the current group quota file with the file indicated.
.PP
When replacing quota files with the \fB-g\fR option:
.RS +3
.HP 3
\(bu The quota file must be in the root directory of the file system.
.HP 3
\(bu The file system must be unmounted.
.RE
.RE
.PP
.RS +3
\fB-j \fIFilesetQuotaFilename\fR
\fR
.RE
.RS +9
Replace the current fileset quota file with the file indicated.
.PP
When replacing quota files with the \fB-j\fR option:
.RS +3
.HP 3
\(bu The quota file must be in the root directory of the file system.
.HP 3
\(bu The file system must be unmounted.
.RE
.RE
.PP
.RS +3
\fB-u \fIUserQuotaFilename\fR
\fR
.RE
.RS +9
Replace the current user quota file with the file indicated.
.PP
When replacing quota files with the \fB-u\fR option:
.RS +3
.HP 3
\(bu The quota file must be in the root directory of the file system.
.HP 3
\(bu The file system must be unmounted.
.RE
.RE
.SH "Options"
.PP
.RS +3
\fB-v 
\fR
.RE
.RS +9
Reports discrepancies between calculated and recorded disk quotas.
.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 \fBmmcheckquota\fR
command.
.PP
GPFS must be running on the node from which the \fBmmcheckquota\fR
command is issued.
.SH "Examples"
.RS +3
.HP 3
1. To check quotas for file system \fBfs0\fR, issue this command:
.sp
.nf
mmcheckquota fs0
.fi
.sp
The system displays information only if a problem is found.
.HP 3
2. To check quotas for all file systems, issue this command:
.sp
.nf
mmcheckquota -a
.fi
.sp
The system displays information only if a problem is found or if quota
management is not enabled for a file system:
.sp
.nf
fs2: no quota management installed
fs3: no quota management installed
.fi
.sp
.HP 3
3. To report discrepancies between calculated and recorded disk quotas,
issue this command:
.sp
.nf
mmcheckquota -v fs1
.fi
.sp
The system displays information similar to:
.sp
.nf
fs1: Start quota check
19 % complete on Mon Feb 6 17:39:55 2006
34 % complete on Mon Feb 6 17:40:26 2006
55 % complete on Mon Feb 6 17:40:57 2006
64 % complete on Mon Feb 6 17:41:29 2006
85 % complete on Mon Feb 6 17:42:00 2006
99 % complete on Mon Feb 6 17:42:33 2006
fs1: quota check found the following differences:
USR 0: 98463 subblocks counted (was 3601); 17404 inodes counted (was 15999)
USR 60001: 4766 subblocks counted (was -4499); 644 inodes counted (was 639)
USR 60008: 4162 subblocks counted (was -5654); 534 inodes counted (was 532)
USR 60012: 7248 subblocks counted (was -1619); 2013 inodes counted (was 2217)
USR 60013: 6915 subblocks counted (was -616); 1773 inodes counted (was 2297)
USR 60014: 6553 subblocks counted (was -1124); 1885 inodes counted (was 2533)
USR 60020: 7045 subblocks counted (was -2486); 2050 inodes counted (was 1986)
GRP 0: 98529 subblocks counted (was 6406); 17437 inodes counted (was 15910)
GRP 100: 116038 subblocks counted (was -65884); 26277 inodes counted (was 30656)
FILESET 0: 214567 subblocks counted (was -60842); 43714 inodes counted (was 46661)
.fi
.sp
.RE
.SH "See also"
.PP
mmedquota Command
.PP
mmfsck Command
.PP
mmlsquota Command
.PP
mmquotaon Command
.PP
mmquotaoff Command
.PP
mmrepquota Command
.SH "Location"
.PP
\fB/usr/lpp/mmfs/bin\fR
.PP