Configuring the RHQ Agent

The page Agent Design Documentation has information on different configurations you can do on the agent.

See the Agent Full Setup Prompts page that shows you all the agent setup prompts, along with their help text. This shows you all the configurable settings that are understood by the agent.

Pre-configuring Agents

When the agent starts up, it will prompt you for some initial configuration preference values. If you want to prepackage your own agent distribution with a custom set of preset configuration preferences, you can edit agent-configuration.xml located in the agent's conf directory setting all the preferences to your own values. To make sure the agent knows it is already set up and does not have to prompt the user the first time it starts up, be sure to set the configuration preference rhq.agent.configuration-setup-flag to true. When this is true, the agent will assume it is fully configured and will not ask setup questions when it starts up. However, you may wish to distribute agent configuration files with only a subset of configuration preferences set and rely on each agent's startup setup mechanism to finish its configuration - in this case, you'll want to leave this as false and let the user fill in the remaining configuration preference values then.