| .TH VGEXTEND 8 "LVM TOOLS #VERSION#" "Sistina Software UK" \" -*- nroff -*- |
| .SH NAME |
| vgextend \(em add physical volumes to a volume group |
| .SH SYNOPSIS |
| .B vgextend |
| .RB [ \-A | \-\-autobackup |
| .RI { y | n }] |
| .RB [ \-\-commandprofile |
| .IR ProfileName ] |
| .RB [ \-d | \-\-debug ] |
| .RB [ \-h | \-? | \-\-help ] |
| .RB [ \-\-restoremissing ] |
| .RB [ \-f | \-\-force ] |
| .RB [ \-t | \-\-test ] |
| .RB [ \-v | \-\-verbose ] |
| .RB [ "PHYSICAL DEVICE OPTIONS" ] |
| .I VolumeGroupName PhysicalDevicePath |
| .RI [ PhysicalDevicePath ...] |
| .SH DESCRIPTION |
| vgextend allows you to add one or more initialized physical volumes |
| (see \fBpvcreate\fP(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 |
| \fBvgextend \-\-restoremissing\fP to that effect. |
| .sp |
| If \fIPhysicalDevicePath\fP was not previously configured for LVM with |
| \fBpvcreate\fP(8), the device will be initialized with the same |
| default values used with \fBpvcreate\fP(8). If non-default |
| \fPpvcreate\fP(8) values are desired, they may be given on the |
| commandline with the same options as \fPpvcreate\fP(8). See |
| .B PHYSICAL DEVICE OPTIONS |
| for available options. Note that the restore-related options such as |
| .BR \-\-restorefile ", " \-\-uuid " and " \-\-physicalvolumesize |
| are not available. If a restore operation |
| is needed, use \fBpvcreate\fP(8) and \fBvgcfgrestore\fP(8). |
| .SH OPTIONS |
| See \fBlvm\fP(8) 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 |
| \fBpvcreate\fP(8) man page. |
| .TP |
| .BR \-f ", " \-\-force |
| .TP |
| .BR \-y ", " \-\-yes |
| .TP |
| .BR \-Z ", " \-\-zero " {" \fIy | \fIn } |
| .TP |
| .B \-\-labelsector \fIsector |
| .TP |
| .B \-\-metadatasize \fIsize |
| .TP |
| .BR \-\-metadataignore " {" \fIy | \fIn } |
| .TP |
| .B \-\-pvmetadatacopies \fIcopies |
| .TP |
| .B \-\-dataalignment \fIalignment |
| .TP |
| .B \-\-dataalignmentoffset \fIalignment_offset |
| .SH Examples |
| Extends the existing volume group "vg00" by the new physical volumes |
| (see \fBpvcreate\fP(8)) "/dev/sda4" and "/dev/sdn1". |
| .sp |
| .B vgextend vg00 /dev/sda4 /dev/sdn1 |
| .SH SEE ALSO |
| .BR lvm (8), |
| .BR vgcreate (8), |
| .BR vgreduce (8), |
| .BR pvcreate (8) |
