Commands Reference, Volume 4

replacepv Command

Purpose

Replaces a physical volume in a volume group with another physical volume.

Syntax

replacepv [ -f ] {SourcePhysicalVolume | SourcePhysicalVolumeID } DestinationPhysicalVolume

replacepv [ -R ] dir_name [ DestinationPhysicalVolume ]

Description

The replacepv command replaces allocated physical partitions and the data they contain from the SourcePhysicalVolume to DestinationPhysicalVolume. The specified source physical volume cannot be the same as DestinationPhysicalVolume.

Notes:

The DestinationPhysicalVolume size must be at least the size of the SourcePhysicalVolume.
The replacepv command cannot replace a SourcePhysicalVolume with stale logical volume unless this logical volume has a non-stale mirror.
The replacepv 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 replaced.

Flags

-f	Forces to replace a SourcePhysicalVolume with the specified DestinationPhysicalVolume unless the DestinationPhysicalVolume is part of another volume group in the Device Configuration Database or a volume group that is active.
-R dir_name	Recovers replacepv if it is interrupted by <ctrl-c>, a system crash, or a loss of quorum. When using the -R flag, you must specify the directory name given during the initial run of replacepv. This flag also allows you to change the DestinationPhysicalVolume.

Security

Access Control: You must have root authority to run this command.

Examples

To replace physical partitions from hdisk1 to hdisk6, enter:
```
replacepv hdisk1 hdisk6
```

Files

/usr/sbin	Directory where the replacepv command resides.
/tmp	Directory where the temporary files are stored while the command is running.

Related Information

The migratepv command.

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