Home > Veritas Cluster Server Manual Pages

HAAGENT (1M)

Maintenance Commands

NAME
SYNOPSIS
AVAILABILITY
DESCRIPTION
OPTIONS
NOTES
COPYRIGHTS

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. The -force option stops the agent even if the resources for the agent are online. You can use the -force option when you want to upgrade an agent without taking its resources offline.
-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.