fsppmk(1M)fsppmk(1M)NAMEfsppmk - placement policy creation utility
AVAILABILITY
VRTSvxfs
SYNOPSISfsppmk policy [-b] -n policy_name [-v version] [-e]
fsppmk rule [-b] [-n rule_name] [-t {data|ckpt}] [-e]
fsppmk select [-b] [-u user_name] [-U user_id]
[-g group_name] [-G group_id] [-p pattern]
[-d directory [-r]] [-t file_tag] [-e]
fsppmk create -b -d tier[:balance_size:{KB|MB|GB}], ... -e
fsppmk delete [-b] [-s tier, ...] [-e]
fsppmk relocate [-b] [-s tier, ...]
-d tier[:balance_size:{KB|MB|GB}], ... [-e]
fsppmk qualifier -b -q size -t {bytes|KB|MB|GB}
-c {gt|gteq|eq|lt|lteq},value -e
fsppmk qualifier -b -q modage -t {hours|days}
-c {gt|gteq|eq|lt|lteq},value -e
fsppmk qualifier -b -q accage -t {hours|days}
-c {gt|gteq|eq|lt|lteq},value -e
fsppmk qualifier -b -q iotemp -t {nrbytes|nwbytes|nrwbytes}
-c {gt|gteq|eq|lt|lteq},value -p days -e
fsppmk qualifier -b -q accesstemp -t {nreads|nwrites|nrws}
-c {gt|gteq|eq|lt|lteq},value -p days -e
DESCRIPTION
The fsppmk command generates the XML construct for a portion of a
placement policy. The fsppmk command outputs the generated XML to std‐
out, and a series of outputs from this command can be concatenated to
generate a complete placement policy.
The fsppmk command does not validate the resulting placement policy,
although the policy can be validated by the fsppadm command.
NOTES
The XML output is not guaranteed to be in a user-friendly format.
Cluster File System Issues
No cluster issues; command operates the same on cluster file systems.
KEYWORDS
create Generates a CREATE element.
delete Generates a DELETE element.
policy Generates the leading XML headers with the DTD line and the
PLACEMENT_POLICY element.
qualifier Generates the qualifier criteria for the RELOCATE and DELETE
elements.
relocate Generates a RELOCATE element.
rule Generates a RULE element.
select Generates a SELECT element. Multiple SELECT elements can be
generated by a series of fsppmk select commands, with first
command invoked with the -b option but without the -e option,
and the last command without the -b option but with the -e
option, and with neither the -b nor the -e options in the
intermediary invocations.
OPTIONS-b Specifies the beginning of an element. This option can be
mandatory or optional depending on the context.
-c {gt|gteq|eq|lt|lteq},value
Specifies the comparison condition and value for the quali‐
fier.
-d directory
Specifies the directory.
-d tier[:balance_size:{KB|MB|GB}], ...
Specifies the destination tiers, and the balance size for
those tiers.
-e Specifies the end of an element. This option can be manda‐
tory or optional depending on the context.
-G group_id
Specifies the group ID.
-g group_name
Specifies the group name.
-n policy_name
Specifies the name of the placement policy.
-n rule_name
Specifies the name of the RULE element.
-p days Specifies the period of time over which IOTEMP or ACCESSTEMP
is monitored.
-q {size|modage|accage|iotemp|accesstemp}
Specifies the qualifier type.
-r Specifies recursive selecting. -r can be specified only with
-d. If -r is not specified, files are selected nonrecur‐
sively.
-s tier, ...
Specifies the source tiers.
-t {bytes|KB|MB|GB|hours|days|nrbytes|nwbytes|nrwbytes}
Specifies the units for the qualifier.
-t {data|ckpt}
Specifies the type of the RULE element.
-t file_tag
Specifies the file tag.
-U user_id
Specifies the user ID.
-u user_name
Specifies the user name.
-v version
Specifies the VxFS version for which to generate the XML
headers, which can be 5.0 or later. If the -v option is not
specified, fsppmk will create a version that is supported by
the latest VxFS release. The default is 5.0.
EXAMPLES
The following series of commands create a placement policy, Policy1:
# fsppmk policy -b -n Policy1 -v 5.0 > mypolicy.xml
# fsppmk rule -b -n Rule1 -t data >> mypolicy.xml
# fsppmk select -b -u User1 -g Group1 -p mpg -d test/dir1 \
-r -e >> mypolicy.xml
# fsppmk relocate -b -d tier1:MB:2 -s tier2,tier3 >> mypolicy.xml
# fsppmk qualifier -b -q iotemp -t nrwbytes -c gteq,200 \
-p 10 >> mypolicy.xml
# fsppmk relocate -e >> mypolicy.xml
# fsppmk rule -e >> mypolicy.xml
# fsppmk policy -e >> mypolicy.xml
# cat mypolicy.xml
<?xml version = "1.0"?>
<!DOCTYPE FILE_PLACEMENT_POLICY_SYSTEM
"/opt/VRTSfspro/config/placement_policy.dtd">
<PLACEMENT_POLICY Name="Policy1" Version="5.0">
<RULE Name="Rule1" Flags="data">
<SELECT>
<USER> User1 </USER>
<GROUP> Group1 </GROUP>
<PATTERN> *.mpg </PATTERN>
<DIRECTORY Flags="recursive"> test/dir1 </DIRECTORY>
</SELECT>
<RELOCATE>
<FROM>
<SOURCE>
<CLASS> tier2 </CLASS>
</SOURCE>
<SOURCE>
<CLASS> tier3 </CLASS>
</SOURCE>
</FROM>
<TO>
<DESTINATION>
<CLASS> tier1 </CLASS>
<BALANCE_SIZE Units = "MB"> 2 </BALANCE_SIZE>
</DESTINATION>
</TO>
<WHEN>
<IOTEMP Type="nrwbytes">
<MIN Flags="gteq"> 200 </MIN>
<PERIOD> 10 </PERIOD>
</IOTEMP>
</WHEN>
</RELOCATE>
</RULE>
</PLACEMENT_POLICY>
SEE ALSOfsppadm(1M), fstag(1M)
Veritas File System Administrator's Guide
VxFS 5.0 7 Jan 2008 fsppmk(1M)