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           [    --importdevices ]
25           [ COMMON_OPTIONS ]
26
27       Common options for lvm:
28           [ -d|--debug ]
29           [ -h|--help ]
30           [ -q|--quiet ]
31           [ -t|--test ]
32           [ -v|--verbose ]
33           [ -y|--yes ]
34           [    --commandprofile String ]
35           [    --config String ]
36           [    --devices PV ]
37           [    --devicesfile String ]
38           [    --driverloaded y|n ]
39           [    --journal String ]
40           [    --lockopt String ]
41           [    --longhelp ]
42           [    --nohints ]
43           [    --nolocking ]
44           [    --profile String ]
45           [    --version ]
46

OPTIONS

48       -n|--basevgname String
49              By default the snapshot VG will be renamed to the original  name
50              plus  a numeric suffix to avoid duplicate naming (e.g. 'test_vg'
51              would be renamed to 'test_vg1'). This option will  override  the
52              base  VG  name  that is used for all VG renames. If a VG already
53              exists with the specified name a numeric suffix  will  be  added
54              (like the previous example) to make it unique.
55
56       --commandprofile String
57              The  command  profile  to  use  for  command configuration.  See
58              lvm.conf(5) for more information about profiles.
59
60       --config String
61              Config settings for the command. These override lvm.conf(5) set‐
62              tings.   The  String arg uses the same format as lvm.conf(5), or
63              may use section/field syntax.  See lvm.conf(5) for more informa‐
64              tion about config.
65
66       -d|--debug ...
67              Set debug level. Repeat from 1 to 6 times to increase the detail
68              of messages sent to the log file and/or syslog (if configured).
69
70       --devices PV
71              Restricts the devices that are visible  and  accessible  to  the
72              command.  Devices not listed will appear to be missing. This op‐
73              tion can be repeated, or accepts a comma separated list  of  de‐
74              vices. This overrides the devices file.
75
76       --devicesfile String
77              A file listing devices that LVM should use.  The file must exist
78              in /etc/lvm/devices/ and is managed with the lvmdevices(8)  com‐
79              mand.   This  overrides  the lvm.conf(5) devices/devicesfile and
80              devices/use_devicesfile settings.
81
82       --driverloaded y|n
83              If set to no, the command will not attempt to use device-mapper.
84              For testing and debugging.
85
86       -h|--help
87              Display help text.
88
89       -i|--import
90              Import  exported VGs. Otherwise VGs that have been exported will
91              not be changed (nor will their associated PVs).
92
93       --importdevices
94              Add devices to the devices file.
95
96       --journal String
97              Record information in the systemd journal.  This information  is
98              in  addition  to information enabled by the lvm.conf log/journal
99              setting.  command: record information about the  command.   out‐
100              put: record the default command output.  debug: record full com‐
101              mand debugging.
102
103       --lockopt String
104              Used to pass options for special cases to  lvmlockd.   See  lvm‐
105              lockd(8) for more information.
106
107       --longhelp
108              Display long help text.
109
110       --nohints
111              Do  not  use the hints file to locate devices for PVs. A command
112              may read more devices to find PVs when hints are not  used.  The
113              command will still perform standard hint file invalidation where
114              appropriate.
115
116       --nolocking
117              Disable locking. Use with caution, concurrent commands may  pro‐
118              duce incorrect results.
119
120       --profile String
121              An alias for --commandprofile or --metadataprofile, depending on
122              the command.
123
124       -q|--quiet ...
125              Suppress output and log messages. Overrides --debug  and  --ver‐
126              bose.   Repeat  once  to  also  suppress any prompts with answer
127              'no'.
128
129       -t|--test
130              Run in test mode. Commands will not update  metadata.   This  is
131              implemented  by  disabling all metadata writing but nevertheless
132              returning success to the calling function. This may lead to  un‐
133              usual  error messages in multi-stage operations if a tool relies
134              on reading back metadata it believes has changed but hasn't.
135
136       -v|--verbose ...
137              Set verbose level. Repeat from 1 to 4 times to increase the  de‐
138              tail of messages sent to stdout and stderr.
139
140       --version
141              Display version information.
142
143       -y|--yes
144              Do  not  prompt for confirmation interactively but always assume
145              the answer yes. Use with extreme caution.   (For  automatic  no,
146              see -qq.)
147

VARIABLES

149       PV     Physical  Volume  name,  a device path under /dev.  For commands
150              managing physical extents, a PV positional arg generally accepts
151              a suffix indicating a range (or multiple ranges) of physical ex‐
152              tents (PEs). When the first PE is omitted, it  defaults  to  the
153              start of the device, and when the last PE is omitted it defaults
154              to end.  Start and end range (inclusive):  PV[:PE-PE]...   Start
155              and length range (counting from 0): PV[:PE+PE]...
156
157       String See the option description for information about the string con‐
158              tent.
159
160       Size[UNIT]
161              Size is an input number that accepts an  optional  unit.   Input
162              units are always treated as base two values, regardless of capi‐
163              talization, e.g. 'k' and 'K' both refer to  1024.   The  default
164              input unit is specified by letter, followed by |UNIT.  UNIT rep‐
165              resents other possible input units: b|B is bytes, s|S is sectors
166              of  512  bytes,  k|K is KiB, m|M is MiB, g|G is GiB, t|T is TiB,
167              p|P is PiB, e|E is EiB.  (This should not be confused  with  the
168              output  control  --units, where capital letters mean multiple of
169              1000.)
170

ENVIRONMENT VARIABLES

172       See lvm(8) for information about environment  variables  used  by  lvm.
173       For example, LVM_VG_NAME can generally be substituted for a required VG
174       parameter.
175

EXAMPLES

177       An original VG "vg00" has PVs "/dev/sda" and  "/dev/sdb".   The  corre‐
178       sponding  PVs  from  a hardware snapshot are "/dev/sdc" and "/dev/sdd".
179       Rename the VG associated with "/dev/sdc" and "/dev/sdd" from "vg00"  to
180       "vg00_snap" (and change associated UUIDs).
181       vgimportclone --basevgname vg00_snap /dev/sdc /dev/sdd
182