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