mirror of
git://sourceware.org/git/lvm2.git
synced 2024-10-27 10:25:13 +03:00
0ddb66efba
Going forward, we would like to allow users to specify the total number of metadatacopies in a VG rather than on a per-PV basis. In order to facilitate that, introduce --pvmetadatacopes to replace --metadatacopies everywhere. We still allow --metadatacopies for pv commands, but require --pvmetadatacopies for vg commands. Eventually we will introduce --vgmetadatacopies. Once we do that, we should either deprecate --metadatacopies or make it a synonym based on the command (pvmetadatacopies for pv commands, and vgmetadatacopies for vg commands). The latter option would likely just require a simple 'strncpy' check against cmd->command->name to qualify the merge_synonym call. Update nightly tests to cover the pvmetadatacopies synonym. Note that this patch is the result of an eariler review comment for the implicit pvcreate patches. Should apply cleanly on top of the implicit pvcreate patches (I applied after patch 10/10 in that series). NOTE: This patch will require --pvmetadatacopies for vgconvert as --metadatacopies is no longer accepted.
40 lines
1.2 KiB
Groff
40 lines
1.2 KiB
Groff
.TH VGCONVERT 8 "LVM TOOLS #VERSION#" "Sistina Software UK" \" -*- nroff -*-
|
|
.SH NAME
|
|
vgconvert \- convert volume group metadata format
|
|
.SH SYNOPSIS
|
|
.B vgconvert
|
|
.RB [ \-d | \-\-debug ]
|
|
.RB [ \-h | \-\-help ]
|
|
.RB [ \-t | \-\-test ]
|
|
.RB [ \-v | \-\-verbose ]
|
|
.RB [ \-\-labelsector ]
|
|
.RB [ \-M | \-\-metadatatype type ]
|
|
.RB [ \-\-pvmetadatacopies #copies ]
|
|
.RB [ \-\-metadatasize size ]
|
|
.RB [ \-\-version ]
|
|
.IR VolumeGroupName " [" VolumeGroupName ...]
|
|
.SH DESCRIPTION
|
|
.B 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 EXAMPLE
|
|
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 --uuid and --restorefile 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)
|