4.9. Starting the Agent

The agent is started and runs using a script in the agent's bin/ directory.


If the agent is installed with a JBoss ON server or a storage node, then it is managed using the rhqctl script in the server's bin/ directory.
All agents installed on managed systems are managed using the rhq-agent.sh script.
Unlike the server start script, which starts the server process and then exits the script, the agent script remains open, with a prompt to accept further input if necessary. (Usually, the script can simply be started and left to run in the background.)

RHQ 3.2.0-SNAPSHOT [cda7569] (Tue Apr 13 13:39:16 EDT 2013)
Most of the time, the JBoss ON agent can run without any additional options or settings. Additional configuration options can be set by editing the rhq-agent-env.sh script file or by using the -D and the property name with the rhq-agent.sh script. Changing the settings with the properties file and the start script is covered in the Configuring JBoss ON Servers, Agents, and Storage Nodes.


If there are any errors when starting the JBoss ON agent, run the agent start script with the --cleanconfig to wipe the previous agent configuration and start fresh.