Starting a Veritas Cluster Server agent with haagent

  • Modified Date:
  • Article ID:000081901


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.




haagent - administer agents and processes that manage VCS resources


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




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


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


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.


Terms of use for this information are found in Legal Notices.



Did this article answer your question or resolve your issue?


Did this article save you the trouble of contacting technical support?


How can we make this article more helpful?

Email Address (Optional)