man/vgextend.8.in

   1 .TH VGEXTEND 8 "LVM TOOLS #VERSION#" "Sistina Software UK" \" -*- nroff -*-
   2 .SH NAME
   3 vgextend \- add physical volumes to a volume group
   4 .SH SYNOPSIS
   5 .B vgextend
   6 [\-A|\-\-autobackup y|n] [\-d|\-\-debug] [\-h|\-?|\-\-help]
   7 [\-\-restoremissing]
   8 [\-f|\-\-force]
   9 [\-t|\-\-test]
  10 [\-v|\-\-verbose]
  11 [ \fIPHYSICAL DEVICE OPTIONS\fP ]
  12 VolumeGroupName PhysicalDevicePath [PhysicalDevicePath...]
  13 .SH DESCRIPTION
  14 vgextend allows you to add one or more initialized physical volumes ( see
  15 .B pvcreate(8)
  16 ) to an existing volume group to extend it in size. Moreover, it allows you to
  17 re-add a physical volume that has gone missing previously, due to a transient
  18 device failure, without re-initialising it. Use vgextend \-\-restoremissing to
  19 that effect.
  20 .sp
  21 If \fIPhysicalDevicePath\fP was not previously configured for LVM with
  22 \fBpvcreate (8)\fP, the device will be initialized with the same
  23 default values used with \fBpvcreate\fP.  If non-default
  24 \fPpvcreate\fP values are are desired, they may be given on the
  25 commandline with the same options as \fPpvcreate\fP.  See
  26 \fBPHYSICAL DEVICE OPTIONS\fP for available options.  Note
  27 that the restore-related options such as --restorefile, --uuid,
  28 and --physicalvolumesize are not available.  If a restore operation
  29 is needed, use \fBpvcreate (8)\fP and \fBvgcfgrestore (8)\fP.
  30 .SH OPTIONS
  31 See \fBlvm\fP for common options.
  32 .SH PHYSICAL DEVICE OPTIONS
  33 The following options are available for initializing physical devices in the
  34 volume group.  These options are further described in the pvcreate man page.
  35 .TP
  36 .BR \-f ", " \-\-force
  37 .TP
  38 .BR \-y ", " \-\-yes
  39 .TP
  40 .BR \-Z ", " \-\-zero " y|n"
  41 .TP
  42 .BR \-\-labelsector " sector"
  43 .TP
  44 .BR \-\-metadatasize " size"
  45 .TP
  46 .RB [ \-\-metadataignore y|n ]
  47 .TP
  48 .BR \-\-pvmetadatacopies " copies"
  49 .TP
  50 .BR \-\-dataalignment " alignment"
  51 .TP
  52 .BR \-\-dataalignmentoffset " alignment_offset"
  53 .SH Examples
  54 "vgextend vg00 /dev/sda4 /dev/sdn1" tries to extend the existing volume
  55 group "vg00" by the new physical volumes (see
  56 .B pvcreate(8)
  57 ) "/dev/sdn1" and /dev/sda4".
  58 .SH SEE ALSO
  59 .BR lvm (8),
  60 .BR vgcreate (8),
  61 .BR vgreduce (8),
  62 .BR pvcreate (8)