vgimportclone(8)

1VGIMPORTCLONE(8)            System Manager's Manual           VGIMPORTCLONE(8)
2
3
4

NAME

6       vgimportclone - Import a VG from cloned PVs
7

SYNOPSIS

9       vgimportclone position_args
10           [ option_args ]
11

DESCRIPTION

13       vgimportclone imports a VG from duplicated PVs, e.g. created by a hard‐
14       ware snapshot of existing PVs.
15
16       A duplicated VG cannot used until it is made to coexist with the origi‐
17       nal  VG. vgimportclone renames the VG associated with the specified PVs
18       and changes the associated VG and PV UUIDs.
19

USAGE

21       vgimportclone PV ...
22           [ -n|--basevgname VG ]
23           [ -i|--import ]
24           [ COMMON_OPTIONS ]
25
26       Common options for lvm:
27           [ -d|--debug ]
28           [ -h|--help ]
29           [ -q|--quiet ]
30           [ -t|--test ]
31           [ -v|--verbose ]
32           [ -y|--yes ]
33           [    --commandprofile String ]
34           [    --config String ]
35           [    --driverloaded y|n ]
36           [    --lockopt String ]
37           [    --longhelp ]
38           [    --nolocking ]
39           [    --profile String ]
40           [    --version ]
41

OPTIONS

43       -n|--basevgname String
44              By default the snapshot VG will be renamed to the original name
45              plus a numeric suffix to avoid duplicate naming (e.g. 'test_vg'
46              would be renamed to 'test_vg1'). This option will override the
47              base VG name that is used for all VG renames. If a VG already
48              exists with the specified name a numeric suffix will be added
49              (like the previous example) to make it unique.
50
51       --commandprofile String
52              The command profile to use for command configuration.  See
53              lvm.conf(5) for more information about profiles.
54
55       --config String
56              Config settings for the command. These override lvm.conf set‐
57              tings.  The String arg uses the same format as lvm.conf, or may
58              use section/field syntax.  See lvm.conf(5) for more information
59              about config.
60
61       -d|--debug ...
62              Set debug level. Repeat from 1 to 6 times to increase the detail
63              of messages sent to the log file and/or syslog (if configured).
64
65       --driverloaded y|n
66              If set to no, the command will not attempt to use device-mapper.
67              For testing and debugging.
68
69       -h|--help
70              Display help text.
71
72       -i|--import
73              Import exported VGs. Otherwise VGs that have been exported will
74              not be changed (nor will their associated PVs).
75
76       --lockopt String
77              Used to pass options for special cases to lvmlockd.  See lvm‐
78              lockd(8) for more information.
79
80       --longhelp
81              Display long help text.
82
83       --nolocking
84              Disable locking.
85
86       --profile String
87              An alias for --commandprofile or --metadataprofile, depending on
88              the command.
89
90       -q|--quiet ...
91              Suppress output and log messages. Overrides --debug and --ver‐
92              bose.  Repeat once to also suppress any prompts with answer
93              'no'.
94
95       -t|--test
96              Run in test mode. Commands will not update metadata.  This is
97              implemented by disabling all metadata writing but nevertheless
98              returning success to the calling function. This may lead to un‐
99              usual error messages in multi-stage operations if a tool relies
100              on reading back metadata it believes has changed but hasn't.
101
102       -v|--verbose ...
103              Set verbose level. Repeat from 1 to 4 times to increase the de‐
104              tail of messages sent to stdout and stderr.
105
106       --version
107              Display version information.
108
109       -y|--yes
110              Do not prompt for confirmation interactively but always assume
111              the answer yes. Use with extreme caution.  (For automatic no,
112              see -qq.)
113

VARIABLES

115       PV
116              Physical  Volume  name,  a device path under /dev.  For commands
117              managing physical extents, a PV positional arg generally accepts
118              a suffix indicating a range (or multiple ranges) of physical ex‐
119              tents (PEs). When the first PE is omitted, it  defaults  to  the
120              start of the device, and when the last PE is omitted it defaults
121              to end.  Start and end range (inclusive):  PV[:PE-PE]...   Start
122              and length range (counting from 0): PV[:PE+PE]...
123
124       String
125              See the option description for information about the string con‐
126              tent.
127
128       Size[UNIT]
129              Size is an input number that accepts an  optional  unit.   Input
130              units are always treated as base two values, regardless of capi‐
131              talization, e.g. 'k' and 'K' both refer to  1024.   The  default
132              input unit is specified by letter, followed by |UNIT.  UNIT rep‐
133              resents other possible input units:  bBsSkKmMgGtTpPeE.   b|B  is
134              bytes,  s|S is sectors of 512 bytes, k|K is KiB, m|M is MiB, g|G
135              is GiB, t|T is TiB, p|P is PiB, e|E is EiB.  (This should not be
136              confused  with the output control --units, where capital letters
137              mean multiple of 1000.)
138

ENVIRONMENT VARIABLES

140       See lvm(8) for information about environment  variables  used  by  lvm.
141       For example, LVM_VG_NAME can generally be substituted for a required VG
142       parameter.
143

EXAMPLES

145       An original VG "vg00" has PVs "/dev/sda" and  "/dev/sdb".   The  corre‐
146       sponding  PVs  from  a hardware snapshot are "/dev/sdc" and "/dev/sdd".
147       Rename the VG associated with "/dev/sdc" and "/dev/sdd" from "vg00"  to
148       "vg00_snap" (and change associated UUIDs).
149       vgimportclone --basevgname vg00_snap /dev/sdc /dev/sdd
150