contrib/lvm2/dist/man/vgconvert.8

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