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 ]
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 [ --driverloaded y|n ]
45 [ --lockopt String ]
46 [ --longhelp ]
47 [ --nolocking ]
48 [ --profile String ]
49 [ --version ]
50
52 -a|--all
53 Import all visible VGs.
54 --commandprofile String
56 The command profile to use for command configuration. See
57 lvm.conf(5) for more information about profiles.
58 --config String
60 Config settings for the command. These override lvm.conf set‐
61 tings. The String arg uses the same format as lvm.conf, or may
62 use section/field syntax. See lvm.conf(5) for more information
63 about config.
64 -d|--debug ...
66 Set debug level. Repeat from 1 to 6 times to increase the detail
67 of messages sent to the log file and/or syslog (if configured).
68 --driverloaded y|n
70 If set to no, the command will not attempt to use device-mapper.
71 For testing and debugging.
72 -f|--force ...
74 Override various checks, confirmations and protections. Use
75 with extreme caution.
76 -h|--help
78 Display help text.
79 --lockopt String
81 Used to pass options for special cases to lvmlockd. See lvm‐
82 lockd(8) for more information.
83 --longhelp
85 Display long help text.
86 --nolocking
88 Disable locking.
89 --profile String
91 An alias for --commandprofile or --metadataprofile, depending on
92 the command.
93 -q|--quiet ...
95 Suppress output and log messages. Overrides --debug and --ver‐
96 bose. Repeat once to also suppress any prompts with answer
97 'no'.
98 --reportformat basic|json
100 Overrides current output format for reports which is defined
101 globally by the report/output_format setting in lvm.conf. basic
102 is the original format with columns and rows. If there is more
103 than one report per command, each report is prefixed with the
104 report name for identification. json produces report output in
105 JSON format. See lvmreport(7) for more information.
106 -S|--select String
108 Select objects for processing and reporting based on specified
109 criteria. The criteria syntax is described by --select help and
110 lvmreport(7). For reporting commands, one row is displayed for
111 each object matching the criteria. See --options help for
112 selectable object fields. Rows can be displayed with an addi‐
113 tional "selected" field (-o selected) showing 1 if the row
114 matches the selection and 0 otherwise. For non-reporting com‐
115 mands which process LVM entities, the selection is used to
116 choose items to process.
117 -t|--test
119 Run in test mode. Commands will not update metadata. This is
120 implemented by disabling all metadata writing but nevertheless
121 returning success to the calling function. This may lead to
122 unusual error messages in multi-stage operations if a tool
123 relies on reading back metadata it believes has changed but
124 hasn't.
125 -v|--verbose ...
127 Set verbose level. Repeat from 1 to 4 times to increase the
128 detail of messages sent to stdout and stderr.
129 --version
131 Display version information.
132 -y|--yes
134 Do not prompt for confirmation interactively but always assume
135 the answer yes. Use with extreme caution. (For automatic no,
136 see -qq.)
137
139 VG
140 Volume Group name. See lvm(8) for valid names.
141 Tag
143 Tag name. See lvm(8) for information about tag names and using
144 tags in place of a VG, LV or PV.
145 Select
147 Select indicates that a required positional parameter can be
148 omitted if the --select option is used. No arg appears in this
149 position.
150 String
152 See the option description for information about the string con‐
153 tent.
154 Size[UNIT]
156 Size is an input number that accepts an optional unit. Input
157 units are always treated as base two values, regardless of capi‐
158 talization, e.g. 'k' and 'K' both refer to 1024. The default
159 input unit is specified by letter, followed by |UNIT. UNIT rep‐
160 resents other possible input units: bBsSkKmMgGtTpPeE. b|B is
161 bytes, s|S is sectors of 512 bytes, k|K is kilobytes, m|M is
162 megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes,
163 e|E is exabytes. (This should not be confused with the output
164 control --units, where capital letters mean multiple of 1000.)
165
167 See lvm(8) for information about environment variables used by lvm.
168 For example, LVM_VG_NAME can generally be substituted for a required VG
169 parameter.
170
172 lvm(8) lvm.conf(5) lvmconfig(8)
173 pvchange(8) pvck(8) pvcreate(8) pvdisplay(8) pvmove(8) pvremove(8)
175 pvresize(8) pvs(8) pvscan(8)
176 vgcfgbackup(8) vgcfgrestore(8) vgchange(8) vgck(8) vgcreate(8) vgcon‐
178 vert(8) vgdisplay(8) vgexport(8) vgextend(8) vgimport(8) vgimport‐
179 clone(8) vgmerge(8) vgmknodes(8) vgreduce(8) vgremove(8) vgrename(8)
180 vgs(8) vgscan(8) vgsplit(8)
181 lvcreate(8) lvchange(8) lvconvert(8) lvdisplay(8) lvextend(8) lvre‐
183 duce(8) lvremove(8) lvrename(8) lvresize(8) lvs(8) lvscan(8)
184 lvm-fullreport(8) lvm-lvpoll(8) lvm2-activation-generator(8) blkdeacti‐
186 vate(8) lvmdump(8)
187 dmeventd(8) lvmpolld(8) lvmlockd(8) lvmlockctl(8) cmirrord(8) lvmd‐
189 busd(8)
190 lvmsystemid(7) lvmreport(7) lvmraid(7) lvmthin(7) lvmcache(7)
192Red Hat, Inc. LVM TOOLS 2.03.06(2) (2019-10-23) VGIMPORT(8)