4.2. Installing the Agent from JAR File
- Point your browser to the download URL on the server. For example:
http://server.example.com:7080/agentupdate/downloadSave the agent binary update
.jarin a directory where you want to install the agent. The file you save should have a
- Copy the agent update binary
.jaryou downloaded from the JBoss ON server to the directory.
- Install the JAR:
java -jar downloaded_agent_jar_file.jar --installThis will tell the agent update binary to extract the JBoss ON agent distribution and install a fresh copy of it in the
ImportantDo not install the agent in a directory with spaces in the name, such as
C:\Program Files.Installing the agent in a directory with spaces in the pathname can cause problems for the agent establishing a connection with certain types of resources, including some JBoss services.
- Set the path to the JRE as an environment variable for the agent. The agent requires that the Java home directory is set explicitly in its configuration.Open the
agentRoot/rhq-agent/bin/rhq-agent-env.shfile, and uncomment or add the line for the
- Start the agent to launch the setup process.
NoteIt is possible to skip the setup wizard by submitting the configuration all at once. Section 4.3, “Silently Installing an Agent” has the details for setting up an file that can pass the configuration directly to the agent installer.
- As prompted, supply the information to configure the agent and the server connection.
[Agent Name] agentdomain.example.com [Agent Hostname or IP Address] agentdomain.example.com [Agent Port] 16163 [JON Server Hostname or IP Address] server.example.com [JON Server Port] 7080 native enable
The full list of parameters, including advanced setup options, are listed in Table 4.2, “All Options Available During Advanced Setup”.
- The agent name must be unique among all agents in the JBoss ON deployment. By default, the name is the fully-qualified domain name of the host machine.
- The port is the one that the agent uses to listen for incoming messages from the server. This is
rhq.agent.server.bind-portin the configuration file, if the default value isn't used.
- The server hostname and port are used by the agent to connect to a server to register itself with the JBoss ON system. This is not necessarily the primary server that the agent will use after registration. In the configuration file, these are
- Configure the agent as a background service, as in Section 4.4, “Running the JBoss ON Agent as a Service”.
agent-configuration.xmlis no longer needed or used. Editing
agent-configuration.xmlwill no longer have any effect on the agent, even after restarting the agent. To pick up changes to the
agent-configuration.xmlfile, the agent must be restarted with the
--cleanconfigcommand line option or the configuration must be reloaded with the
config --importagent prompt command.
Table 4.2. All Options Available During Advanced Setup
|Setup Option||Description||Normal or Advanced Setup|
|Agent Hostname or IP Address||The address that the binds to to listen for messages from the server. This is usually the same as the address that the JBoss ON server uses to connect to the agent; if the addresses are different because of the network environment, then transport parameters must be set to resolve the address.||Normal|
|Agent Port||The port number that the agent listens on. As with the IP address, this is usually the same as the port configured for the servers to use to connect to agents, but if these ports are different because of the network environment, then transport parameters must be set to resolve the port.||Normal|
|Agent Transport Protocol||Sets the protocol that the agent expects to use to receive incoming messages from the server. This is usually socket or sslsocket.||Advanced|
|Agent Transport Parameters||Sets transport parameters to append to the end of the locator (URL-style address) used by the remoting framework for agent-server connections.||Advanced|
|RHQ Server Hostname or IP Address||Gives the IP address or hostname of the primary server that the agent communicates with. This information must be the same as the hostname or IP address that is configured in the JBoss ON server configuration.||Normal|
|RHQ Server Port||Gives the port number of the primary server that the agent communicates with. This information must be the same as the port number that is configured in the JBoss ON server configuration.||Normal|
|RHQ Server Transport Protocol||Sets the transport protocol that the agent uses for outgoing messages to the JBoss ON server. This information must be the same as the transport method that the server is configured to expect in its configuration preferences.||Advanced|
|RHQ Server Transport Parameters||Gives additional transport parameters that are to be used when the agent connects to the primary JBoss ON server. Since this is used to connect to the server, these parameters must be the same as the transport parameters set in the JBoss ON server configuration. These settings are especially important if the JBoss ON agent needs to connect to a different host or port than what the JBoss ON server actually binds to.||Advanced|