Symantec logo

fsvoladm

NAME

fsvoladm - VxFS volume administration utility

AVAILABILITY

VRTSvxfs

SYNOPSIS

fsvoladm add [ -f flags ] mount_point volname size

fsvoladm remove mount_point volname

fsvoladm encapsulate pathname volname size

fsvoladm deencapsulate pathname

fsvoladm list mount_point

fsvoladm resize mount_point volname newsize

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.

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.

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 one of the volumes in a file system to a size of newsize. The volume will not be grown automatically if newsize is larger than the current volume size. 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.

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.

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.

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.

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 command resizes the volume vol1 in the file system /mnt0 from its current size to 20 GB:

# 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)

Veritas File System Administrator's Guide