chpv Command

Commands Reference, Volume 1

chpv Command

Purpose

Changes the characteristics of a physical volume in a volume group.

Syntax

chpv [ -a Allocation ] [ -v Availability ] [ -c ] PhysicalVolume ...

Description

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

The chpv command changes the state of the physical volume in a volume group by setting allocation permission to either allow or not allow allocation and by setting the availability to either available or removed. This command can also be used to clear the boot record for the given physical volume. Characteristics for a physical volume remain in effect unless explicitly changed with the corresponding flag.

Note: To use this command, you must either have root user authority or be a member of the system group.

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

Flags

-a Allocation

Sets the allocation permission for additional physical partitions on the physical volume specified by the PhysicalVolume parameter. Either allows (yes) the allocation of additional physical partitions on the physical volume, or prohibits (no) the allocation of additional physical partitions on the physical volume. The Allocation variable can be either:

y: Allows the allocation of additional physical partitions on the physical volume.

n: Prohibits the allocation of additional physical partitions on the physical volume. The logical volumes that reside on the physical volume can still be accessed.

-c

Clears the boot record of the given physical volume.

-v Availability

Sets the availability of the physical volume. If you set the availability to closed, logical input and output to the physical volume are stopped. You should close a physical volume when the physical volume is removed from operation. Access to physical volume data by the file system or the virtual memory manager is stopped, but you can continue to use the system management commands. The Availability variable can be either:

a: Makes a physical volume available for logical input and output.

r: Makes a physical volume unavailable (removed) for logical input and output. If the physical volume is required in order to maintain a volume group quorum, an error occurs and the physical volume remains open.

Examples

To close physical volume hdisk03, enter:
```
chpv -v r hdisk03
```
The physical volume is closed to logical input and output until the -v a flag is used.
To open physical volume hdisk03, enter:
```
chpv -v a hdisk03
```
The physical volume is now open for logical input and output.
To stop the allocation of physical partitions to physical volume hdisk03, enter:
```
chpv -a n hdisk03
```
No physical partitions can be allocated until the -a y flag is used.
To clear the boot record of a physical volume hdisk3, enter:
```
chpv -c hdisk3
```

Files

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

Related Information

The lspv command.

The Logical Volume Storage Overview in AIX Version 4.3 System Management Concepts: Operating System and Devices explains the Logical Volume Manager, physical volumes, logical volumes, volume groups, organization, ensuring data integrity, and understanding the allocation characteristics.

Setting up and running Web-based System Manager in AIX Version 4.3 System Management Guide: Operating System and Devices.

The System Management Interface Tool (SMIT): Overview in AIX Version 4.3 System Management Concepts: Operating System and Devices explains the structure, main menus, and tasks that are done with SMIT.

AIX HACMP/6000 Concepts and Facilities.