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 se‐
112 lectable 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 un‐
122 usual error messages in multi-stage operations if a tool relies
123 on reading back metadata it believes has changed but hasn't.
124 -v|--verbose ...
126 Set verbose level. Repeat from 1 to 4 times to increase the de‐
127 tail of messages sent to stdout and stderr.
128 --version
130 Display version information.
131 -y|--yes
133 Do not prompt for confirmation interactively but always assume
134 the answer yes. Use with extreme caution. (For automatic no,
135 see -qq.)
136
138 VG
139 Volume Group name. See lvm(8) for valid names.
140 Tag
142 Tag name. See lvm(8) for information about tag names and using
143 tags in place of a VG, LV or PV.
144 Select
146 Select indicates that a required positional parameter can be
147 omitted if the --select option is used. No arg appears in this
148 position.
149 String
151 See the option description for information about the string con‐
152 tent.
153 Size[UNIT]
155 Size is an input number that accepts an optional unit. Input
156 units are always treated as base two values, regardless of capi‐
157 talization, e.g. 'k' and 'K' both refer to 1024. The default
158 input unit is specified by letter, followed by |UNIT. UNIT rep‐
159 resents other possible input units: bBsSkKmMgGtTpPeE. b|B is
160 bytes, s|S is sectors of 512 bytes, k|K is KiB, m|M is MiB, g|G
161 is GiB, t|T is TiB, p|P is PiB, e|E is EiB. (This should not be
162 confused with the output control --units, where capital letters
163 mean multiple of 1000.)
164
166 See lvm(8) for information about environment variables used by lvm.
167 For example, LVM_VG_NAME can generally be substituted for a required VG
168 parameter.
169
171 lvm(8) lvm.conf(5) lvmconfig(8)
172 pvchange(8) pvck(8) pvcreate(8) pvdisplay(8) pvmove(8) pvremove(8)
174 pvresize(8) pvs(8) pvscan(8)
175 vgcfgbackup(8) vgcfgrestore(8) vgchange(8) vgck(8) vgcreate(8) vgcon‐
177 vert(8) vgdisplay(8) vgexport(8) vgextend(8) vgimport(8) vgimport‐
178 clone(8) vgmerge(8) vgmknodes(8) vgreduce(8) vgremove(8) vgrename(8)
179 vgs(8) vgscan(8) vgsplit(8)
180 lvcreate(8) lvchange(8) lvconvert(8) lvdisplay(8) lvextend(8) lvre‐
182 duce(8) lvremove(8) lvrename(8) lvresize(8) lvs(8) lvscan(8)
183 lvm-fullreport(8) lvm-lvpoll(8) lvm2-activation-generator(8) blkdeacti‐
185 vate(8) lvmdump(8)
186 dmeventd(8) lvmpolld(8) lvmlockd(8) lvmlockctl(8) cmirrord(8) lvmd‐
188 busd(8)
189 lvmsystemid(7) lvmreport(7) lvmraid(7) lvmthin(7) lvmcache(7)
191Red Hat, Inc. LVM TOOLS 2.03.11(2) (2021-01-08) VGIMPORT(8)