lvsplit(1M)lvsplit(1M)NAMElvsplit - split mirrored LVM logical volume into two logical volumes
SYNOPSIS
autobackup] suffix] PhysicalVolumeGroup] lv_path ...
Remarks
If the logical volume input arguments belong to a combination of volume
groups version 1.0 and 2.0 or higher, the arguments might not be pro‐
cessed in the order they are listed on the command line.
This command requires the installation of the optional HP MirrorDisk/UX
software (not included in the standard HP-UX operating system) before
it can be used.
DESCRIPTION
The command splits a mirrored logical volume, lv_path, into two logical
volumes. A second logical volume is created containing one copy of the
data. The original logical volume is appropriately reset to have one
fewer mirror copies.
If the option is specified, the new logical volume name has the form
lv_pathsuffix. If is not specified, suffix defaults to as in
If more than one lv_path is specified on the command line, ensures that
all logical volumes are brought offline together in one system call,
ensuring predictable results among the logical volumes. All logical
volumes must belong to the same volume group. The current number of
logical volumes in the volume group added to the number of logical vol‐
umes specified on the command line must not exceed the maximum number
of logical volumes allowed in the volume group.
If PhysicalVolumeGroup is specified, the offline logical volumes are
created using the mirror copies on the physical volumes contained in
the specified physical volume group.
When a mirrored logical volume of a non-shared volume group is split
into two logical volumes, a bit map is stored that keeps track of all
writes to either logical volume in the split pair. If the volume group
is shared, this bit map is not created. When the two logical volumes
are subsequently merged using the bit map, if present, is used to
decide which areas of the logical volumes need to be resynchronized
(see lvmerge(1M)). This bit map remains in existence until one of the
following conditions occurs:
· The merge is completed.
· One of the logical volumes is extended, reduced, or split
again.
· The volume group is cross-activated to shared mode (see
vgchange(1M)).
· The system is rebooted.
The new logical volume must be checked with the command before it is
mounted (see fsck(1M)). flushes the file system to a consistent state
except for pipes and unlinked but open files.
To rejoin two split copies of a logical volume, use the command (see
lvmerge(1M)).
Options and Arguments
recognizes the following options and arguments:
lv_path The block device path name of a logical vol‐
ume. Multiple logical volumes in the same
volume group can be specified. The current
number of logical volumes in the volume
group added to the number of logical volumes
specified on the command line must not
exceed the maximum number of logical volumes
allowed in the volume group.
Set automatic backup for invocation of this command.
autobackup can have one of the following
values:
Automatically back up configuration changes
made to the logical volume.
This is the default.
After this command executes, the com‐
mand (see vgcfgbackup(1M)) is exe‐
cuted for the volume group to which
the logical volume belongs.
Do not back up configuration changes this
time.
The offline logical volumes will be created using the mirror
copies
on the physical volumes in the specified
PhysicalVolumeGroup.
Specify the suffix to use to identify the new logical volume.
The new logical volume name has the form
lv_pathsuffix. If is omitted, suffix
defaults to as in
Shared Volume Group Considerations
For volume group version 1.0 and 2.0, cannot be used if the volume
group is activated in shared mode. For volume groups version 2.1 (or
higher), can be performed when activated in either shared, exclusive,
or standalone mode.
Note that the daemon must be running on all the nodes sharing a volume
group activated in shared mode. See lvmpud(1M).
When is issued, it creates the new logical volume device special files
on all the nodes sharing the volume group. The device special files
are created with the same name on the nodes sharing the volume group.
When a node wants to share the volume group, the user must first exe‐
cute a if logical volumes were split at the time the volume group was
not activated on that node.
The logical volumes device special files should have the same name on
all the nodes sharing the volume group.
LVM shared mode is currently only available in Serviceguard clusters.
EXTERNAL INFLUENCES
Environment Variables
determines the language in which messages are displayed.
If is not specified or is null, it defaults to "C" (see lang(5)).
If any internationalization variable contains an invalid setting, all
internationalization variables default to "C" (see environ(5)).
EXAMPLES
Split the mirrored logical volume into two copies. Call the new logi‐
cal volume
Split the mirrored logical volume into two copies. The offline logical
volume will be created using the mirror copy on the physical volumes
contained in the physical volume group
Split an online logical volume which is currently mounted on so that a
backup can take place:
Perform a backup operation, then:
Split two logical volumes at the same time:
Perform a backup operation on the split logical volumes, then
rejoin them:
SEE ALSOlvcreate(1M), lvextend(1M), lvmerge(1M), lvmpud(1M).
Requires Optional HP MirrorDisk/UX Software lvsplit(1M)