lvm2/man/vgextend.8.in

.TH VGEXTEND 8 "LVM TOOLS #VERSION#" "Sistina Software UK" \" -*- nroff -*-
.SH NAME
vgextend \- add physical volumes to a volume group
.SH SYNOPSIS
.B vgextend
[\-A|\-\-autobackup y|n] [\-d|\-\-debug] [\-h|\-?|\-\-help] 
[\-\-restoremissing]
[\-f|\-\-force]
[\-t|\-\-test]
[\-v|\-\-verbose]
[ \fIPHYSICAL DEVICE OPTIONS\fP ]
VolumeGroupName PhysicalDevicePath [PhysicalDevicePath...]
.SH DESCRIPTION
vgextend allows you to add one or more initialized physical volumes ( see
.B pvcreate(8)
) to an existing volume group to extend it in size. Moreover, it allows you to
re-add a physical volume that has gone missing previously, due to a transient
device failure, without re-initialising it. Use vgextend \-\-restoremissing to
that effect.
.sp
If \fIPhysicalDevicePath\fP was not previously configured for LVM with
\fBpvcreate (8)\fP, the device will be initialized with the same
default values used with \fBpvcreate\fP.  If non-default
\fPpvcreate\fP values are are desired, they may be given on the
commandline with the same options as \fPpvcreate\fP.  See
\fBPHYSICAL DEVICE OPTIONS\fP for available options.  Note
that the restore-related options such as --restorefile, --uuid,
and --physicalvolumesize are not available.  If a restore operation
is needed, use \fBpvcreate (8)\fP and \fBvgcfgrestore (8)\fP.
.SH OPTIONS
See \fBlvm\fP for common options.
.SH PHYSICAL DEVICE OPTIONS
The following options are available for initializing physical devices in the
volume group.  These options are further described in the pvcreate man page.
.TP
.BR \-f ", " \-\-force
.TP
.BR \-y ", " \-\-yes
.TP
.BR \-Z ", " \-\-zero " y|n"
.TP
.BR \-\-labelsector " sector"
.TP
.BR \-\-metadatasize " size"
.TP
.RB [ \-\-metadataignore y|n ]
.TP
.BR \-\-pvmetadatacopies " copies"
.TP
.BR \-\-dataalignment " alignment"
.TP
.BR \-\-dataalignmentoffset " alignment_offset"
.SH Examples
"vgextend vg00 /dev/sda4 /dev/sdn1" tries to extend the existing volume
group "vg00" by the new physical volumes (see
.B pvcreate(8)
) "/dev/sdn1" and /dev/sda4".
.SH SEE ALSO
.BR lvm (8),
.BR vgcreate (8),
.BR vgreduce (8),
.BR pvcreate (8)
Generate man pages from templates and include version. (romster) 2008-10-08 16:50:13 +04:00			`.TH VGEXTEND 8 "LVM TOOLS #VERSION#" "Sistina Software UK" \" -- nroff --`
Imported man pages from LVM1 with some quick LVM2 updates. 2002-01-04 23:35:19 +03:00			`.SH NAME`
			`vgextend \- add physical volumes to a volume group`
			`.SH SYNOPSIS`
			`.B vgextend`
Make man pages consistent with either-or options (use "\|" everywhere). 2008-11-12 18:01:35 +03:00			`[\-A\|\-\-autobackup y\|n] [\-d\|\-\-debug] [\-h\|\-?\|\-\-help]`
Implement vgextend --restoremissing (BZ 537913), which makes it possible to re-add a physical volume that has gone missing previously, due to a transient device failure, without re-initialising it. Signed-off-by: Petr Rockai <prockai@redhat.com> Reviewed-by: Alasdair Kergon <agk@redhat.com> 2010-10-13 14:34:31 +04:00			`[\-\-restoremissing]`
Add --force to pvchange, and allow override of prompt involving metadataignore. Signed-off-by: Dave Wysochanski <dwysocha@redhat.com> 2010-07-07 23:14:57 +04:00			`[\-f\|\-\-force]`
Make man pages consistent with either-or options (use "\|" everywhere). 2008-11-12 18:01:35 +03:00			`[\-t\|\-\-test]`
			`[\-v\|\-\-verbose]`
Minor fix to vgcreate/vgextend man pages for PHYSICAL DEVICE OPTIONS. 2009-10-26 05:36:29 +03:00			`[ \fIPHYSICAL DEVICE OPTIONS\fP ]`
Imported man pages from LVM1 with some quick LVM2 updates. 2002-01-04 23:35:19 +03:00			`VolumeGroupName PhysicalDevicePath [PhysicalDevicePath...]`
			`.SH DESCRIPTION`
			`vgextend allows you to add one or more initialized physical volumes ( see`
			`.B pvcreate(8)`
