vgsplit(8)

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

NAME

6       vgsplit — Move physical volumes into a new or existing volume group
7

SYNOPSIS

9       vgsplit option_args position_args
10           [ option_args ]
11

DESCRIPTION

13       vgsplit  moves one or more PVs from a source VG (the first VG arg) to a
14       destination VG (the second VG arg).  The PV(s) to move are named  after
15       the  source  and  destination VGs, or an LV is named, in which case the
16       PVs underlying the LV are moved.
17
18       If the destination VG does not exist, a new VG is created (command  op‐
19       tions  can be used to specify properties of the new VG, also see vgcre‐
20       ate(8)).
21
22       LVs cannot be split between VGs; each LV must be entirely on the PVs in
23       the source or destination VG.
24
25       vgsplit can only move complete PVs. (See pvmove(8) for moving part of a
26       PV.)
27

USAGE

29       Split a VG by specified PVs.
30
31       vgsplit VG VG PV ...
32           [ COMMON_OPTIONS ]
33
34       Split a VG by PVs in a specified LV.
35
36       vgsplit -n|--name LV VG VG
37           [ COMMON_OPTIONS ]
38
39       Common options for command:
40           [ -A|--autobackup y|n ]
41           [ -l|--maxlogicalvolumes Number ]
42           [ -p|--maxphysicalvolumes Number ]
43           [ -M|--metadatatype lvm2 ]
44           [    --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit
45           ]
46           [    --poolmetadataspare y|n ]
47           [    --[vg]metadatacopies all|unmanaged|Number ]
48
49       Common options for lvm:
50           [ -d|--debug ]
51           [ -h|--help ]
52           [ -q|--quiet ]
53           [ -t|--test ]
54           [ -v|--verbose ]
55           [ -y|--yes ]
56           [    --commandprofile String ]
57           [    --config String ]
58           [    --devices PV ]
59           [    --devicesfile String ]
60           [    --driverloaded y|n ]
61           [    --journal String ]
62           [    --lockopt String ]
63           [    --longhelp ]
64           [    --nohints ]
65           [    --nolocking ]
66           [    --profile String ]
67           [    --version ]
68

OPTIONS

