VGCHANGE(8)							  VGCHANGE(8)



NAME
       vgchange - change attributes of a volume group

SYNOPSIS
       vgchange	 [--addtag  Tag]  [--alloc AllocationPolicy] [-A|--autobackup
       {y|n}]  [-a|--available	[e|l]  {y|n}]  [-d|--debug]  [--deltag	 Tag]
       [-h|--help]   [--ignorelockingfailure]	[-l|--logicalvolume  MaxLogi-
       calVolumes]  [-P|--partial]  [-s|--physicalextentsize  PhysicalExtent-
       Size[kKmMgGtT]]	[-t|--test]  [-v|--verbose] [--version] [-x|--resize-
       able {y|n}] [VolumeGroupName...]

DESCRIPTION
       vgchange allows you to change the attributes of	one  or	 more  volume
       groups.	 Its  main purpose is to activate and deactivate VolumeGroup-
       Name, or all volume groups if none is specified.	 Only  active  volume
       groups  are  subject to changes and allow access to their logical vol-
       umes.  [Not  yet	 implemented:  During  volume  group  activation,  if
       vgchange	 recognizes  snapshot  logical	volumes	 which	were  dropped
       because they ran out of space, it displays  a  message  informing  the
       administrator that such snapshots should be removed (see lvremove(8)).
       ]

OPTIONS
       See lvm for common options.

       -A, --autobackup{y|n}
	      Controls automatic backup of metadata after  the	change.	  See
	      vgcfgbackup (8).	Default is yes.

       -a, --available[e|l]{y|n}
	      Controls	the availability of the logical volumes in the volume
	      group for input/output.  In other words, makes the logical vol-
	      umes known/unknown to the kernel.

	      If clustered locking is enabled, add 'e' to activate/deactivate
	      exclusively on one node or 'l' to activate/deactivate  only  on
	      the local node.  Logical volumes with single-host snapshots are
	      always activated exclusively because they can only be  used  on
	      one node at once.

       -l, --logicalvolume MaxLogicalVolumes
	      Changes  the maximum logical volume number of an existing inac-
	      tive volume group.

       -s, --physicalextentsize PhysicalExtentSize[kKmMgGtT]
	      Changes the physical extent size on physical  volumes  of	 this
	      volume  group.  A size suffix (k for kilobytes up to t for ter-
	      abytes) is optional, megabytes is the default if no  suffix  is
	      present.	 The default is 4 MB and it must be at least 1 KB and
	      a power of 2.

	      Before increasing the physical extent size, you might  need  to
	      use  lvresize,  pvresize and/or pvmove so that everything fits.
	      For example, every contiguous range of extents used in a	logi-
	      cal volume must start and end on an extent boundary.

	      If the volume group metadata uses lvm1 format, extents can vary
	      in size from 8KB to 16GB and there is a limit of 65534  extents
	      in each logical volume.  The default of 4 MB leads to a maximum
	      logical volume size of around 256GB.

	      If  the  volume  group  metadata	 uses	lvm2   format	those
	      restrictions do not apply, but having a large number of extents
	      will slow down the tools but have no impact on I/O  performance
	      to the logical volume.  The smallest PE is 1KB.

	      The 2.4 kernel has a limitation of 2TB per block device.

       -x, --resizeable{y|n}
	      Enables  or  disables  the  extension/reduction  of this volume
	      group with/by physical volumes.

EXAMPLES
       To activate all known volume groups in the system:

	    vgchange -a y

       To change the maximum number of logical	volumes	 of  inactive  volume
       group vg00 to 128.

	    vgchange -l 128 /dev/vg00


SEE ALSO
       lvchange(8), lvm(8), vgcreate(8)



Sistina Software UK		  LVM TOOLS			  VGCHANGE(8)

UNIX/Linux commands referenced on this page:

1. more
2. groups
3. lvm
4. vgcfgbackup
5. at
6. size
7. lvresize
8. pvresize
9. pvmove
10. cal