Home > Veritas Storage Foundation™ File System Manual Pages
FSVOLADM (1M) |
|
Maintenance Commands |
Table of contents
fsvoladm - VxFS volume administration utility
VRTSvxfs
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
[ ]
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.
No cluster issues;
command operates the same on cluster file systems.
-
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.
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
df_vxfs(1M),
fsapadm(1M),
fsvoladm(1M),
mount_vxfs(1M),
vxvset(1M)
Veritas File System Administrator's Guide
Last updated: 7 May 2007
Copyright ©2009 Symantec Corporation
All rights reserved.