| .TH VGCONVERT 8 "LVM TOOLS #VERSION#" "Sistina Software UK" \" -*- nroff -*- |
| .SH NAME |
| vgconvert \- convert volume group metadata format |
| .SH SYNOPSIS |
| .B vgconvert |
| .RB [ \-\-commandprofile |
| .IR ProfileName ] |
| .RB [ \-d | \-\-debug ] |
| .RB [ \-h | \-\-help ] |
| .RB [ \-t | \-\-test ] |
| .RB [ \-v | \-\-verbose ] |
| .RB [ \-\-labelsector ] |
| .RB [ \-\-bootloaderareasize |
| .IR size ] |
| .RB [ \-M | \-\-metadatatype |
| .IR type ] |
| .RB [ \-\-pvmetadatacopies |
| .IR NumberOfCopies ] |
| .RB [ \-\-metadatasize |
| .IR size ] |
| .RB [ \-\-reportformat |
| .RB { basic | json }] |
| .RB [ \-\-version ] |
| .I VolumeGroupName |
| .RI [ VolumeGroupName ...] |
| .SH DESCRIPTION |
| vgconvert converts |
| .I VolumeGroupName |
| metadata from one format to another provided that the metadata |
| fits into the same space. |
| .SH OPTIONS |
| See \fBlvm\fP(8) and \fBpvcreate\fP(8) for options. |
| .SH Examples |
| Convert volume group vg1 from LVM1 metadata format to the new LVM2 |
| metadata format. |
| .sp |
| .B vgconvert \-M2 vg1 |
| .SH RECOVERY |
| Use \fBpvscan\fP(8) to see which PVs lost their metadata. |
| Run \fBpvcreate\fP(8) with the \fB\-\-uuid\fP and \fB\-\-restorefile\fP |
| options on each such PV to reformat it as it was, using the archive |
| file that \fBvgconvert\fP(8) created at the start of the procedure. |
| Finally run \fBvgcfgrestore\fP(8) with that archive file to restore |
| the original metadata. |
| .SH SEE ALSO |
| .BR lvm (8), |
| .BR pvcreate (8), |
| .BR vgcfgrestore (8) |
