HAAGENT (1M)

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 -dumpffdc agent -sys system

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.
-dumpffdc agent -sys system
  The agent dumps the First Failure Data Capture (FFDC) logs for the specified agent to the /var/VRTSvcs/diag/agents/type folder on the specified system.

If the agent encountered some problem and if the debug logging was not turned on, these FFDC logs can be used for root-cause analysis.

-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.

COPYRIGHTS

Copyright (c) 2009 Symantec.

All rights reserved.


VCS 5.1 HAAGENT (1M)