Tizen 2.1 base
[external/device-mapper.git] / man / vgcfgrestore.8.in
1 .TH VGCFGRESTORE 8 "LVM TOOLS #VERSION#" "Sistina Software UK" \" -*- nroff -*-
2 .SH NAME
3 vgcfgrestore \- restore volume group descriptor area
4 .SH SYNOPSIS
5 .B vgcfgrestore
6 .RB [ \-d | \-\-debug ]
7 .RB [ \-f | \-\-file " filename" ]
8 .RB [ \-l[l] | \-\-list ]
9 .RB [ \-h | \-\-help ]
10 .RB [ \-M | \-\-Metadatatype 1|2]
11 .RB [ \-t | \-\-test ]
12 .RB [ \-v | \-\-verbose ]
13 .RI \fIVolumeGroupName\fP
14 .SH DESCRIPTION
15 .B vgcfgrestore
16 allows you to restore the metadata of \fIVolumeGroupName\fP from a text 
17 backup file produced by \fBvgcfgbackup\fP.  You can specify a backup file 
18 with \fP--file\fP.  If no backup file is specified, the most recent
19 one is used.  Use \fB--list\fP for a list of the available
20 backup and archive files of \fIVolumeGroupName\fP.
21 .SH OPTIONS
22 .TP
23 \fB-l | --list\fP \(em List files pertaining to \fIVolumeGroupName\fP
24 List metadata backup and archive files pertaining to \fIVolumeGroupName\fP.
25 May be used with the \fB-f\fP option.  Does not restore \fIVolumeGroupName\fP.
26 .TP
27 \fB-f | --file\fP filename \(em Name of LVM metadata backup file
28 Specifies a metadata backup or archive file to be used for restoring 
29 VolumeGroupName.  Often this file has been created with \fBvgcfgbackup\fP.
30 .TP
31 See \fBlvm\fP for common options.
32 .SH REPLACING PHYSICAL VOLUMES
33 \fBvgdisplay --partial --verbose\fP will show you the UUIDs and sizes of
34 any PVs that are no longer present.
35 If a PV in the VG is lost and you wish to substitute 
36 another of the same size, use 
37 \fBpvcreate --restorefile filename --uuid uuid\fP (plus additional 
38 arguments as appropriate) to initialise it with the same UUID as 
39 the missing PV.  Repeat for all other missing PVs in the VG. 
40 Then use \fBvgcfgrestore --file filename\fP to restore the volume
41 group's metadata.
42 .SH SEE ALSO
43 .BR lvm (8),
44 .BR vgcreate (8)