varyonvg Command

AIX Version 4.3 Commands Reference, Volume 6

varyonvg Command

Purpose

Activates a volume group.

Syntax

varyonvg [ -b ] [ -c ] [ -f ] [ -n ] [ -p ] [ -s ] [ -u ] VolumeGroup

Description

The varyonvg command activates the volume group specified by the VolumeGroup parameter and all associated logical volumes. A volume group that is activated is available for use. When a volume group is activated, physical partitions are synchronized if they are not current.

A list of all physical volumes with their status is displayed to standard output whenever there is some discrepancy between the Device Configuration Database and the information stored in the Logical Volume Manager. The volume group may or may not be varied on. You must carefully examine the list and take proper action depending on each reported status to preserve your system integrity. A list of every status and its meanings can be found in the lvm_varyonvg subroutine.

While varying on in concurrent mode, if the varyon process detects that there are logical volumes which are not previously known to the system, their definitions are imported. The permissions and ownership of the new device special files are duplicated to those of the volume group special file. If you have changed the permissions and/or ownership of the device special files of the logical volume on the node it was created, you will need to perform the same changes on this node.

If the volume group cannot be varied on due to a loss of the majority of physical volumes, a list of all physical volumes with their status is displayed. To varyon the volume group in this situation, you will need to use the force option.

The varyonvg will fail to varyon the volume group if a majority of the physical volumes are not accessible (no Quorum). This condition is true even if the quorum checking is disabled. Disabling the quorum checking will only ensure that the volume group stays varied on even in the case of loss of quorum.

The volume group will not varyon if there are any physical volumes in PV_MISSING state and the quorum checking is disabled. This condition is true even if there are a quorum of disks available. To varyon on in this situation either use the force option or set an environment variable MISSINGPV_VARYON to TRUE (set this value in /etc/environment if the volume group needs to be varied with missing disks at the boot time).

In the above cases (using force varyon option and using MISSINGPV_VARYON variable), you take full responsibility for the volume group integrity.

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

You can use the System Management Interface Tool (SMIT) to run this command. To use SMIT, enter:

smit varyonvg

Flags

-b	Breaks disk reservations on disks locked as a result of a normal varyonvg command. Use this flag on a volume group that is already varied on. This flag only applies to AIX Version 4.2 or later. Note: This flag unlocks all disks in a given volume group.
-c	Varies the volume group on in concurrent mode. This is only possible if the volume group is Concurrent Capable and the system has the HACAMP product loaded and available. If neither is true, the volume group will fail the varyon. This flag only applies to AIX Version 4.2 or later. If the varyon process detects that there is a new logical volume in the volume group whose name is already being used for one of the existing logical volumes, then the varyon will fail. You will need to rename the existing logical volume before attempting the varyon again.
-f	Allows a volume group to be made active that does not currently have a quorum of available disks. All disk that cannot be brought to an active state will be put in a removed state. At least one disk must be available for use in the volume group.
-n	Disables the synchronization of the stale physical partitions within the VolumeGroup.
-p	All physical volumes must be available to use the varyonvg command.
-s	Makes the volume group available in System Management mode only. Logical volume commands can operate on the volume group, but no logical volumes can be opened for input or output.
-u	Varies on a volume group, but leaves the disks that make up the volume group in an unlocked state. Use this flag as part of the initial varyon of a dormant volume group. This flag only applies to AIX Version 4.2 or later.

Attention: AIX Version 4.2 or later provides the flags -b and -u for developers who use n-tailed DASD systems. The base design of LVM assumes that only one initiator can access a volume group. The HACMP product does work with LVM in order to synchronize multi-node accesses of a shared volume group. However, multi-initiator nodes can easily access a volume group with the -b and -u flags without the use of HACMP. Your must be aware that volume group status information may be compromised or inexplicably altered as a result of disk protect (locking) being bypassed with these two flags. If you use the -b and -u flags, data and status output cannot be guaranteed to be consistent.

Examples

To activate volume group vg03, enter:
```
varyonvg vg03
```
To activate volume group vg03 without synchronizing partitions that are not current, enter:
```
varyonvg -n vg03
```

Files

/usr/sbin	Contains the varyonvg command directory.
/tmp	Stores the temporary files while the command is running.

Related Information

The chvg command, lspv command, lslv command, lsvg command, varyoffvg command.

The lvm_varyonvg subroutine.

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

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

AIX HACMP/6000 Concepts and Facilities.