.TH mmchpolicy 12/01/06
mmchpolicy Command
.SH "Name"
.PP
\fBmmchpolicy\fR - Establish policy rules for a GPFS file
system.
.SH "Synopsis"
.PP
\fBmmchpolicy\fR \fIDevice\fR \fIPolicyFileName\fR \fB[-t \fR
\fIDescriptiveName\fR \fB] [-I {\fR\fB\fIyes\fR\fR\fB | test} ]\fR
.SH "Description"
.PP
Use the \fBmmchpolicy\fR command to establish the rules for policy-based
lifecycle management of the files in a given GPFS file system. Some of
the things that can be controlled with the help of policy rules are:
.RS +3
.HP 3
\(bu File placement at creation time
.HP 3
\(bu Replication factors
.HP 3
\(bu Movement of data between storage pools
.HP 3
\(bu File deletion
.RE
.PP
The \fBmmapplypolicy\fR command must be run to move data between
storage pools or delete files.
.PP
Policy changes take effect immediately on all nodes that have the affected
file system mounted. For nodes that do not have the file system
mounted, policy changes take effect upon the next mount of the file
system.
.PP
For information on GPFS policies, see the chapter \fIPolicy-based
data management for GPFS\fR in \fIGeneral Parallel File System:
Advanced Administration Guide\fR.
.SH "Parameters"
.PP
.RS +3
\fB\fIDevice\fR
\fR
.RE
.RS +9
The device name of the file system for which policy information is to be
established or changed. File system names need not be
fully-qualified. \fBfs0\fR is just as acceptable as
\fB/dev/fs0\fR. This must be the first parameter.
.RE
.PP
.RS +3
\fB\fIPolicyFileName\fR
\fR
.RE
.RS +9
The name of the file containing the policy rules. If you specify
\fBDEFAULT\fR, GPFS replaces the current policy file with a single policy
rule that assigns all newly created files to the system storage pool.
.RE
.SH "Options"
.PP
.RS +3
\fB-I {\fB\fIyes\fR\fR | test}
\fR
.RE
.RS +9
Specifies whether to activate the rules in the policy file
\fIPolicyFileName\fR.
.PP
.RS +3
\fByes
\fR
.RE
.RS +9
The policy rules are validated and immediately activated. This is
the default.
.RE
.PP
.RS +3
\fBtest
\fR
.RE
.RS +9
The policy rules are validated, but not installed.
.RE
.RE
.PP
.RS +3
\fB-t \fIDescriptiveName\fR
\fR
.RE
.RS +9
Specifies an optional descriptive name to be associated with the policy
rules. The string must be less than 256 characters in length. If
not specified, the descriptive name defaults to the base name portion of the
\fIPolicyFileName\fR parameter.
.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 \fBmmchpolicy\fR command.
.PP
You may issue the \fBmmchpolicy\fR command from any node in the GPFS
cluster.
.SH "Examples"
.RS +3
.HP 3
1. This command validates a policy before it is installed:
.sp
.nf
mmchpolicy fs2 policyfile -I test
.fi
.sp
The system displays output similar to:
.sp
.nf
Validated policy 'policyfile': parsed 3 StgPoolRules,
3 MigratRules
.fi
.sp
.HP 3
2. This command installs a policy:
.sp
.nf
mmchpolicy fs2 policyfile
.fi
.sp
The system displays output similar to:
.sp
.nf
Policy 'policyfile' installed and broadcast to all nodes.
Validated policy 'policyfile': parsed 3 StgPoolRules,
3 MigratRules
.fi
.sp
.sp
To confirm the change, issue this command:
.sp
.nf
mmlspolicy fs2
.fi
.sp
.sp
The system displays output similar to:
.sp
.nf
Policy file for file system '/dev/fs2':
  Installed by root@k155n11.kgn.ibm.com on Mon Dec 12
   16:56:31 2005.
  First line from original file 'policyfile' was:
/* This is the policy for the fs2 GPFS file system. */
.fi
.sp
.RE
.SH "See also"
.PP
mmapplypolicy Command
.PP
mmlspolicy Command
.SH "Location"
.PP
\fB/usr/lpp/mmfs/bin\fR