NAME

lvsplit − split a mirrored logical volume into two logical volumes

SYNOPSIS

/etc/lvsplit [-s suffix] lv_path

Remarks:

This command requires installation of optional LVM MIRRORING software (not included in the standard HP-UX operating system) before it can be used. 

DESCRIPTION

lvsplit splits singly- or doubly-mirrored lv_path into two logical volumes.  A new logical volume is created containing one copy of the data. 

If suffix is specified, the new logical volume is given the name lv_pathsuffix. If suffix is not specified, lvsplit assigns a new name using the suffix b. 

Whenever a mirrored logical volume is split into two logical volumes, a bitmap is stored that keeps track of all writes to either logical volume in the split pair.  When the two logical volumes are subsequently merged using lvmerge, the bitmap is used to decide which areas of the logical volumes need to be resynchronized (see lvmerge(1M)). This bitmap remains in existence until the merge is completed, or until either of the logical volumes is extended, reduced, or split again or the system is rebooted.

The new Logical Volume must be fs checked before mounting (see fsck(1M)). lvsplit flushs the filesystem to a consistent state except for pipes and unlinked but open files. 

To remerge two mirrored copies of a Logical Volume, use the lvmerge command (see lvmerge(1M)).

EXTERNAL INFLUENCES

Environment Variables

LANG determines the language in which messages are displayed. 

If LANG is not specified or is set to the empty string, a default of "C" (see lang(5)) is used instead of LANG. 

If any internationalization variable contains an invalid setting, lvsplit behaves as if all internationalization variables are set to "C".  See environ(5).

EXAMPLES

Split the mirrored logical volume /dev/vg00/lvol1 into two copies.  Call the new logical volume /dev/vg00/lvol1backup:

lvsplit -s backup /dev/vg00/lvol1

Split an online Logical Volume which is currently mounted on /usr so that a backup can take place:

lvsplit /dev/vg00/lvol1

fsck /dev/vg00/lvol1b

mount /dev/vg00/lvol1b /usr.backup

Perform backup operation:

umount /usr.backup
lvmerge /dev/vg00/lvol1b /dev/vg00/lvol1

SEE ALSO

lvmerge(1M), lvcreate(1M), lvextend(1M). 

Hewlett-Packard Company  —  HP-UX Release 9.03: April 1994