2002-01-04 23:35:19 +03:00
.TH VGCHANGE 8 "LVM TOOLS" "Sistina Software UK" \" -*- nroff -*-
.SH NAME
vgchange \- change attributes of a volume group
.SH SYNOPSIS
.B vgchange
2004-11-16 21:09:32 +03:00
.RB [ \- \- addtag
2004-03-22 18:08:50 +03:00
.IR Tag ]
2004-11-16 21:09:32 +03:00
.RB [ \- \- alloc
.IR AllocationPolicy ]
.RB [ \- A | \- \- autobackup " {" y | n }]
.RB [ \- a | \- \- available " [e|l] {" y | n }]
.RB [ \- d | \- \- debug]
.RB [ \- \- deltag
2004-03-22 18:08:50 +03:00
.IR Tag ]
2004-11-16 21:09:32 +03:00
.RB [ \- h | \- \- help]
.RB [ \- \- ignorelockingfailure]
.RB [ \- l | \- \- logicalvolume
2002-01-04 23:35:19 +03:00
.IR MaxLogicalVolumes ]
2004-11-16 21:09:32 +03:00
.RB [ \- P | \- \- partial]
.RB [ -t | \- \- test]
.RB [ \- v | \- \- verbose]
.RB [ \- \- version ]
.RB [ \- x | \- \- resizeable " {" y | n }]
2002-01-04 23:35:19 +03:00
.RI [ VolumeGroupName ...]
.SH DESCRIPTION
.B vgchange
allows you to change the attributes of one or more volume groups.
Its main purpose is to activate and deactivate
.IR VolumeGroupName ,
or all volume groups if none is specified. Only active volume groups
are subject to changes and allow access to their logical volumes.
2002-11-18 17:04:08 +03:00
[Not yet implemented: During volume group activation, if
2002-01-04 23:35:19 +03:00
.B 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
.BR lvremove (8)).
2002-11-18 17:04:08 +03:00
]
2002-01-04 23:35:19 +03:00
.SH OPTIONS
See \fB lvm\fP for common options.
.TP
.BR \- A ", " \- \- autobackup { y | n }
Controls automatic backup of metadata after the change. See
.B vgcfgbackup (8).
Default is yes.
.TP
2004-11-12 18:59:09 +03:00
.BR \- 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 volumes known/unknown to the kernel.
.IP
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.
2002-01-04 23:35:19 +03:00
.TP
.BR \- l ", " \- \- logicalvolume " " \fI MaxLogicalVolumes\fR
Changes the maximum logical volume number of an existing inactive
volume group.
.TP
2002-01-10 18:09:51 +03:00
.BR \- x ", " \- \- resizeable { y | n }
2002-01-04 23:35:19 +03:00
Enables or disables the extension/reduction of this volume group
with/by physical volumes.
.SH EXAMPLES
To activate all known volume groups in the system:
.nf
\ vgchange -a y
.fi
To change the maximum number of logical volumes of inactive volume group
.B vg00
to 128.
.nf
\ vgchange -l 128 /dev/vg00
.fi
.SH SEE ALSO
2004-11-12 18:59:09 +03:00
.BR lvchange (8),
2002-01-04 23:35:19 +03:00
.BR lvm (8),
.BR vgcreate (8)