fsapadm

NAME

fsapadm - VxFS allocation policy administration utility

AVAILABILITY

VRTSvxfs

SYNOPSIS

DESCRIPTION

The fsapadm utility performs administrative tasks, such as assigning, defining, deleting, and enforcing allocation policies in a specified VERITAS File System. policy_name specifies the name of an allocation policy. The maximum length of an allocation policy name is 64 characters. mount_point specifies the directory on which the file system is mounted.

CLUSTER FILE SYSTEM ISSUES

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

KEYWORDS

assignckpt

Assigns allocation policies to a Storage Checkpoint.

assignfile

Assigns allocation policies to an individual file. Possible values for flags are:

inherit

Set this flag on a directory and subsequently the files created in the directory will inherit the allocation policies.

assignfs

Assigns the default allocation policies for an entire file system.

define

Defines a new allocation policy or changes an existing allocation policy named policy_name at the specified mount point. In the latter case, the previously specified volumes are replaced by the newly specified volumes. Possible values for order are:

as-given

Allocations are done from the volume in the order in which they are given in the allocation policy.

least-full

Allocations are done from the volume specified in the allocation policy that has the most free blocks.

round-robin

Allocations are done from a volume that is selected in a round-robin fashion from those specified in the allocation policy.

The default order is as-given.

Possible values for flags are:

anyuser

Allows non-privileged users to be able to assign the policy using the define keyword. By default, only privileged users can assign policies.

delete

Deletes an allocation policy.

enforcefile

Enforces the allocation policies assigned to an individual file by moving any data and metadata that does not fulfill its assigned allocation policy into new blocks that do fulfill its assigned allocation policy.

list

Displays the definitions of all allocation policies defined in a file system.

query

Displays the definition of an allocation policy.

queryfs

Displays the allocation policies assigned to an entire file system.

queryckpt

Displays the allocation policies assigned to a Storage Checkpoint.

queryfile

Displays the allocation policies assigned to an individual file.

EXAMPLES

The following command defines an allocation policy named raid5 using volumes vol1 and vol2, with order as-given in the file system mounted at /mnt0:

The following command deletes the allocation policy named raid5 from the file system mounted at /mnt0:

The following command displays the definition of the allocation policy named raid5 in the file system mounted at /mnt0:

The following command assigns the allocation policies named raid5 and mirror as the default policies for data and metadata, respectively, for all files in the file system mounted at /mnt0:

The following command assigns the allocation policy named backup-storage as the default policy for data and metadata, respectively, for the Storage Checkpoint monday_7pm in the file system mounted at /mnt0:

The following command assigns the allocation policy named mpeg_data for data and metadata, respectively, to the file movie.mpg:

The following command displays the allocation policies assigned as the defaults for all files in the file system mounted at /mnt0:

The following command displays the allocation policies assigned to the Storage Checkpoint monday_7pm in the file system mounted at /mnt0:

The following command displays the allocation policies assigned to the file movie.mpg in the file system mounted at \mnt0:

The following command enforces the allocation policies assigned to the file movie.mpg in the file system mounted at /mnt0 (that is, the existing allocations are moved to match the policies, if required):

SEE ALSO

fsadm_vxfs (1M) fsckptadm (1M) fsvoladm (1M)

VERITAS File System Administrator's Guide