1VGIMPORT(8) System Manager's Manual VGIMPORT(8)
2
6 vgimport — Register exported volume group with system
7
9 vgimport option_args position_args
10 [ option_args ]
11
13 vgimport makes exported VGs known to the system again, perhaps after
14 moving the PVs from a different system.
15 vgexport clears the VG system ID, and vgimport sets the VG system ID to
17 match the host running vgimport (if the host has a system ID).
18
20 Import specified VGs.
21 vgimport VG|Tag|Select ...
23 [ -S|--select String ]
24 [ COMMON_OPTIONS ]
25 Import all VGs.
27 vgimport -a|--all
29 [ COMMON_OPTIONS ]
30 Common options for command:
32 [ -f|--force ]
33 [ --reportformat basic|json|json_std ]
34 Common options for lvm:
36 [ -d|--debug ]
37 [ -h|--help ]
38 [ -q|--quiet ]
39 [ -t|--test ]
40 [ -v|--verbose ]
41 [ -y|--yes ]
42 [ --commandprofile String ]
43 [ --config String ]
44 [ --devices PV ]
45 [ --devicesfile String ]
46 [ --driverloaded y|n ]
47 [ --journal String ]
48 [ --lockopt String ]
49 [ --longhelp ]
50 [ --nohints ]
51 [ --nolocking ]
52 [ --profile String ]
53 [ --version ]
54
56 -a|--all
57 Import all visible VGs.
58 --commandprofile String
60 The command profile to use for command configuration. See
61 lvm.conf(5) for more information about profiles.
62 --config String
64 Config settings for the command. These override lvm.conf(5) set‐
65 tings. The String arg uses the same format as lvm.conf(5), or
66 may use section/field syntax. See lvm.conf(5) for more informa‐
67 tion about config.
68 -d|--debug ...
70 Set debug level. Repeat from 1 to 6 times to increase the detail
71 of messages sent to the log file and/or syslog (if configured).
72 --devices PV
74 Restricts the devices that are visible and accessible to the
75 command. Devices not listed will appear to be missing. This op‐
76 tion can be repeated, or accepts a comma separated list of de‐
77 vices. This overrides the devices file.
78 --devicesfile String
80 A file listing devices that LVM should use. The file must exist
81 in /etc/lvm/devices/ and is managed with the lvmdevices(8) com‐
82 mand. This overrides the lvm.conf(5) devices/devicesfile and
83 devices/use_devicesfile settings.
84 --driverloaded y|n
86 If set to no, the command will not attempt to use device-mapper.
87 For testing and debugging.
88 -f|--force ...
90 Override various checks, confirmations and protections. Use
91 with extreme caution.
92 -h|--help
94 Display help text.
95 --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 --lockopt String
104 Used to pass options for special cases to lvmlockd. See lvm‐
105 lockd(8) for more information.
106 --longhelp
108 Display long help text.
109 --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 --nolocking
117 Disable locking. Use with caution, concurrent commands may pro‐
118 duce incorrect results.
119 --profile String
121 An alias for --commandprofile or --metadataprofile, depending on
122 the command.
123 -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 --reportformat basic|json|json_std
130 Overrides current output format for reports which is defined
131 globally by the report/output_format setting in lvm.conf(5).
132 basic is the original format with columns and rows. If there is
133 more than one report per command, each report is prefixed with
134 the report name for identification. json produces report output
135 in JSON format. json_std produces report output in JSON format
136 which is more compliant with JSON standard. See lvmreport(7)
137 for more information.
138 -S|--select String
140 Select objects for processing and reporting based on specified
141 criteria. The criteria syntax is described by --select help and
142 lvmreport(7). For reporting commands, one row is displayed for
143 each object matching the criteria. See --options help for se‐
144 lectable object fields. Rows can be displayed with an addi‐
145 tional "selected" field (-o selected) showing 1 if the row
146 matches the selection and 0 otherwise. For non-reporting com‐
147 mands which process LVM entities, the selection is used to
148 choose items to process.
149 -t|--test
151 Run in test mode. Commands will not update metadata. This is
152 implemented by disabling all metadata writing but nevertheless
153 returning success to the calling function. This may lead to un‐
154 usual error messages in multi-stage operations if a tool relies
155 on reading back metadata it believes has changed but hasn't.
156 -v|--verbose ...
158 Set verbose level. Repeat from 1 to 4 times to increase the de‐
159 tail of messages sent to stdout and stderr.
160 --version
162 Display version information.
163 -y|--yes
165 Do not prompt for confirmation interactively but always assume
166 the answer yes. Use with extreme caution. (For automatic no,
167 see -qq.)
168
170 VG Volume Group name. See lvm(8) for valid names.
171 Tag Tag name. See lvm(8) for information about tag names and using
173 tags in place of a VG, LV or PV.
174 Select Select indicates that a required positional parameter can be
176 omitted if the --select option is used. No arg appears in this
177 position.
178 String See the option description for information about the string con‐
180 tent.
181 Size[UNIT]
183 Size is an input number that accepts an optional unit. Input
184 units are always treated as base two values, regardless of capi‐
185 talization, e.g. 'k' and 'K' both refer to 1024. The default
186 input unit is specified by letter, followed by |UNIT. UNIT rep‐
187 resents other possible input units: b|B is bytes, s|S is sectors
188 of 512 bytes, k|K is KiB, m|M is MiB, g|G is GiB, t|T is TiB,
189 p|P is PiB, e|E is EiB. (This should not be confused with the
190 output control --units, where capital letters mean multiple of
191 1000.)
192
194 See lvm(8) for information about environment variables used by lvm.
195 For example, LVM_VG_NAME can generally be substituted for a required VG
196 parameter.
197
199 lvm(8), lvm.conf(5), lvmconfig(8), lvmdevices(8),
200 pvchange(8), pvck(8), pvcreate(8), pvdisplay(8), pvmove(8),
202 pvremove(8), pvresize(8), pvs(8), pvscan(8),
203 vgcfgbackup(8), vgcfgrestore(8), vgchange(8), vgck(8), vgcreate(8),
205 vgconvert(8), vgdisplay(8), vgexport(8), vgextend(8), vgimport(8),
206 vgimportclone(8), vgimportdevices(8), vgmerge(8), vgmknodes(8),
207 vgreduce(8), vgremove(8), vgrename(8), vgs(8), vgscan(8), vgsplit(8),
208 lvcreate(8), lvchange(8), lvconvert(8), lvdisplay(8), lvextend(8),
210 lvreduce(8), lvremove(8), lvrename(8), lvresize(8), lvs(8), lvscan(8),
211 lvm-fullreport(8), lvm-lvpoll(8), blkdeactivate(8), lvmdump(8),
213 dmeventd(8), lvmpolld(8), lvmlockd(8), lvmlockctl(8), cmirrord(8),
215 lvmdbusd(8), fsadm(8),
216 lvmsystemid(7), lvmreport(7), lvmraid(7), lvmthin(7), lvmcache(7)
218Red Hat, Inc. LVM TOOLS 2.03.18(2)-git (2022-11-10) VGIMPORT(8)