pvmove(1M)

NAME

pvmove — move allocated physical extents from one LVM physical volume to other physical volumes

SYNOPSIS

/usr/sbin/pvmove [-A autobackup] [-n lv_path] source_pv_path [dest_pv_path ... | dest_pvg_name ...]

/usr/sbin/pvmove [-A autobackup] source_pv_path[:0] [dest_pv_path ... | dest_pvg_name ...]

Remarks

pvmove cannot be performed if the volume group is activated in shared mode.

pvmove cannot move extents of a striped logical volume.

DESCRIPTION

The pvmove command moves allocated physical extents and the data they contain from a source physical volume, source_pv_path, to one or more other physical volumes in the same volume group.

The first extent of the physical volume can be moved to create more space for LVM's metadata. The vgmodify command can use this extra space to expand the metadata. To relocate the first extent, specify 0 after source_pv_path, delimited by a colon (:).

If a destination physical volume or physical volume group is not specified, all physical volumes in the volume group are available as destination volumes for the transfer. pvmove selects the proper physical volumes to be used in order to preserve the allocation policies of the logical volume involved.

To limit the transfer to specific physical volumes, specify the name of each physical volume directly with a dest_pv_path argument. Optionally, if physical volume groups are defined for the volume group, specify the physical volumes indirectly with one or more dest_pvg_name arguments.

source_pv_path must not appear as a dest_pv_path.

If source_pv_path is a member of a dest_pvg_name, it is automatically excluded from being a destination physical volume.

While moving the first extent, src_pv_path can be part of dest_pv_path and src_pv_path is not excluded if it is member of dest_pvg_name.

pvmove succeeds only if there is enough space on the destination physical volumes to hold all the allocated extents of the source physical volume.

If you have installed HP MirrorDisk/UX on your system and source_pv_path is an "active spare" physical volume within a mirrored logical volume, once all of the data has been moved to dest_pv_path, the source_pv_path physical volume will be returned to a "stand-by" spare physical volume. This is how to "unspare" data once the original failed physical volume has been repaired and is available to receive data.

Options

pvmove recognizes the following options:

dest_pv_path

The block device path name of a physical volume. It cannot be the source physical volume. It must be in the same volume group as source_pv_path.

dest_pvg_name

The name of a physical volume group. It must be in the same volume group as source_pv_path.

source_pv_path

The block device path name of a physical volume.

-A autobackup

Set automatic backup for this invocation of this command. autobackup can have one of the following values:

y

Automatically back up configuration changes made to the physical volume. This is the default.

After this command executes, the vgcfgbackup command (see vgcfgbackup(1M)) is executed for the volume group to which the physical volume belongs.

n

Do not back up configuration changes this time.

-n lv_path

Move only the physical extents allocated to the logical volume specified by lv_path that are located on the source physical volume specified by source_pv_path.

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

Move physical extents from /dev/dsk/c1t0d0 to /dev/dsk/c2t0d0 and /dev/dsk/c3t0d0:

pvmove /dev/dsk/c1t0d0 /dev/dsk/c2t0d0 /dev/dsk/c3t0d0 

If physical volumes /dev/dsk/c2t0d0 and /dev/dsk/c3t0d0 are the only ones that belong to physical volume group PVG0, the same result can be achieved with the following command:

pvmove /dev/dsk/c1t0d0 PVG0 

Move only the physical extents for logical volume /dev/vg01/lvol2 that are currently on /dev/dsk/c1t0d0 to /dev/dsk/c2t0d0:

pvmove -n /dev/vg01/lvol2 /dev/dsk/c1t0d0 /dev/dsk/c2t0d0 

Relocate PE number 0 to any free extent with in the same physical volume.

pvmove  /dev/dsk/c1t0d0:0  /dev/dsk/c1t0d0 

Relocate PE number 0 from /dev/dsk/c1t0d0 to any free extent in the volume group.

pvmove  /dev/dsk/c1t0d0:0 

pvmove(1M)

Technical documentation

» Table of Contents

» Index