vgconvert(8)

1VGCONVERT(8)                System Manager's Manual               VGCONVERT(8)
2
3
4

NAME

6       vgconvert — Change volume group metadata format
7

SYNOPSIS

9       vgconvert position_args
10           [ option_args ]
11

DESCRIPTION

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

USAGE

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
28       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

OPTIONS

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
63       --commandprofile String
64              The command profile  to  use  for  command  configuration.   See
65              lvm.conf(5) for more information about profiles.
66
67       --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
73       -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
77       --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
83       --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
89       --driverloaded y|n
90              If set to no, the command will not attempt to use device-mapper.
91              For testing and debugging.
92
93       -f|--force ...
94              Override various checks,  confirmations  and  protections.   Use
95              with extreme caution.
96
97       -h|--help
98              Display help text.
99
100       --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
107       --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
113       --lockopt String
114              Used to pass options for special cases to  lvmlockd.   See  lvm‐
115              lockd(8) for more information.
116
117       --longhelp
118              Display long help text.
119
120       --metadatasize Size[m|UNIT]
121              The  approximate amount of space used for each VG metadata area.
122              The size may be rounded.
123
124       -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
129       --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
135       --nolocking
136              Disable  locking. Use with caution, concurrent commands may pro‐
137              duce incorrect results.
138
139       --profile String
140              An alias for --commandprofile or --metadataprofile, depending on
141              the command.
142
143       --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
152       -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
157       --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
167       -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
174       -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
178       --version
179              Display version information.
180
181       -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

VARIABLES

187       VG     Volume Group name.  See lvm(8) for valid names.
188
189       String See the option description for information about the string con‐
190              tent.
191
192       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

ENVIRONMENT VARIABLES

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