external/gpl2/lvm2/dist/man/vgconvert.8.in

   1 .TH VGCONVERT 8 "LVM TOOLS #VERSION#" "Sistina Software UK" \" -*- nroff -*-
   2 .SH NAME
   3 vgconvert \- convert volume group metadata format
   4 .SH SYNOPSIS
   5 .B vgconvert
   6 .RB [ \-d | \-\-debug ]
   7 .RB [ \-h | \-\-help ]
   8 .RB [ \-t | \-\-test ]
   9 .RB [ \-v | \-\-verbose ]
  10 .RB [ \-\-labelsector ]
  11 .RB [ \-M | \-\-metadatatype type ]
  12 .RB [ \-\-pvmetadatacopies #copies ]
  13 .RB [ \-\-metadatasize size ]
  14 .RB [ \-\-version ]
  15 .IR VolumeGroupName " [" VolumeGroupName ...]
  16 .SH DESCRIPTION
  17 .B vgconvert
  18 converts
  19 .I VolumeGroupName
  20 metadata from one format to another provided that the metadata
  21 fits into the same space.
  22 .SH OPTIONS
  23 See \fBlvm\fP(8) and \fBpvcreate\fP(8) for options.
  24 .SH EXAMPLE
  25 Convert volume group vg1 from LVM1 metadata format to the new LVM2
  26 metadata format.
  27 .sp
  28 .B vgconvert -M2 vg1
  29 .SH RECOVERY
  30 Use \fBpvscan\fP(8) to see which PVs lost their metadata.
  31 Run \fBpvcreate\fP(8) with the --uuid and --restorefile options on each
  32 such PV to reformat it as it was, using the archive file that
  33 \fBvgconvert\fP(8) created at the start of the procedure.
  34 Finally run \fBvgcfgrestore\fP(8) with that archive file to restore
  35 the original metadata.
  36 .SH SEE ALSO
  37 .BR lvm (8),
  38 .BR pvcreate (8),
  39 .BR vgcfgrestore (8)