contrib/lvm2/dist/man/vgimportclone.8.in

   1 .TH VGIMPORTCLONE 8 "LVM TOOLS #VERSION#" "Red Hat, Inc." \" -*- nroff -*-
   2 .SH NAME
   3 vgimportclone \- import and rename duplicated volume group (e.g. a hardware snapshot)
   4 .SH SYNOPSIS
   5 .B vgimportclone
   6 [\-n|\-\-basevgname VolumeGroupName]
   7 [\-i|\-\-import]
   8 PhysicalVolume [PhysicalVolume...]
   9 .SH DESCRIPTION
  10 .B vgimportclone
  11 is used to import a duplicated VG (e.g. hardware snapshot).  Duplicate VG(s)
  12 and PV(s) are not able to be used until they are made to coexist with
  13 the origin VG(s) and PV(s).
  14 .B vgimportclone
  15 renames the VG associated with the specified PV(s) and changes the
  16 associated VG and PV UUIDs.
  17 .SH OPTIONS
  18 See \fBlvm\fP for common options.
  19 .TP
  20 .I \-n|\-\-basevgname VolumeGroupName
  21 By default the snapshot VG will be renamed to the original name plus a
  22 numeric suffix to avoid duplicate naming (e.g. 'test_vg' would be renamed
  23 to 'test_vg1').  This option will override the base VG name that is
  24 used for all VG renames.  If a VG already exists with the specified name
  25 a numeric suffix will be added (like the previous example) to make it unique.
  26 .TP
  27 .I \-i|\-\-import
  28 Import exported Volume Groups.  Otherwise VGs that have been exported
  29 will not be changed (nor will their associated PVs).
  30 .SH ENVIRONMENT VARIABLES
  31 .TP
  32 \fBLVM_BINARY\fP
  33 The LVM2 binary to use.
  34 Defaults to "lvm".
  35 .SH EXAMPLES
  36 If origin VG
  37 .B test_vg
  38 has PVs
  39 .BR /dev/loop0 " and " /dev/loop1
  40 and
  41 .BR /dev/loop2 " and " /dev/loop3
  42 are respective snapshot PVs of the origin PVs.
  43 To rename the VG
  44 associated with
  45 .BR /dev/loop2 " and " /dev/loop3
  46 from
  47 .B test_vg
  48 to
  49 .B test_vg_snap
  50 (and change associated VG and PV UUIDs):
  51 .nf
  52
  53 \       vgimportclone --basevgname test_vg_snap /dev/loop2 /dev/loop3
  54
  55 .fi
  56 .SH SEE ALSO
  57 .BR lvm (8)
  58