6.3. Silently Installing an Agent
All of the agent configuration is written to and loaded from the
agent-configuration.xml file. During installation, there are some parameters that are predefined and others that are environment-specific and must be provided. The agent setup prompts request this environment or instance-specific information.
However, it is possible to supply that required information before running the agent for the first time. Since all of the required information is supplied, the agent does not prompt for it; it simply starts.
- Copy the
agent-configuration.xmlfile to a working directory. For example:[jsmith@server ~]$ cp agentRoot/rhq-agent/conf/agent-configuration.xml /tmp/files/
- Uncomment (if necessary) and edit the desired agent parameters.Any agent parameters (such as SSL connections and other advanced configuration) can be defined in
agent-configuration.xml. At a minimum, the entry keys listed in Table 6.3, “Configuration File Keys for Agent Setup” for the agent and server have to be set in the file.[jsmith@server ~]$ vim /tmp/files/agent-configuration.xml ... <!-- agent properties --> <entry key="rhq.agent.name" value="agent.example.com"/> <entry key="rhq.communications.connector.bind-address" value="255.255.255.1" /> <entry key="rhq.communications.connector.bind-port" value="16163" /> <!-- server properties --> <entry key="rhq.agent.server.bind-address" value="255.255.255.0" /> <entry key="rhq.agent.server.bind-port" value="7080" /> <entry key="rhq.agent.disable-native-system" value="false"/> ...
- Set the
rhq.agent.configuration-setup-flagkey to true so that the agent loads it as initial configuration.<entry key="rhq.agent.configuration-setup-flag" value="true" />
- Start the agent, specifying the edited configuration file with the
--configoption>.[jbossadmin@server !]$ agentRoot/rhq-agent/bin/rhq-agent.sh
--config /tmp/files/agent-configuration.xml
| Installer Prompt Text | Key Name | Description |
|---|---|---|
| rhq.agent.configuration-setup-flag | Tells the installer that the agent configuration is already in the configuration file. This must be set to true for the installer to load the configuration file. | |
| [Agent Name] | rhq.agent.name | Gives a unique name to identify the agent to the server. |
| [Agent Hostname or IP Address] | rhq.communications.connector.bind-address | Gives the hostname or IP address that the server will use to connect to the agent. This <entry> line may need to be uncommented before it is set. |
| [Agent Port] | rhq.communications.connector.bind-port | Gives the port for the server to use to communicate with the agent. The default (16163) can be used in most cases. |
| [RHQ Server Hostname or IP Address] | rhq.agent.server.bind-address | Gives the hostname or IP address that the agent will use to connect to the server to register itself. If this is a hostname, it must be resolvable by the agent. |
| [RHQ Server Port] | rhq.agent.server.bind-port | Gives the port for the agent to use to communicate with the server. The default (7080) can be used, assuming the server was configured with the default values. |
| native | rhq.agent.disable-native-system | Enables the JNI libraries used by the agent. This enables the agent to discover and manage some types of resources using the system native libraries. |
