migratepv Command
Last Updated: 2023-03-24
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.Note:
- 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.
- Running this command on a physical volume that has an active, firmware-assisted, dump logical volume temporarily changes the location of the dump device to /dev/sysdumpnull. After you have successfully migrated the logical volume, this command calls the following command to set the firmware-assisted, dump logical volume to the original logical volume.
sysdumpdev -P
The allocation of the new physical partitions follows the policies defined for the logical volumes that contain the physical partitions being moved.
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 System Management Interface Tool (SMIT) smit migratepv fast path to run this command.
Flags
Item | Description |
---|---|
-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:
Physical partitions are moved from one physical volume to two others within the same volume group.migratepv hdisk1 hdisk6 hdisk7
- 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
Item | Description |
---|---|
/usr/sbin | Directory where the migratepv command resides. |
/tmp | Directory where the temporary files are stored while the command is running. |