Home > Veritas Cluster Server Manual Pages


Maintenance Commands

Table of contents


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


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.


Copyright (c) 2008 Symantec.

All rights reserved.

Last updated: 07/03/2008
Copyright ©2009 Symantec Corporation
All rights reserved.