mirror of
git://sourceware.org/git/lvm2.git
synced 2024-12-21 13:34:40 +03:00
370 lines
9.5 KiB
Plaintext
370 lines
9.5 KiB
Plaintext
.TH VGSPLIT 8 "LVM TOOLS #VERSION#" "Red Hat, Inc."
|
|
.
|
|
.SH NAME
|
|
.
|
|
vgsplit \(em Move physical volumes into a new or existing volume group
|
|
.
|
|
.SH SYNOPSIS
|
|
.
|
|
\fBvgsplit\fP \fIoption_args\fP \fIposition_args\fP
|
|
.br
|
|
[ \fIoption_args\fP ]
|
|
.br
|
|
.
|
|
.SH DESCRIPTION
|
|
.
|
|
vgsplit moves one or more PVs from a source VG (the first VG arg) to a
|
|
destination VG (the second VG arg). The PV(s) to move are named after the
|
|
source and destination VGs, or an LV is named, in which case the PVs
|
|
underlying the LV are moved.
|
|
.P
|
|
If the destination VG does not exist, a new VG is created (command options
|
|
can be used to specify properties of the new VG, also see
|
|
\fBvgcreate\fP(8)).
|
|
.P
|
|
LVs cannot be split between VGs; each LV must be entirely on the PVs in
|
|
the source or destination VG.
|
|
.P
|
|
vgsplit can only move complete PVs. (See \fBpvmove\fP(8) for moving part
|
|
of a PV.)
|
|
.
|
|
.SH USAGE
|
|
.
|
|
Split a VG by specified PVs.
|
|
.br
|
|
.P
|
|
\fBvgsplit\fP \fIVG\fP \fIVG\fP \fIPV\fP ...
|
|
.br
|
|
.RS 4
|
|
.ad l
|
|
[ COMMON_OPTIONS ]
|
|
.ad b
|
|
.RE
|
|
.P
|
|
Split a VG by PVs in a specified LV.
|
|
.br
|
|
.P
|
|
\fBvgsplit\fP \fB-n\fP|\fB--name\fP \fILV\fP \fIVG\fP \fIVG\fP
|
|
.br
|
|
.RS 4
|
|
.ad l
|
|
[ COMMON_OPTIONS ]
|
|
.ad b
|
|
.RE
|
|
.P
|
|
Common options for command:
|
|
.
|
|
.RS 4
|
|
.ad l
|
|
[ \fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ \fB-l\fP|\fB--maxlogicalvolumes\fP \fINumber\fP ]
|
|
.br
|
|
[ \fB-p\fP|\fB--maxphysicalvolumes\fP \fINumber\fP ]
|
|
.br
|
|
[ \fB-M\fP|\fB--metadatatype\fP \fBlvm2\fP ]
|
|
.br
|
|
[ \fB--alloc\fP \c
|
|
.nh
|
|
\%\fBcontiguous\fP|\:\fBcling\fP|\:\fBcling_by_tags\fP|\:\fBnormal\fP|\:\fBanywhere\fP|\:\fBinherit\fP
|
|
.hy
|
|
]
|
|
.br
|
|
[ \fB--poolmetadataspare\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ \fB--\fP[\fBvg\fP]\fBmetadatacopies\fP \fBall\fP|\fBunmanaged\fP|\fINumber\fP ]
|
|
.ad b
|
|
.RE
|
|
.P
|
|
Common options for lvm:
|
|
.
|
|
.RS 4
|
|
.ad l
|
|
[ \fB-d\fP|\fB--debug\fP ]
|
|
.br
|
|
[ \fB-h\fP|\fB--help\fP ]
|
|
.br
|
|
[ \fB-q\fP|\fB--quiet\fP ]
|
|
.br
|
|
[ \fB-t\fP|\fB--test\fP ]
|
|
.br
|
|
[ \fB-v\fP|\fB--verbose\fP ]
|
|
.br
|
|
[ \fB-y\fP|\fB--yes\fP ]
|
|
.br
|
|
[ \fB--commandprofile\fP \fIString\fP ]
|
|
.br
|
|
[ \fB--config\fP \fIString\fP ]
|
|
.br
|
|
[ \fB--devices\fP \fIPV\fP ]
|
|
.br
|
|
[ \fB--devicesfile\fP \fIString\fP ]
|
|
.br
|
|
[ \fB--driverloaded\fP \fBy\fP|\fBn\fP ]
|
|
.br
|
|
[ \fB--journal\fP \fIString\fP ]
|
|
.br
|
|
[ \fB--lockopt\fP \fIString\fP ]
|
|
.br
|
|
[ \fB--longhelp\fP ]
|
|
.br
|
|
[ \fB--nohints\fP ]
|
|
.br
|
|
[ \fB--nolocking\fP ]
|
|
.br
|
|
[ \fB--profile\fP \fIString\fP ]
|
|
.br
|
|
[ \fB--version\fP ]
|
|
.ad b
|
|
.RE
|
|
.
|
|
.SH OPTIONS
|
|
.
|
|
.
|
|
.HP
|
|
.ad l
|
|
\fB--alloc\fP \c
|
|
.nh
|
|
\%\fBcontiguous\fP|\:\fBcling\fP|\:\fBcling_by_tags\fP|\:\fBnormal\fP|\:\fBanywhere\fP|\:\fBinherit\fP
|
|
.hy
|
|
.ad b
|
|
.br
|
|
Determines the allocation policy when a command needs to allocate
|
|
Physical Extents (PEs) from the VG. Each VG and LV has an allocation policy
|
|
which can be changed with vgchange/lvchange, or overridden on the
|
|
command line.
|
|
\fBnormal\fP applies common sense rules such as not placing parallel stripes
|
|
on the same PV.
|
|
\fBinherit\fP applies the VG policy to an LV.
|
|
\fBcontiguous\fP requires new PEs be placed adjacent to existing PEs.
|
|
\fBcling\fP places new PEs on the same PV as existing PEs in the same
|
|
stripe of the LV.
|
|
If there are sufficient PEs for an allocation, but normal does not
|
|
use them, \fBanywhere\fP will use them even if it reduces performance,
|
|
e.g. by placing two stripes on the same PV.
|
|
Optional positional PV args on the command line can also be used to limit
|
|
which PVs the command will use for allocation.
|
|
See \fBlvm\fP(8) for more information about allocation.
|
|
.
|
|
.HP
|
|
\fB-A\fP|\fB--autobackup\fP \fBy\fP|\fBn\fP
|
|
.br
|
|
Specifies if metadata should be backed up automatically after a change.
|
|
Enabling this is strongly advised! See \fBvgcfgbackup\fP(8) for more information.
|
|
.
|
|
.HP
|
|
\fB--commandprofile\fP \fIString\fP
|
|
.br
|
|
The command profile to use for command configuration.
|
|
See \fBlvm.conf\fP(5) for more information about profiles.
|
|
.
|
|
.HP
|
|
\fB--config\fP \fIString\fP
|
|
.br
|
|
Config settings for the command. These override \fBlvm.conf\fP(5) settings.
|
|
The String arg uses the same format as \fBlvm.conf\fP(5),
|
|
or may use section/field syntax.
|
|
See \fBlvm.conf\fP(5) for more information about config.
|
|
.
|
|
.HP
|
|
\fB-d\fP|\fB--debug\fP ...
|
|
.br
|
|
Set debug level. Repeat from 1 to 6 times to increase the detail of
|
|
messages sent to the log file and/or syslog (if configured).
|
|
.
|
|
.HP
|
|
\fB--devices\fP \fIPV\fP
|
|
.br
|
|
Devices that the command can use. This option can be repeated
|
|
or accepts a comma separated list of devices. This overrides
|
|
the devices file.
|
|
.
|
|
.HP
|
|
\fB--devicesfile\fP \fIString\fP
|
|
.br
|
|
A file listing devices that LVM should use.
|
|
The file must exist in \fI#DEFAULT_SYS_DIR#/devices/\fP and is managed
|
|
with the \fBlvmdevices\fP(8) command.
|
|
This overrides the \fBlvm.conf\fP(5) \fBdevices/devicesfile\fP and
|
|
\fBdevices/use_devicesfile\fP settings.
|
|
.
|
|
.HP
|
|
\fB--driverloaded\fP \fBy\fP|\fBn\fP
|
|
.br
|
|
If set to no, the command will not attempt to use device-mapper.
|
|
For testing and debugging.
|
|
.
|
|
.HP
|
|
\fB-h\fP|\fB--help\fP
|
|
.br
|
|
Display help text.
|
|
.
|
|
.HP
|
|
\fB--journal\fP \fIString\fP
|
|
.br
|
|
Record information in the systemd journal.
|
|
This information is in addition to information
|
|
enabled by the lvm.conf log/journal setting.
|
|
command: record information about the command.
|
|
output: record the default command output.
|
|
debug: record full command debugging.
|
|
.
|
|
.HP
|
|
\fB--lockopt\fP \fIString\fP
|
|
.br
|
|
Used to pass options for special cases to lvmlockd.
|
|
See \fBlvmlockd\fP(8) for more information.
|
|
.
|
|
.HP
|
|
\fB--longhelp\fP
|
|
.br
|
|
Display long help text.
|
|
.
|
|
.HP
|
|
\fB-l\fP|\fB--maxlogicalvolumes\fP \fINumber\fP
|
|
.br
|
|
Sets the maximum number of LVs allowed in a VG.
|
|
.
|
|
.HP
|
|
\fB-p\fP|\fB--maxphysicalvolumes\fP \fINumber\fP
|
|
.br
|
|
Sets the maximum number of PVs that can belong to the VG.
|
|
The value 0 removes any limitation.
|
|
For large numbers of PVs, also see options --pvmetadatacopies,
|
|
and --vgmetadatacopies for improving performance.
|
|
.
|
|
.HP
|
|
\fB-M\fP|\fB--metadatatype\fP \fBlvm2\fP
|
|
.br
|
|
Specifies the type of on-disk metadata to use.
|
|
\fBlvm2\fP (or just \fB2\fP) is the current, standard format.
|
|
\fBlvm1\fP (or just \fB1\fP) is no longer used.
|
|
.
|
|
.HP
|
|
\fB-n\fP|\fB--name\fP \fIString\fP
|
|
.br
|
|
Move only PVs used by the named LV.
|
|
.
|
|
.HP
|
|
\fB--nohints\fP
|
|
.br
|
|
Do not use the hints file to locate devices for PVs. A command may read
|
|
more devices to find PVs when hints are not used. The command will still
|
|
perform standard hint file invalidation where appropriate.
|
|
.
|
|
.HP
|
|
\fB--nolocking\fP
|
|
.br
|
|
Disable locking.
|
|
.
|
|
.HP
|
|
\fB--poolmetadataspare\fP \fBy\fP|\fBn\fP
|
|
.br
|
|
Enable or disable the automatic creation and management of a
|
|
spare pool metadata LV in the VG. A spare metadata LV is reserved
|
|
space that can be used when repairing a pool.
|
|
.
|
|
.HP
|
|
\fB--profile\fP \fIString\fP
|
|
.br
|
|
An alias for --commandprofile or --metadataprofile, depending
|
|
on the command.
|
|
.
|
|
.HP
|
|
\fB-q\fP|\fB--quiet\fP ...
|
|
.br
|
|
Suppress output and log messages. Overrides --debug and --verbose.
|
|
Repeat once to also suppress any prompts with answer 'no'.
|
|
.
|
|
.HP
|
|
\fB-t\fP|\fB--test\fP
|
|
.br
|
|
Run in test mode. Commands will not update metadata.
|
|
This is implemented by disabling all metadata writing but nevertheless
|
|
returning success to the calling function. This may lead to unusual
|
|
error messages in multi-stage operations if a tool relies on reading
|
|
back metadata it believes has changed but hasn't.
|
|
.
|
|
.HP
|
|
\fB-v\fP|\fB--verbose\fP ...
|
|
.br
|
|
Set verbose level. Repeat from 1 to 4 times to increase the detail
|
|
of messages sent to stdout and stderr.
|
|
.
|
|
.HP
|
|
\fB--version\fP
|
|
.br
|
|
Display version information.
|
|
.
|
|
.HP
|
|
\fB--\fP[\fBvg\fP]\fBmetadatacopies\fP \fBall\fP|\fBunmanaged\fP|\fINumber\fP
|
|
.br
|
|
Number of copies of the VG metadata that are kept.
|
|
VG metadata is kept in VG metadata areas on PVs in the VG,
|
|
i.e. reserved space at the start and/or end of the PVs.
|
|
Keeping a copy of the VG metadata on every PV can reduce performance
|
|
in VGs containing a large number of PVs.
|
|
When this number is set to a non-zero value, LVM will automatically
|
|
choose PVs on which to store metadata, using the metadataignore flags
|
|
on PVs to achieve the specified number.
|
|
The number can also be replaced with special string values:
|
|
\fBunmanaged\fP causes LVM to not automatically manage the PV
|
|
metadataignore flags.
|
|
\fBall\fP causes LVM to first clear the metadataignore flags on
|
|
all PVs, and then to become unmanaged.
|
|
.
|
|
.HP
|
|
\fB-y\fP|\fB--yes\fP
|
|
.br
|
|
Do not prompt for confirmation interactively but always assume the
|
|
answer yes. Use with extreme caution.
|
|
(For automatic no, see -qq.)
|
|
.
|
|
.SH VARIABLES
|
|
.
|
|
.TP
|
|
.I VG
|
|
Volume Group name. See \fBlvm\fP(8) for valid names.
|
|
.TP
|
|
.I PV
|
|
Physical Volume name, a device path under /dev.
|
|
For commands managing physical extents, a PV positional arg
|
|
generally accepts a suffix indicating a range (or multiple ranges)
|
|
of physical extents (PEs). When the first PE is omitted, it defaults
|
|
to the start of the device, and when the last PE is omitted it defaults to end.
|
|
Start and end range (inclusive): \fIPV\fP[\fB:\fP\fIPE\fP\fB-\fP\fIPE\fP]...
|
|
Start and length range (counting from 0): \fIPV\fP[\fB:\fP\fIPE\fP\fB+\fP\fIPE\fP]...
|
|
.TP
|
|
.I String
|
|
See the option description for information about the string content.
|
|
.TP
|
|
.IR Size [UNIT]
|
|
Size is an input number that accepts an optional unit.
|
|
Input units are always treated as base two values, regardless of
|
|
capitalization, e.g. 'k' and 'K' both refer to 1024.
|
|
The default input unit is specified by letter, followed by |UNIT.
|
|
UNIT represents other possible input units:
|
|
.BR b | B
|
|
is bytes,
|
|
.BR s | S
|
|
is sectors of 512 bytes,
|
|
.BR k | K
|
|
is KiB,
|
|
.BR m | M
|
|
is MiB,
|
|
.BR g | G
|
|
is GiB,
|
|
.BR t | T
|
|
is TiB,
|
|
.BR p | P
|
|
is PiB,
|
|
.BR e | E
|
|
is EiB.
|
|
(This should not be confused with the output control --units, where
|
|
capital letters mean multiple of 1000.)
|
|
.
|
|
.SH ENVIRONMENT VARIABLES
|
|
.
|
|
See \fBlvm\fP(8) for information about environment variables used by lvm.
|
|
For example, LVM_VG_NAME can generally be substituted for a required VG parameter.
|