Veritas Cluster Server Plug-in - Technical Reference

Introduction

This plug-in allows Geneos users to monitor the Veritas Cluster Server system, specifically information relating to service group and system status, resources used by service groups and the attributes of those resources, and heartbeat links status.

Information is extracted by running a number of Veritas executables and parsing their output.

Views

This plug-in creates 4 separate views.

Service Groups View

This view shows a summary of the service groups running on the system that the plugin runs on. The headline variables show information about the system itself.

veritas-cluster1

Service Groups Headline Legend

Name	Description
SystemState	Description1
SystemFrozen	Description2

Service Groups Table Legend

Name	Description
ServiceGroup	Name of the Service Group
Probed	State of the Probed Flag
AutoDisabled	State of the AutoDisabled Flag
State	State of the Service

Resources View Type

For each service group, a resources view will be produced, having details of the resources assigned to that particular service group and attribute values for each resource. By default, only the following attributes will be shown: ConfidenceLevel, IState, Probed, Start, State and Flags. (see section 3.1 on how to use the plugin configuration to modify this list)

The headlines show information about the system and the specific service group.

veritas-cluster3

Resources Headline Legend

Name	Description
SystemState	This is identical to the SystemState value in the Service Groups View
SystemFrozen	This is identical to the SystemFrozen value in the Service Groups View
ServiceGroupProbed	State of the Probed Flag
ServiceGroupAutoDisabled	State of the AutoDisabled Flag
ServiceGroupState	State of the Service

Heartbeat Links Status View

This view shows the heartbeat links status for the current system.

veritas-cluster4

Heartbeat Links Headline Legend

Name	Description
LLTStatus	Link Status

Heartbeat Links Table Legend

Name	Description
Link	Link Name
NodeState	NodeState (OPEN or CLOSED)
LinkState	LinkStatus (UP or DOWN)
Address	MAC Address

GAB Port Membership View

This view shows information on GAB port membership.

veritas-cluster5

GAB Port Membership Table Legend

Name	Description
Port	The GAB Port.
Gen	The generation number indicating a startup time.
Membership	The membership showing which LLT node IDs are participating.

Plug-in Configuration

The following parameters can be configured for this plug-in:

systemName

The name given by veritas to the system or host that the plugin is running on. This is used to filter out information that is not relevant to the current system.

Mandatory: Yes

hastatusCommand

This specifies the path to the Veritas command. This is required if the command name has changed or the command is not in the path accessible to the probe.

Mandatory: No

Default: hastatus

serviceGroupsAndResources

These settings control the service group and resources views.

serviceGroupsAndResources > hagrpCommand

This specifies the path to the Veritas command. This is required if the command name has changed or the command is not in the path accessible to the probe.

Mandatory: No

Default: hagrp

serviceGroupsAndResources > haresCommand

This specifies the path to the Veritas command. This is required if the command name has changed or the command is not in the path accessible to the probe.

Mandatory: No

Default: hares

serviceGroupsAndResources > showAllAttributes

Forces the resource views to show all attributes for the resources, ignoring the default list. The default list is specified in the Resources View Type.

serviceGroupsAndResources > showAllAttributesExceptGlobal

Forces the resource views to show all attributes for the resources (except the global ones), ignoring the default list. The default list is specified in the Resources View Type.

serviceGroupsAndResources > showAttributesFromList

Show the attributes in the default list. The default list is specified in the Resources View Type.

serviceGroupsAndResources > showAttributesFromList > additionalAttributes

This adds these attributes to the default list of attributes that is shown in the resources views. The default list is specified in the Resources View Type.

Mandatory: No

serviceGroupsAndResources > showAttributesFromList > excludeAttributes

This removes the listed attributes from the default list of attributes that is shown in the resources views. The default list is specified in the Resources View Type.

Mandatory: No

heartbeatLinks

These settings control the heartbeat links view

heartbeatLinks > lltconfigCommand

This specifies the path to the Veritas command. This is required if the command name has changed or the command is not in the path accessible to the probe.

Mandatory: No

Default: lltconfig

heartbeatLinks > lltstatCommand

This specifies the path to the Veritas command. This is required if the command name has changed or the command is not in the path accessible to the probe.

Mandatory: No

Default: lltstat

heartbeatLinks > showOnlyForThisSystem

Forces the heartbeat link status view to only show information relating to the particular system that the plugin is running on.

Mandatory: No

Default: False

gabPortMembership

These settings control the GAB Port Membership view

gabPortMembership > gabconfigCommand

This specifies the path to the Veritas command. This is required if the command name has changed or the command is not in the path accessible to the probe.

Mandatory: No

Default: gabconfig

Handling Authentication

If the Veritas Cluster Server has authentication enabled on the host, the Veritas Cluster Server plug-in may fail if the netprobe is being run by a non-root user. To enable the VCS plug-in to work in such a scenario, use the halogin command on the host to save the authentication information. With this command, the encrypted information (a .vscpwd file) will be stored in the user's home directory so that the user will not have to enter credentials every time a VCS command is run. The information is stored until the user ends the session.

The halogin command has the following format:

# halogin -user user@domain -passwrd user_password -domaintype domain_type

Option	Description
user	The format for the user is user@domain. If the domaintype=unixpwd then the domain should be a fully-qualified domain name.
password	The user password.
domaintype	Valid domain types are: "unixpwd" "nis" "nisplus" "ldap" "pam" "vx" (Symantec Private Domain) The default is "vx". Note The domain type is case sensitive.

Here is an example:

# halogin -user fred@pm.domain.com -passwrd unix_password_for_fred -domaintype unixpwd

Note: The lltconfig and gabconfig commands are not covered by this approach and these commands will need root permissions to run.

Please refer to your Veritas Cluster Server Command Reference Guide for more information.