fsvoladm

NAME

fsvoladm - VxFS volume administration utility

AVAILABILITY

VRTSvxfs

SYNOPSIS

DESCRIPTION

The fsvoladm utility performs administrative tasks, such as adding, removing, resizing, and encapsulating volumes in a specified VERITAS File System. mount_point specifies the directory on which the file system is mounted. volname specifies the volume within the volume set.

By default, size, bias, and newsize are specified in units of disk blocks (DEV_BSIZE bytes). However, you can append k, K, m, M, g, G, t, or T to the number to indicate that the value is in kilobytes, megabytes, gigabytes, or terabytes, respectively.

CLUSTER FILE SYSTEM ISSUES

For a cluster mounted file system, you must run fsvoladm from the primary node of the cluster, and the primary must be mounted with read and write access. fsvoladm fails if run from one of the secondary mounts. You can use the fsclustadm showprimary mount_point command to determine which cluster node is the primary before you run fsvoladm.

KEYWORDS

add

Adds a volume to a file system. The new space is available for allocation.

deencapsulate

Removes an encapsulated volume from a file system and restores the original contents of the volume. This operation can fail if there were significant changes to a file's allocations on disk since encapsulation. A volume encapsulated with a bias cannot be deencapsulated.

encapsulate

Adds a volume to a file system, making the contents of that volume, starting from offset bias, available as a file instead of free space. The size of the encapsulated file is size - bias. bias must be smaller than size, and be a multiple of the file system block size. The default value of bias is 0.

list

Displays the volumes in a file system.

remove

Removes a volume from a file system.

resize

Resizes one of the volumes in a file system. In some circumstances, the fsvoladm command cannot resize a 100% full file system due to lack of space for updating structural information. Check VxFS file systems on a regular basis; increase their size if they approach 100% capacity. This problem can also occur if the file system is very busy. Free up space or reduce activity on the file system and try the resize again.

EXAMPLES

The following command adds the volume vol1 that is 10 gigabytes in size, to the file system /mnt0:

The following command removes the volume vol1 from the file system /mnt0:

The following command resizes the volume vol1 in the file system /mnt0 from its current size to 20 GB:

The following command displays the volumes in the file system /mnt0:

The following command encapsulates the volume vol1. The volume is ten gigabytes in size, resides in the file system /mnt0, and has the file name database_file:

The following command de-encapsulates the volume that was encapsulated in the previous example:

SEE ALSO

df_vxfs (1M), fsapadm (1M), fsvoladm (1M), mount_vxfs (1M), vxvset(1M)

VERITAS File System Administrator's Guide