vxresize(1M)                     VxVM 3.5                      vxresize(1M)
                                 1 Jun 2002



 NAME    [Toc]    [Back]
      vxresize - change the length of a volume containing a file system

 SYNOPSIS    [Toc]    [Back]
      /etc/vx/bin/vxresize [-bfnsx] [-F fstype] [-g diskgroup] [-t tasktag]
      volume new_length [medianame...]

 DESCRIPTION    [Toc]    [Back]
      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:

       ______________________________________________________________
      |              |  Online JFS   |   Base JFS    |      HFS      |
      |              |  (Full-VxFS)  |  (Lite-VxFS)  |               |
      |______________|_______________|_______________|_______________|
      | Mounted FS   |Grow and shrink|  Not allowed  |  Not allowed  |
      |              | (uses fsadm)  |               |               |
      |______________|_______________|_______________|_______________|
      | Unmounted FS |   Grow only   |   Grow only   |   Grow only   |
      |              |(uses extendfs)|(uses extendfs)|(uses extendfs)|
      |______________|_______________|_______________|_______________|


      Note:

      +  vxresize works with JFS (derived from VERITAS File System (VxFS))
         and HFS file systems only.

      +  In some situations, when resizing large volumes, vxresize may take
         a long time to complete.

      +  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.

      +  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.

      The medianame operands name disks to use 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



                                    - 1 -       Formatted:  January 24, 2005






 vxresize(1M)                     VxVM 3.5                      vxresize(1M)
                                 1 Jun 2002



      allocation.

 Hardware-Specific Options    [Toc]    [Back]
      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 storagespecific
 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.

 OPTIONS    [Toc]    [Back]
      -b        Performs the resize operation in the background.  The
                command returns quickly, but the resize will be in progress.
                Use the vxprint 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.

      -n        Prevents resizing of a volume if it does not contain a file
                system.

      -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



                                    - 2 -       Formatted:  January 24, 2005






 vxresize(1M)                     VxVM 3.5                      vxresize(1M)
                                 1 Jun 2002



                operation, mark them with the tag tasktag.  The tag
                specified by tasktag is a sequence of up to 16 alphanumeric
                characters.

      -x        Requires that the operation represent an increase in the
                volume length.  Fail the operation otherwise.

 SEE ALSO    [Toc]    [Back]
      extendfs_vxfs(1M), fsadm_vxfs(1M), vxintro(1M), vxprint(1M),
      vxtask(1M)

      VERITAS Volume Manager Administrator's Guide


                                    - 3 -       Formatted:  January 24, 2005