lvsync(1M)

NAME

lvsync — synchronize stale mirrors in LVM logical volumes

SYNOPSIS

/usr/sbin/lvsync [-T] lv_path ...

Remarks

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 lvsync command synchronizes the physical extents of each logical volume specified by lv_path. Synchronization occurs only on physical extents that are stale mirrors of the original logical extent. The synchronization process can be time consuming, depending on the hardware characteristics and the amount of data.

Arguments

lvsync recognizes the following argument:

lv_path

The block device path name of a mirrored logical volume.

-T

Perform mirror synchronization of logical volumes within a volume group using multiple parallel threads. Logical volumes belonging to different volume groups will be synchronized serially. It is possible that logical volumes start and/or complete their synchronization in a different order than specified on the command line.

The maximum number of threads used can be controlled using the PTHREAD_THREADS_MAX system tunable.

NOTE: This option has no effect if the volume group is activated in shared mode.

EXTERNAL INFLUENCES

Environment Variables

LANG determines the language in which messages are displayed.

If LANG 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

Synchronize the mirrors on a logical volume:

lvsync /dev/vg01/lvol5 

Synchronize the mirrors on three logical volumes using multiple parallel threads:

lvsync -T /dev/vg02/lvol1 /dev/vg02/lvol2 /dev/vg02/lvol3 

Add mirror copies using lvextend with the -s option for three logical volumes, and then synchronize mirrors on these three logical volumes using multiple parallel threads.

First, add mirror copies to each logical volume using lvextend with the -s option:

lvextend -m 1 -s /dev/vg03/lvol1
lvextend -m 2 -s /dev/vg03/lvol2
lvextend -m 2 -s /dev/vg03/lvol3

Now synchronize the mirrors on these three logical volumes using multiple parallel threads:

lvsync -T /dev/vg03/lvol1 /dev/vg03/lvol2 /dev/vg03/lvol3 

lvsync(1M)

Technical documentation

» Table of Contents

» Index