Starting a Veritas Cluster Server agent with haagent

Problem

If you receive a messages stating that an agent has failed, you can use the haagent command in an attempt to correct the issue by starting it.

Solution

haagent

NAME

haagent - administer agents and processes that manage VCS resources

SYNOPSIS

haagent -start agent -sys system

haagent -stop agent [-force] -sys system

haagent -display [agent(s)] [-attribute attribute(s)]

haagent -list [conditional(s)]

haagent -value agent attr

haagent \[-help [-list]]

AVAILABILITY

VRTSvcs

DESCRIPTION

The haagent command starts, stops, displays, and lists VCS agents. See NOTES for how to specify "-" and "%" characters in the command line.

OPTIONS

-start agent -sys system

Manually start an agent on the specified system. This is required only if the agent is stopped. Otherwise, the VCS server automatically starts agents.

-stop agent [-force] -sys system

Manually stop an agent on the specified system. Use the -force option to specify that the service groups continue to run.

-display [agent(s)] [-attribute attribute(s)]

Display information about all agents or about a specified agent. Use the -attribute option to specify the display of a resource attribute. The command displays agent information for the local system if a system is not specified.

-list [conditional(s)]

Displays a list of agents whose values match given conditional statement(s). Conditional statements can take three forms: Attribute=Value, Attribute!=Value, Attribute=~Value. Multiple conditional statements imply AND logic. If no conditional statement is specified, all agents in the cluster are listed.

-value agent attr

The -value option provides the value of a single agent attribute. For example, "hatype -value Mount Running" displays the value of the Running attribute for the Mount agent. The -value option is used instead of the -display option when one specific attribute value is needed rather than a table of many attribute values.

\[-help [-list]]

Displays information about using haagent. The -list option provides list specific help.

NOTES

The -start and -stop options enable you to debug custom agents without having to start and stop the VCS server.

When using the command to specify or modify an attribute's value that begins with a dash ("-"), precede the value with a percent sign ("%"). For example, specify -y as %-y. Likewise, precede a value that starts with a percent sign with another percent sign.