vgState

The vgstate event producer can verify the status of the VG on a disk.

Overview

The vgState event producer resides under the disk directory. This event producer is available only when the system is part of a cluster. Whenever a local (registered with diskState) or cluster disk up or down event happens a corresponding VG_UP and VG_DOWN event is triggered for the volume group residing on that disk. Using this event producer, an application can verify the status of a VG on the disk, with the LVM subsystem.

Capabilities

AHAFS_THRESHOLD_STATE
AHAFS_REMOTE_EVENT_ENABLED
AHAFS_CALLBACK_INTRCNTX

Return codes

The vgState returns 0 as the return code. The AHAFS_CLUSTER_REMOVE (-1) is returned only if the cluster is removed.

Event producer message

This event producer passes VG_UP and VG_DOWN messages, as part of its event data. It will pass the concerned disk name and volume group name. Also, as this is a cluster event producer it will additionally pass NODE_NUMBER, NODE_ID and CLUSTER_ID information.

Acceptable monitor files

To monitor for changes in the list of nodes, a monitor file should be created under the vgState.monFactory directory. The monitor file name

/aha/disk/vgState.monFactory/vgStateEvent.mon

has to be used. No other monitor files may be created in this directory.

Example event data

The following is event data from a vgstate event with the default INFO_LVL.

BEGIN_EVENT_INFO
TIME_tvsec=1271915408
TIME_tvnsec=699408296
SEQUENCE_NUM=0
RC_FROM_EVPROD=0
BEGIN_EVPROD_INFO
EVENT_TYPE=VG_UP
DISK_NAME=hdisk3
VG_NAME=myvg
NODE_NUMBER=2
NODE_ID=0xF079E8C801C11DF
CLUSTER_ID=0x6EA7B08888D811DFB918BEB25635B404
END_EVPROD_INFO
END_EVENT_INFO