unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



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



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

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

 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:

       ______________________________________________________________
      |		     |	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:  August 2, 2006






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



      allocation.

 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.

 OPTIONS
      -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:  August 2, 2006






 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
      extendfs_vxfs(1M), fsadm_vxfs(1M), vxintro(1M), vxprint(1M),
      vxtask(1M)

      VERITAS Volume Manager Administrator's Guide










































				    - 3 -	  Formatted:  August 2, 2006