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