1VGCONVERT(8) System Manager's Manual VGCONVERT(8)
2
6 vgconvert — Change volume group metadata format
7
9 vgconvert position_args
10 [ option_args ]
11
13 vgconvert is no longer a part of LVM. It was removed along with sup‐
14 port for the LVM1 format. Use an older version of LVM to convert VGs
15 from the LVM1 format to LVM2.
16
18 vgconvert VG ...
19 [ -f|--force ]
20 [ -M|--metadatatype lvm2 ]
21 [ --labelsector Number ]
22 [ --bootloaderareasize Size[m|UNIT] ]
23 [ --pvmetadatacopies 0|1|2 ]
24 [ --metadatasize Size[m|UNIT] ]
25 [ --reportformat basic|json|json_std ]
26 [ COMMON_OPTIONS ]
27 Common options for lvm:
29 [ -d|--debug ]
30 [ -h|--help ]
31 [ -q|--quiet ]
32 [ -t|--test ]
33 [ -v|--verbose ]
34 [ -y|--yes ]
35 [ --commandprofile String ]
36 [ --config String ]
37 [ --devices PV ]
38 [ --devicesfile String ]
39 [ --driverloaded y|n ]
40 [ --journal String ]
41 [ --lockopt String ]
42 [ --longhelp ]
43 [ --nohints ]
44 [ --nolocking ]
45 [ --profile String ]
46 [ --version ]
47
49 --bootloaderareasize Size[m|UNIT]
50 Reserve space for the bootloader between the LVM metadata area
51 and the first PE. The bootloader area is reserved for bootload‐
52 ers to embed their own data or metadata; LVM will not use it.
53 The bootloader area begins where the first PE would otherwise be
54 located. The first PE is moved out by the size of the boot‐
55 loader area, and then moved out further if necessary to match
56 the data alignment. The start of the bootloader area is always
57 aligned, see also --dataalignment and --dataalignmentoffset. The
58 bootloader area may be larger than requested due to the align‐
59 ment, but it's never less than the requested size. To see the
60 bootloader area start and size of an existing PV use pvs -o
61 +pv_ba_start,pv_ba_size.
62 --commandprofile String
64 The command profile to use for command configuration. See
65 lvm.conf(5) for more information about profiles.
66 --config String
68 Config settings for the command. These override lvm.conf(5) set‐
69 tings. The String arg uses the same format as lvm.conf(5), or
70 may use section/field syntax. See lvm.conf(5) for more informa‐
71 tion about config.
72 -d|--debug ...
74 Set debug level. Repeat from 1 to 6 times to increase the detail
75 of messages sent to the log file and/or syslog (if configured).
76 --devices PV
78 Restricts the devices that are visible and accessible to the
79 command. Devices not listed will appear to be missing. This op‐
80 tion can be repeated, or accepts a comma separated list of de‐
81 vices. This overrides the devices file.
82 --devicesfile String
84 A file listing devices that LVM should use. The file must exist
85 in /etc/lvm/devices/ and is managed with the lvmdevices(8) com‐
86 mand. This overrides the lvm.conf(5) devices/devicesfile and
87 devices/use_devicesfile settings.
88 --driverloaded y|n
90 If set to no, the command will not attempt to use device-mapper.
91 For testing and debugging.
92 -f|--force ...
94 Override various checks, confirmations and protections. Use
95 with extreme caution.
96 -h|--help
98 Display help text.
99 --journal String
101 Record information in the systemd journal. This information is
102 in addition to information enabled by the lvm.conf log/journal
103 setting. command: record information about the command. out‐
104 put: record the default command output. debug: record full com‐
105 mand debugging.
106 --labelsector Number
108 By default the PV is labelled with an LVM2 identifier in its
109 second sector (sector 1). This lets you use a different sector
110 near the start of the disk (between 0 and 3 inclusive - see LA‐
111 BEL_SCAN_SECTORS in the source). Use with care.
112 --lockopt String
114 Used to pass options for special cases to lvmlockd. See lvm‐
115 lockd(8) for more information.
116 --longhelp
118 Display long help text.
119 --metadatasize Size[m|UNIT]
121 The approximate amount of space used for each VG metadata area.
122 The size may be rounded.
123 -M|--metadatatype lvm2
125 Specifies the type of on-disk metadata to use. lvm2 (or just 2)
126 is the current, standard format. lvm1 (or just 1) is no longer
127 used.
128 --nohints
130 Do not use the hints file to locate devices for PVs. A command
131 may read more devices to find PVs when hints are not used. The
132 command will still perform standard hint file invalidation where
133 appropriate.
134 --nolocking
136 Disable locking. Use with caution, concurrent commands may pro‐
137 duce incorrect results.
138 --profile String
140 An alias for --commandprofile or --metadataprofile, depending on
141 the command.
142 --pvmetadatacopies 0|1|2
144 The number of metadata areas to set aside on a PV for storing VG
145 metadata. When 2, one copy of the VG metadata is stored at the
146 front of the PV and a second copy is stored at the end. When 1,
147 one copy of the VG metadata is stored at the front of the PV.
148 When 0, no copies of the VG metadata are stored on the given PV.
149 This may be useful in VGs containing many PVs (this places limi‐
150 tations on the ability to use vgsplit later.)
151 -q|--quiet ...
153 Suppress output and log messages. Overrides --debug and --ver‐
154 bose. Repeat once to also suppress any prompts with answer
155 'no'.
156 --reportformat basic|json|json_std
158 Overrides current output format for reports which is defined
159 globally by the report/output_format setting in lvm.conf(5).
160 basic is the original format with columns and rows. If there is
161 more than one report per command, each report is prefixed with
162 the report name for identification. json produces report output
163 in JSON format. json_std produces report output in JSON format
164 which is more compliant with JSON standard. See lvmreport(7)
165 for more information.
166 -t|--test
168 Run in test mode. Commands will not update metadata. This is
169 implemented by disabling all metadata writing but nevertheless
170 returning success to the calling function. This may lead to un‐
171 usual error messages in multi-stage operations if a tool relies
172 on reading back metadata it believes has changed but hasn't.
173 -v|--verbose ...
175 Set verbose level. Repeat from 1 to 4 times to increase the de‐
176 tail of messages sent to stdout and stderr.
177 --version
179 Display version information.
180 -y|--yes
182 Do not prompt for confirmation interactively but always assume
183 the answer yes. Use with extreme caution. (For automatic no,
184 see -qq.)
185
187 VG Volume Group name. See lvm(8) for valid names.
188 String See the option description for information about the string con‐
190 tent.
191 Size[UNIT]
193 Size is an input number that accepts an optional unit. Input
194 units are always treated as base two values, regardless of capi‐
195 talization, e.g. 'k' and 'K' both refer to 1024. The default
196 input unit is specified by letter, followed by |UNIT. UNIT rep‐
197 resents other possible input units: b|B is bytes, s|S is sectors
198 of 512 bytes, k|K is KiB, m|M is MiB, g|G is GiB, t|T is TiB,
199 p|P is PiB, e|E is EiB. (This should not be confused with the
200 output control --units, where capital letters mean multiple of
201 1000.)
202
204 See lvm(8) for information about environment variables used by lvm.
205 For example, LVM_VG_NAME can generally be substituted for a required VG
206 parameter.
207
209 lvm(8), lvm.conf(5), lvmconfig(8), lvmdevices(8),
210 pvchange(8), pvck(8), pvcreate(8), pvdisplay(8), pvmove(8),
212 pvremove(8), pvresize(8), pvs(8), pvscan(8),
213 vgcfgbackup(8), vgcfgrestore(8), vgchange(8), vgck(8), vgcreate(8),
215 vgconvert(8), vgdisplay(8), vgexport(8), vgextend(8), vgimport(8),
216 vgimportclone(8), vgimportdevices(8), vgmerge(8), vgmknodes(8),
217 vgreduce(8), vgremove(8), vgrename(8), vgs(8), vgscan(8), vgsplit(8),
218 lvcreate(8), lvchange(8), lvconvert(8), lvdisplay(8), lvextend(8),
220 lvreduce(8), lvremove(8), lvrename(8), lvresize(8), lvs(8), lvscan(8),
221 lvm-fullreport(8), lvm-lvpoll(8), blkdeactivate(8), lvmdump(8),
223 dmeventd(8), lvmpolld(8), lvmlockd(8), lvmlockctl(8), cmirrord(8),
225 lvmdbusd(8), fsadm(8),
226 lvmsystemid(7), lvmreport(7), lvmcache(7), lvmraid(7), lvmthin(7),
228 lvmvdo(7), lvmautoactivation(7)
229Red Hat, Inc. LVM TOOLS 2.03.22(2) (2023-08-02) VGCONVERT(8)