migratepv

migratepv Command



Purpose

Moves allocated physical partitions from one physical volume to one
or more other physical volumes.

Syntax

migratepv [ -i ] [ -l LogicalVolume ] SourcePhysicalVolume DestinationPhysicalVolume
...

Description

Attention: This command is not allowed if the volume group is varied
on in concurrent mode.

The migratepv command moves allocated physical partitions and the
data they contain from the SourcePhysicalVolume to one or more other
physical volumes. To limit the transfer to specific physical volumes,
use the names of one or more physical volumes in the DestinationPhysicalVolume
parameter; otherwise, all the physical volumes in the volume group
are available for the transfer. All physical volumes must be within
the same volume group. The specified source physical volume cannot
be included in the list of DestinationPhysicalVolume parameters.

Notes: 

1.	The migratepv command cannot migrate striped logical volumes. To
move data from one physical volume to another, use the cplv command
to copy the data and then use the rmlv command to remove the old copy.

2.	To use this command,  either have root user authority or
be a member of the system group.

The allocation of the new physical partitions follows the policies
defined for the logical volumes that contain the physical partitions
being moved.

The migratepv command (only when the source and target physical volumes
are specified) fails when a boot logical volume is found on the source
physical volume. When you migrate a physical volume, the boot logical
volume must remain intact. Two contiguous physical partitions and
the new boot image must be built on the new boot logical volume.

If you specify a logical volume that contains the boot image, the
migratepv -l command attempts to find enough contiguous partitions
on one of the target physical volumes. If the migration is successful,
the migratepv command prints a message that recommends the user run
the bosboot command to indicate a change in the boot device. The attempted
migration fails if the migratepv -l command is unable to find enough
contiguous space to satisfy the request.

Note:	All Logical Volume Manager migrate functions work by creating
a mirror of the logical volumes involved, then resynchronizing the
logical volumes. The original logical volume is then removed. Therefore,
the migratepv command alone should not be used to move a logical volume
containing the primary dump device. The command will execute, but
any subsequent system dump will fail. In addition, the physical volume
cannot be removed from the volume group. You must first reassign the
dump device using the sysdumpdev command.

You can use the System Management Interface Tool (SMIT) to run this
command. To use SMIT, enter:

smit migratepv

Flags

-i	Reads the DestinationPhysicalVolume parameter from standard input.

-l LogicalVolume	Moves only the physical partitions allocated to the
specified logical volume and located on the specified source physical
volume.

Examples

1.	To move physical partitions from hdisk1 to hdisk6 and hdisk7, enter:

migratepv hdisk1 hdisk6 hdisk7

Physical partitions are moved from one physical volume to two others
within the same volume group.

2.	To move physical partitions in logical volume lv02 from hdisk1
to hdisk6, enter:

migratepv -l lv02 hdisk1 hdisk6

Only those physical partitions contained in lv02 are moved from one
physical volume to another.

Files

/usr/sbin	Directory where the migratepv command resides.

/tmp	Directory where the temporary files are stored while the command
is running.

Related Information

The cplv command, lslv command.

Migrating the Contents of a Physical Volume in AIX Version 4 System
Management Guide: Operating System and Devices.

Logical Volume Storage Overview in AIX Version 4 System Management
Guide: Operating System and Devices.

System Management Interface Tool (SMIT): Overview in AIX Version 4
System Management Guide: Operating System and Devices.

System Dump Facility in AIX Version 4 Problem Solving Guide and Reference.

AIX HACMP/6000 Concepts and Facilities.