70       --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit
71              Determines  the  allocation policy when a command needs to allo‐
72              cate Physical Extents (PEs) from the VG. Each VG and LV  has  an
73              allocation  policy  which can be changed with vgchange/lvchange,
74              or overridden on the command line.  normal applies common  sense
75              rules  such as not placing parallel stripes on the same PV.  in‐
76              herit applies the VG policy to an LV.  contiguous  requires  new
77              PEs be placed adjacent to existing PEs.  cling places new PEs on
78              the same PV as existing PEs in the same stripe of  the  LV.   If
79              there  are sufficient PEs for an allocation, but normal does not
80              use them, anywhere will use them even if it reduces performance,
81              e.g. by placing two stripes on the same PV.  Optional positional
82              PV args on the command line can also be used to limit which  PVs
83              the command will use for allocation.  See lvm(8) for more infor‐
84              mation about allocation.
85
86       -A|--autobackup y|n
87              Specifies if metadata should be backed up automatically after  a
88              change.   Enabling  this is strongly advised! See vgcfgbackup(8)
89              for more information.
90
91       --commandprofile String
92              The command profile  to  use  for  command  configuration.   See
93              lvm.conf(5) for more information about profiles.
94
95       --config String
96              Config settings for the command. These override lvm.conf(5) set‐
97              tings.  The String arg uses the same format as  lvm.conf(5),  or
98              may use section/field syntax.  See lvm.conf(5) for more informa‐
99              tion about config.
100
101       -d|--debug ...
102              Set debug level. Repeat from 1 to 6 times to increase the detail
103              of messages sent to the log file and/or syslog (if configured).
104
105       --devices PV
106              Restricts  the  devices  that  are visible and accessible to the
107              command.  Devices not listed will appear to be missing. This op‐
108              tion  can  be repeated, or accepts a comma separated list of de‐
109              vices. This overrides the devices file.
110
111       --devicesfile String
112              A file listing devices that LVM should use.  The file must exist
113              in  /etc/lvm/devices/ and is managed with the lvmdevices(8) com‐
114              mand.  This overrides the  lvm.conf(5)  devices/devicesfile  and
115              devices/use_devicesfile settings.
116
117       --driverloaded y|n
118              If set to no, the command will not attempt to use device-mapper.
119              For testing and debugging.
120
121       -h|--help
122              Display help text.
123
124       --journal String
125              Record information in the systemd journal.  This information  is
126              in  addition  to information enabled by the lvm.conf log/journal
127              setting.  command: record information about the  command.   out‐
128              put: record the default command output.  debug: record full com‐
129              mand debugging.
130
131       --lockopt String
132              Used to pass options for special cases to  lvmlockd.   See  lvm‐
133              lockd(8) for more information.
134
135       --longhelp
136              Display long help text.
137
138       -l|--maxlogicalvolumes Number
139              Sets the maximum number of LVs allowed in a VG.
140
141       -p|--maxphysicalvolumes Number
142              Sets  the  maximum number of PVs that can belong to the VG.  The
143              value 0 removes any limitation.  For large numbers of PVs,  also
144              see  options  --pvmetadatacopies, and --vgmetadatacopies for im‐
145              proving performance.
146
147       -M|--metadatatype lvm2
148              Specifies the type of on-disk metadata to use.  lvm2 (or just 2)
149              is  the current, standard format.  lvm1 (or just 1) is no longer
150              used.
151
152       -n|--name String
153              Move only PVs used by the named LV.
154
155       --nohints
156              Do not use the hints file to locate devices for PVs.  A  command
157              may  read  more devices to find PVs when hints are not used. The
158              command will still perform standard hint file invalidation where
159              appropriate.
160
161       --nolocking
162              Disable  locking. Use with caution, concurrent commands may pro‐
163              duce incorrect results.
164
165       --poolmetadataspare y|n
166              Enable or disable the automatic creation  and  management  of  a
167              spare  pool  metadata  LV  in the VG. A spare metadata LV is re‐
168              served space that can be used when repairing a pool.
169
170       --profile String
171              An alias for --commandprofile or --metadataprofile, depending on
172              the command.
173
174       -q|--quiet ...
175              Suppress  output  and log messages. Overrides --debug and --ver‐
176              bose.  Repeat once to also  suppress  any  prompts  with  answer
177              'no'.
178
179       -t|--test
180              Run  in  test  mode. Commands will not update metadata.  This is
181              implemented by disabling all metadata writing  but  nevertheless
182              returning  success to the calling function. This may lead to un‐
183              usual error messages in multi-stage operations if a tool  relies
184              on reading back metadata it believes has changed but hasn't.
185
186       -v|--verbose ...
187              Set  verbose level. Repeat from 1 to 4 times to increase the de‐
188              tail of messages sent to stdout and stderr.
189
190       --version
191              Display version information.
192
193       --[vg]metadatacopies all|unmanaged|Number
194              Number of copies of the VG metadata that are kept.  VG  metadata
195              is  kept  in  VG  metadata areas on PVs in the VG, i.e. reserved
196              space at the start and/or end of the PVs.  Keeping a copy of the
197              VG metadata on every PV can reduce performance in VGs containing
198              a large number of PVs.  When this number is set  to  a  non-zero
199              value, LVM will automatically choose PVs on which to store meta‐
200              data, using the metadataignore flags on PVs to achieve the spec‐
201              ified  number.   The  number  can  also be replaced with special
202              string values: unmanaged causes LVM to not automatically  manage
203              the  PV metadataignore flags.  all causes LVM to first clear the
204              metadataignore flags on all PVs, and then to become unmanaged.
205
206       -y|--yes
207              Do not prompt for confirmation interactively but  always  assume
208              the  answer  yes.  Use with extreme caution.  (For automatic no,
209              see -qq.)
210

VARIABLES

212       VG     Volume Group name.  See lvm(8) for valid names.
213
214       PV     Physical Volume name, a device path under  /dev.   For  commands
215              managing physical extents, a PV positional arg generally accepts
216              a suffix indicating a range (or multiple ranges) of physical ex‐
217              tents  (PEs).  When  the first PE is omitted, it defaults to the
218              start of the device, and when the last PE is omitted it defaults
219              to  end.   Start and end range (inclusive): PV[:PE-PE]...  Start
220              and length range (counting from 0): PV[:PE+PE]...
221
222       String See the option description for information about the string con‐
223              tent.
224
225       Size[UNIT]
226              Size  is  an  input number that accepts an optional unit.  Input
227              units are always treated as base two values, regardless of capi‐
228              talization,  e.g.  'k'  and 'K' both refer to 1024.  The default
229              input unit is specified by letter, followed by |UNIT.  UNIT rep‐
230              resents other possible input units: b|B is bytes, s|S is sectors
231              of 512 bytes, k|K is KiB, m|M is MiB, g|G is GiB,  t|T  is  TiB,
232              p|P  is  PiB, e|E is EiB.  (This should not be confused with the
233              output control --units, where capital letters mean  multiple  of
234              1000.)
235

ENVIRONMENT VARIABLES

237       See  lvm(8)  for  information  about environment variables used by lvm.
238       For example, LVM_VG_NAME can generally be substituted for a required VG
239       parameter.
240