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

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

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.