test veritas logo


fsvoladm(1M)

NAME

fsvoladm - VxFS volume administration utility

AVAILABILITY

VRTSvxfs

SYNOPSIS

fsvoladm add [ -f flags ] mount_point volname size

fsvoladm remove mount_point volname

fsvoladm resize mount_point volname newsize

fsvoladm [ -H ] list mount_point

fsvoladm encapsulate pathname volname size

fsvoladm deencapsulate pathname

fsvoladm setflags flags mount_point volname [ ... ]

fsvoladm clearflags flags mount_point volname [ ... ]

fsvoladm queryflags mount_point [volname ... ]

DESCRIPTION

The fsvoladm utility performs administrative tasks, such as adding, removing, resizing, encapsulating volumes, and setting, clearing, or querying flags on 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 and newsize are specified in units of disk blocks. 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

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

KEYWORDS

add Adds a volume to a file system with a size of size. The volume must be in a volume set. The new space is available for allocation. Possible values for flags are:
dataonly The volume can only contain data, not metadata. dataonly is the default flag.
metadataok The volume can contain data or metadata.
clearflags Clears the flags on one or more volumes in a file system. Possible values for flags are:
dataonly The volume can only contain data, not metadata.
metadataok The volume can contain data or metadata.
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.
encapsulate
  Adds a volume to a file system with a size of size, making the contents of that volume available as a file instead of free space.
list Displays the volumes in a file system.
queryflags Displays the flags of one or more volumes in a file system. If no volume is specified, the flags for all volumes in the file system are displayed.
remove Removes a volume from a file system. Files on the volume being removed are relocated to other volumes according to the allocation policies assigned to the file system. If the files cannot be relocated to any of the target volumes specified in the allocation policies, the files are relocated to any volumes in the file system that have sufficient space.
resize Resizes the space usable by the file system on a volume to a size of newsize. You must grow the volume of the volume set before resizing the file system if newsize is larger than the current volume size, as the the volume is not grown automatically.
setflags Sets the flags on one or more volumes in a file system. Possible values for flags are:
dataonly The volume can only contain data, not metadata.
metadataok The volume can contain data or metadata.

OPTIONS

-H Displays storage sizes in the following human-friendly units: KB (kilobytes), MB (megabytes), GB (gigabytes), TB (terabytes), PB (petabytes), and EB (exabytes).

EXAMPLES

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

# fsvoladm add /mnt0 vol1 10g

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


# fsvoladm remove /mnt0 vol1

The following commands resize the volume vol1 to 20 GB and grow the space usable by the file system /mnt0 in the volume set to include the resized space on vol1:


# vxassist -g dg growto vol1 20g # fsvoladm resize /mnt0 vol1 20g

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


# fsvoladm list /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:


# fsvoladm encapsulate /mnt0/database_file vol1 10g

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


# fsvoladm deencapsulate /mnt0/database_file

The following command sets the dataonly flag on volumes vol1 and vol2 in the file system /mnt0:


# fsvoladm setflags dataonly /mnt0 vol1 vol2

The following command clears the dataonly flag on volumes vol1 and vol2 in the file system /mnt0:


# fsvoladm clearflags dataonly /mnt0 vol1 vol2

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


# fsvoladm queryflags /mnt0

SEE ALSO

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

Storage Foundation Administrator’s Guide


VxFS 7.4 fsvoladm(1M)