test veritas logo


vxresize(1M)

NAME

vxresize - change the length of a volume containing a file system

SYNOPSIS

/etc/vx/bin/vxresize [-bfsVx]
        [-F fstype] [-g diskgroup]
        [-o {override|verify|forceresize}] [-t tasktag]
        volume new_length [[!]medianame...]
        [specification_arguments]

DESCRIPTION

The vxresize command either grows or shrinks both the file system and its underlying volume to match the specified new volume length. The ability to grow or shrink is file system dependent. Some file system types may require that the file system be unmounted for the operation to succeed, as shown in the following table:

__________________________________________________________________ | | Full-VxFS | ext2, | ext3, | | | | reiserfs | ext4 | |______________|_______________|_________________|_________________| | Mounted FS |Grow and shrink| Not allowed | Grow only | |______________|_______________|_________________|_________________| | | | | | | Unmounted FS | Not allowed | Grow and shrink | Grow and shrink | |______________|_______________|_________________|_________________|

Note:

o vxresize works with Veritas File System (VxFS), ext2, ext3, and reiserfs file systems only.
o In some situations, when resizing large volumes, vxresize may take a long time to complete.
o Resizing a volume with a usage type other than FSGEN or RAID5 can result in loss of data. Use the -f option to force resizing of such a volume.
o You cannot resize volumes comprised of different layout types. If you try to do so, an error message displays stating that the volume contains a different organization.

The new_length operand can begin with a plus (+) or minus (-) to indicate that the new length is added to or subtracted from from the current volume length. Specify the new length, or change in length, in Veritas Volume Manager standard length units (see vxintro(1M)).

The vxresize command accepts the vxassist specification such as mirror, stripe and alloc. The arguments are passed unmodified to the vxassist command.

For example, medianame operands can be specified to name the disks that are to be used for allocating new space for a volume. These arguments can be a simple name for a disk media record, or they can be of the form medianame, offset to specify an offset within the named disk. If an offset is specified, then regions from that offset to the end of the disk are considered candidates for allocation. If a medianame operand is prefixed by !, the specified storage is excluded from the allocation process.

See the vxassist(1M) manual page for information about storage specification arguments.

OPTIONS

-b Performs the resize operation in the background. The command returns quickly, but the resize will be in progress. Use the vxtask command to determine when the operation completes.
Note: This option is only honored for grow operations on non-RAID5 volumes. Otherwise, it is ignored.
-f Forces a operation that is usually disallowed by vxresize.
-F fstype Supplies the type of the file system to be resized.
-g diskgroup Limits operation of the command to the given disk group, as specified by disk group ID or disk group name. The volume operand is evaluated relative to the given disk group.
-s Requires that the operation represent a decrease in the volume length.
-t tasktag If any tasks are registered to track the progress of the operation, mark them with the tag tasktag. The tag specified by tasktag is a sequence of up to 16 alphanumeric characters.
-V Displays verbose output.
-x Requires that the operation represent an increase in the volume length. Fail the operation otherwise.
-o forceresize
  Resizes an ext3/ext4 file system even if it is mounted. Please consult the relevant documentation and resize2fs manual for information on risks and requirements prior to resizing a mounted file system. Note: Due to a limitation with resize2fs utility, resize of a mounted ext3/ext4 file system may not function properly if the file system has 1K or 2K block size.

Hardware-Specific Options

Some environments provide guidelines to optimize VxVM’s interaction with intelligent storage systems. If these guidelines are present, VxVM follows the guidelines when creating volumes or allocating space for volumes. By default, vxresize only resizes volumes such that the volumes conform with these guidelines. The following options change the behavior of vxresize:
-o override Resizes the specified volume and ignores any storage-specific guidelines. Overriding the guidelines is not recommended as it can result in incompatible objects, or objects that cannot be administered by VxVM and any associated software that exploit storage-specific features.
-o verify Verifies that the specified volume can be resized without violating any storage-specific guidelines, but does not resize the volume. If any guidelines are violated, vxresize exits with an error message.
Note: These options need a specific license. Without the license, vxresize ignores the specified option.

NOTES

When a volume is grown, its layout may be converted as a side effect if vxassist determines that the new volume is too large for the original layout. The values of the stripe-mirror-col-trigger-pt and stripe-mirror-col-split-trigger-pt attributes (by default, 1 gigabyte) control whether a new layout will be applied. A mirror-stripe volume that is larger than the value of stripe-mirror-col-trigger-pt is converted to a stripe-mirror volume. If each column of a stripe-mirror-col volume is larger than the value of stripe-mirror-col-split-trigger-pt, the volume is converted to a stripe-mirror-sd volume where the individual subdisks, rather than the columns, are mirrored. A mirror-concat volume that is larger than the value of stripe-mirror-col-split-trigger-pt is converted to a concat-mirror volume where the individual subdisks, rather than the plexes, are mirrored.

When a volume is shrunk, its layout may be converted as a side effect if vxassist determines that the new volume is too small for the original layout. The values of the stripe-mirror-col-trigger-pt and stripe-mirror-col-split-trigger-pt attributes (by default, 1 gigabyte) control whether a new layout will be applied. A stripe-mirror volume that is smaller than the value of stripe-mirror-col-trigger-pt is converted to a mirror-stripe volume. A concat-mirror volume that is smaller than the value of stripe-mirror-col-split-trigger-pt is converted to a mirror-concat volume.

If the new layout of a volume is inappropriate, use the vxassist convert operation to change the layout after the grow or shrink operation has finished.

For a CFS file system, the vxresize command can be executed on any node in the cluster. Alternatively, you can grow a CFS file system by running the vxassist growto command or the vxassist growby command. Then run the fsadm command. Similarly, to shrink a CFS file system, run the fsadm command, followed by the vxassist shrinkto command or the vxassist shrinkby command. The fsadm command can be run on any CFS node. The vxassist growing and shrinking operations can be run from any CVM node. Veritas recommends running the command on the CVM master node, if possible. To determine if a node is the CVM master node, use the command vxdctl -c mode.

SEE ALSO

fsadm_vxfs(1M), vxassist(1M), vxintro(1M), vxprint(1M), vxtask(1M)

Storage Foundation Administrator’s Guide


VxVM 7.3.1 vxresize(1M)