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
99              unusual error messages in multi-stage operations if a tool
100              relies on reading back metadata it believes has changed but
101              hasn't.
102
103       -v|--verbose ...
104              Set verbose level. Repeat from 1 to 4 times to increase the
105              detail of messages sent to stdout and stderr.
106
107       --version
108              Display version information.
109
110       -y|--yes
111              Do not prompt for confirmation interactively but always assume
112              the answer yes. Use with extreme caution.  (For automatic no,
113              see -qq.)
114

VARIABLES

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

ENVIRONMENT VARIABLES

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

EXAMPLES

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