Implement vgextend --restoremissing (BZ 537913), which makes it possible to re-add a physical volume that has gone missing previously, due to a transient device failure, without re-initialising it. Signed-off-by: Petr Rockai <prockai@redhat.com> Reviewed-by: Alasdair Kergon <agk@redhat.com> 2010-10-13 14:34:31 +04:00			`) to an existing volume group to extend it in size. Moreover, it allows you to`
			`re-add a physical volume that has gone missing previously, due to a transient`
			`device failure, without re-initialising it. Use vgextend \-\-restoremissing to`
			`that effect.`
Update vgcreate and vgextend man pages to clarify implicit pvcreate. vgcreate and vgextend now implicitly call pvcreate on devices not currently initialized for LVM use. Previously these commands would fail with an error, so clarify the new behavior in the man page. 2009-10-06 00:04:21 +04:00			`.sp`
			`If \fIPhysicalDevicePath\fP was not previously configured for LVM with`
			`\fBpvcreate (8)\fP, the device will be initialized with the same`
			`default values used with \fBpvcreate\fP. If non-default`
			`\fPpvcreate\fP values are are desired, they may be given on the`
			`commandline with the same options as \fPpvcreate\fP. See`
			`\fBPHYSICAL DEVICE OPTIONS\fP for available options. Note`
			`that the restore-related options such as --restorefile, --uuid,`
			`and --physicalvolumesize are not available. If a restore operation`
			`is needed, use \fBpvcreate (8)\fP and \fBvgcfgrestore (8)\fP.`
Imported man pages from LVM1 with some quick LVM2 updates. 2002-01-04 23:35:19 +03:00			`.SH OPTIONS`
			`See \fBlvm\fP for common options.`
Update vgcreate and vgextend man pages to clarify implicit pvcreate. vgcreate and vgextend now implicitly call pvcreate on devices not currently initialized for LVM use. Previously these commands would fail with an error, so clarify the new behavior in the man page. 2009-10-06 00:04:21 +04:00			`.SH PHYSICAL DEVICE OPTIONS`
			`The following options are available for initializing physical devices in the`
			`volume group. These options are further described in the pvcreate man page.`
			`.TP`
			`.BR \-f ", " \-\-force`
			`.TP`
			`.BR \-y ", " \-\-yes`
			`.TP`
			`.BR \-Z ", " \-\-zero " y\|n"`
			`.TP`
			`.BR \-\-labelsector " sector"`
			`.TP`
			`.BR \-\-metadatasize " size"`
			`.TP`
Add --metadataignore to vgextend and man pages. 2010-06-30 17:03:48 +04:00			`.RB [ \-\-metadataignore y\|n ]`
			`.TP`
Add --pvmetadatacopies as a synonym for --metadatacopies in various commands. Going forward, we would like to allow users to specify the total number of metadatacopies in a VG rather than on a per-PV basis. In order to facilitate that, introduce --pvmetadatacopes to replace --metadatacopies everywhere. We still allow --metadatacopies for pv commands, but require --pvmetadatacopies for vg commands. Eventually we will introduce --vgmetadatacopies. Once we do that, we should either deprecate --metadatacopies or make it a synonym based on the command (pvmetadatacopies for pv commands, and vgmetadatacopies for vg commands). The latter option would likely just require a simple 'strncpy' check against cmd->command->name to qualify the merge_synonym call. Update nightly tests to cover the pvmetadatacopies synonym. Note that this patch is the result of an eariler review comment for the implicit pvcreate patches. Should apply cleanly on top of the implicit pvcreate patches (I applied after patch 10/10 in that series). NOTE: This patch will require --pvmetadatacopies for vgconvert as --metadatacopies is no longer accepted. 2009-10-06 00:55:56 +04:00			`.BR \-\-pvmetadatacopies " copies"`
Update vgcreate and vgextend man pages to clarify implicit pvcreate. vgcreate and vgextend now implicitly call pvcreate on devices not currently initialized for LVM use. Previously these commands would fail with an error, so clarify the new behavior in the man page. 2009-10-06 00:04:21 +04:00			`.TP`
			`.BR \-\-dataalignment " alignment"`
			`.TP`
			`.BR \-\-dataalignmentoffset " alignment_offset"`
Imported man pages from LVM1 with some quick LVM2 updates. 2002-01-04 23:35:19 +03:00			`.SH Examples`
			`"vgextend vg00 /dev/sda4 /dev/sdn1" tries to extend the existing volume`
			`group "vg00" by the new physical volumes (see`
			`.B pvcreate(8)`
			`) "/dev/sdn1" and /dev/sda4".`
			`.SH SEE ALSO`
Generate man pages from templates and include version. (romster) 2008-10-08 16:50:13 +04:00			`.BR lvm (8),`
			`.BR vgcreate (8),`
			`.BR vgreduce (8),`
Imported man pages from LVM1 with some quick LVM2 updates. 2002-01-04 23:35:19 +03:00			`.BR pvcreate (8)`