[ Previous | Next | Contents | Glossary | Home | Search ]
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, and you are asked whether you want to override the vary-on failure. In this case, 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 Forces the volume group to be made active even though the volume group definition may be different on the physical volumes.
-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 inital 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 easiliy 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

  1. To activate volume group vg03 , enter:
    varyonvg vg03
  2. 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.


[ Previous | Next | Contents | Glossary | Home | Search ]