Home > Veritas Storage Foundation™ File System Manual Pages
FSVOLADM (1M) |
|
Maintenance Commands |
Table of contents
fsvoladm - VxFS volume administration utility
VRTSvxfs
fsvoladm
add mount_point volname size
fsvoladm
remove mount_point volname
fsvoladm
encapsulate pathname volname size
[ bias ]
fsvoladm
deencapsulate pathname
fsvoladm
list mount_point
fsvoladm
resize mount_point volname newsize
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.
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.
-
add
-
Adds a volume to a file system with a size of
size.
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 to a size of
newsize.
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.
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
df_vxfs(1M),
fsapadm(1M),
fsvoladm(1M),
mount_vxfs(1M),
vxvset(1M)
VERITAS File System Administrator's Guide
Last updated: 01 April 2006
Copyright ©2009 Symantec Corporation
All rights reserved.