clvaryonvg command

Purpose

Varies on a volume group.

Syntax

clvaryonvg [-F] [-f] [-n] [-p] [-s] [-o] <vg>

Description

The clvaryonvg command is designed as a replacement for the varyonvg command that is part of the AIX® operating system. This command performs some checks on the volume group to determine if there are any changes were made to the volume group before calling the AIX varyonvg command. If any changes have been made since the last time the volume group was varied on locally, the volume group is exported and then imported before it is varied on. This process verifies that all nodes have a consistent view of the content for the volume group.

If a system failure occurs during a volume group update, the volume group can become invisible to the node. The following mechanisms are implemented to safeguard against a system failure:

Before you export a volume group, a file is created in the /usr/es/sbin/cluster/etc/vg directory that is called <VG>.replay, where VG is the name of the volume group. This file is a shell script that contains a set of commands to restore the volume group if it becomes invisible to the node or does not exist. If the volume group does not exist, the commands in the <VG>.replay file are automatically run the next time that you use the clvaryonvg command.
If the replay file does not fix the problem, you can view the messages in the hacmp.out file. These messages explain how to manually restore the volume group. The messages in the hacmp.out file can also be found in the /usr/es/sbin/cluster/etc/vg/<VG>.desc file, where VG is the name of the volume group. A copy of the failed replay file is placed in the /var/tmp directory.

Flags

-f: Passes the flag to the importvg command or the varyonvg command.
-F: Forces an update by using the exportvg command or the importvg command on the volume group and ignoring the time stamp.
-n: Disables the synchronization of the stale physical partitions within the volume group. This flag is passed to the varyonvg command.
-p: Specifies that all physical volumes must be available to use the clvaryonvg command.
-s: Makes the volume group available only in system management mode.
-o: Leaves the volume group varied off after completion. The completion process includes performing all the integrity checks, and if required, running the importvg command and the exportvg command.

Examples

To activate volume group that is labeled vg03, enter:
```
clvaryonvg vg03
```
To force the update of a node's information on volume group that is labeled vg03, enter:
```
clvaryonvg -F vg03
```