Commands Reference, Volume 3

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

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:

To use this command, you must either have root user authority or be a member of the system group.
The migratepv command is not allowed on a snapshot volume group or a volume group that has a snapshot volume 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. If the migratepv command is used to move a logical volume containing the primary dump device, the system will not have an accessible primary dump device during the execution of the command. Therefore, a dump taken during this execution may fail. To avoid this, reassign the primary dump device using the sysdumpdev command or ensure there is a secondary dump device defined before using migratepv.

You can use the Volumes application in Web-based System Manager (wsm) to change volume characteristics. You could also use the System Management Interface Tool (SMIT) smit migratepv fast path to run this command.

Note

For concurrent mode volume groups migratepv can only be used while active in enhanced concurrent mode or active in concurrent mode on SSA disks.

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

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.
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 5L Version 5.2 System Management Guide: Operating System and Devices.

Logical Volume Storage Overview in AIX 5L Version 5.2 System Management Concepts: Operating System and Devices.

For information on installing the Web-based System Manager, see Chapter 2: Installation and System Requirements in AIX 5L Version 5.2 Web-based System Manager Administration Guide.

System Management Interface Tool (SMIT) in AIX 5L Version 5.2 System Management Concepts: Operating System and Devices.

System Dump Facility in AIX 5L Version 5.2 Kernel Extensions and Device Support Programming Concepts.