fsrpadm

NAME

fsrpadm - VxFS relocation policy administration command

AVAILABILITY

VRTSvxfs

SYNOPSIS

DESCRIPTION

The fsrpadm command administers VERITAS File System relocation policies. This command can be used only on VxFS file systems with multi-volume support enabled.

CLUSTER FILE SYSTEM ISSUES

No cluster issues; command operates the same on cluster file systems.

KEYWORDS

addpolicy

Adds a new relocation policy. The parameters are:

mount_point

Specifies the mount point on which to add the policy.

policy_name

Specifies name of the new policy.

rule_name

Specifies name of the initial rule in the new policy.

from=dev_name[,...]

Specifies the MVS subvolume from which data will be relocated. dev_name can be a comma-separated list of devices. The specified subvolumes cannot also be specified by the to= parameter.

to=dev_name[,...]

Specifies the MVS subvolume to which data will be relocated. dev_name can be a comma-separated list of devices. The specified subvolumes cannot also be specified by the from= parameter.

[dir=directory_path]

Specifies the directory below which files will be moved, and must be specified with the full path name. The default value is the path of the mount point. The directory must exist.

[recursive]

If specified, all files in the directory and the directory below it will be moved.

[pattern=wild_cards]

Specifies a wild card file pattern filter to select files, such as *.*. All shell wild cards may be specified. If multiple patterns are to be specified, a separate rule is required for each pattern.

The wild cards match characters as follows:

*

Matches any character string, including the null string.

?

Matches any single character.

[]

Matches any of the characters enclosed within the brackets.

[-]

Bracket-enclosed characters separated by a hyphen. Matches any character lexically between the specified characters, inclusively. If the first character following the left bracket ([) is an exclamation point (\!!), matches occur for any character not enclosed.

Initial dot (.) file names are matched explicitly. Special characters, including backslash (\), can be escaped with a backslash if they are to be matched explicitly in a file name.

[exclude]

If specified, files selected by this rule will be excluded from the move.

[min=kb]

Specifies the minimum size in kilobytes of the files that will be moved.

[max=kb]

Specifies the maximum size in kilobytes of the files that will be moved.

[accage=days]

Specifies the time in days after which a file will be moved if it is not accessed.

[modage=days]

Specifies the time in days after which a file will be moved if it is not modified.

addrule

Adds a new rule to an existing policy. The parameters are:

mount_point

Specifies the mount point on which the policy exists.

policy_name

Specifies name of the policy to add the new rule.

rule_name

Specifies name of the new rule.

to=dev_name[,...]

Specifies the MVS subvolume to which data will be relocated. dev_name can be a comma-separated list of devices. The specified subvolumes cannot also be specified by the from= parameter of the policy.

[dir=directory_path]

Specifies the directory below which files will be moved, and must be specified with the full path name. The default value is the path of the mount point. The directory must exist.

[recursive]

If specified, all files in the directory and the directory below it will be moved.

[pattern=wild_cards]

Specifies a wild card file pattern filter to select files, such as *.*. All shell wild cards may be specified. If multiple patterns are to be specified, a separate rule is required for each pattern.

The wild cards match characters as follows:

*

Matches any character string, including the null string.

?

Matches any single character.

[]

Matches any of the characters enclosed within the brackets.

[-]

Bracket-enclosed characters separated by a hyphen. Matches any character lexically between the specified characters, inclusively. If the first character following the left bracket ([) is an exclamation point (\!!), matches occur for any character not enclosed.

Initial dot (.) file names are matched explicitly. Special characters, including backslash (\), can be escaped with a backslash if they are to be matched explicitly in a file name.

[exclude]

If specified, files selected by this rule will be excluded from the move.

[min=kb]

Specifies the minimum size in kilobytes of the files that will be moved.

[max=kb]

Specifies the maximum size in kilobytes of the files that will be moved.

[accage=days]

Specifies the time in days during which a file will be moved if it is accessed.

[modage=days]

Specifies the time in days during which a file will be moved if it is modified.

removepolicy

Removes the specified policy along with its rules from the specified mount point.

removerule

Removes the specified rule from the specified policy on the specified mount point. If the last rule is removed, the policy will also be removed.

listpolicy

Lists the names of existing policies on the specified mount point.

listrule

Lists the names of all rules of the specified policy on the specified mount point.

querypolicy

Displays details of all rules of the specified policy on the specified mount point.

queryrule

Displays details of the specified rule from the specified policy on the specified mount point.

OPTIONS

The following options are valid only without any keywords.

-h

Displays usage information.

-help

Displays usage information.

RETURN VALUES

fsrpadm returns zero on success, non-zero on failure.

ERRORS

ENOMEM

Memory could not be allocated to support the command.

EINVAL

Invalid parameters were specified.

EACCESS

The user does not have permission to access the configuration information.

EXAMPLES

The following command adds a relocation policy named a2b with a rule named Default on the mount point /vsa, which will move data from vsavola to vsavolb:

The following command adds a rule named newrule to the a2b policy on the mount point /vsa, which will move data from vsavola, as specified in the previous example, to vsavolc.

The following command displays the details of the rules of the a2b policy on the mount point /vsa:

The following command removes the a2b policy from the mount point /vsa:

SEE ALSO

fsapadm (1M), fsvoladm (1M), fssweep (1M), fsmove (1M)

VERITAS File System Administrator's Guide