contrib/lvm2/dist/man/vgimportclone.8

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