lvsplit.1m (2010 09)

l
lvsplit(1M) lvsplit(1M)
(Requires Optional HP MirrorDisk/UX Software)
NAME
lvsplit - split mirrored LVM logical volume into two logical volumes
SYNOPSIS
/usr/sbin/lvsplit
[-A autobackup ][-s suffix][
-g 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 processed 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
lvsplit 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.
The
lvsplit command will fail for snapshot logical volumes. See lvm (7) for information about
snapshot logical volumes.
If the
-s option is specified, the new logical volume name has the form lv_path suffix.If
-s is not
specified, suffix defaults to
b,asinlv_path b.
If more than one lv_path is specified on the command line,
lvsplit 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 volumes 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
lvmerge, the bit map, if present, is used to decide which areas of the logical volumes need to be resyn-
chronized (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
fsck command before it is mounted (see fsck(1M)).
lvsplit 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
lvmerge command (see lvmerge (1M)).
Options and Arguments
lvsplit recognizes the following options and arguments:
lv_path The block device path name of a logical volume. 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.
-A autobackup Set automatic backup for invocation of this command. autobackup can have
one of the following values:
y Automatically back up configuration changes made to the logical volume.
This is the default.
After this command executes, the
vgcfgbackup command (see
vgcfgbackup (1M)) is executed for the volume group to which the logical
volume belongs.
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1