[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]

Commands Reference, Volume 3

migratepv Command


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


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


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.

Note: To use this command, you must 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 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.


-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.


  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.


/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.1 System Management Guide: Operating System and Devices.

Logical Volume Storage Overview in AIX 5L Version 5.1 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.1 Web-based System Manager Administration Guide.

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

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

[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]