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 .RB [ \-n | \-\-basevgname
   7 .IR VolumeGroupName ]
   8 .RB [ \-i | \-\-import ]
   9 .I PhysicalVolume
  10 .RI [ PhysicalVolume ...]
  11 .SH DESCRIPTION
  12 vgimportclone is used to import a duplicated VG (e.g. hardware snapshot).
  13 Duplicate VG(s) and PV(s) are not able to be used until they are made
  14 to coexist with the origin VG(s) and PV(s).
  15 vgimportclone renames the VG associated with the specified PV(s) and
  16 changes the associated VG and PV UUIDs.
  17 .SH OPTIONS
  18 See \fBlvm\fP(8) for common options.
  19 .TP
  20 .BR \-n ", " \-\-basevgname " " \fIVolumeGroupName
  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 .BR \-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 .B LVM_BINARY
  33 The LVM2 binary to use. Defaults to "lvm".
  34 .SH Examples
  35 The origin VG "vg00" has origin PVs "/dev/sda" and "/dev/sdb"
  36 and the respective snapshot PVs are "/dev/sdc" and "/dev/sdd".
  37 To rename the VG associated with "/dev/sdc" and "/dev/sdd"
  38 from "vg00" to "vg00_snap"
  39 (and to change associated VG and PV UUIDs) do:
  40 .sp
  41 .B vgimportclone --basevgname vg00_snap /dev/sdc /dev/sdd
  42
  43 .SH SEE ALSO
  44 .BR lvm (8),
  45 .BR vgrename (8)
  46