JON Agent installation

Prerequisite:

Install JRE6 Runtime environment

Download jre-6u18-linux-i586.bin from Sun website.

Copy to the install folder /opt

#./jre-6u18-linux-i586.bin

This should install JRE under directory jre1.6.0_18

1) Download agent from installed JON server

http://{ip_address}:7080/agentupdate/download

or Copy the file from JON Server location

/opt/jon-server-2.3.1.GA/jbossas/server/default/deploy/rhq.ear/rhq-downloads/rhq-agent/rhq-enterprise-agent-1.3.1.GA.jar

Save the file rhq-enterprise-agent-1.3.1.GA.jar to /opt/software on JBOSS server

2) Install agent

# cd /opt/software

#java -jar rhq-enterprise-agent-1.3.1.GA.jar --install=/opt

3) Setup agent configuration

Edit /opt/rhq-agent/conf/agent-configuration.xml

Update the following with correct JON server address

Uncomment the following lines and edit the values to read as:

<entry key="rhq.agent.configuration-setup-flag" value="true" />

<entry key="rhq.agent.server.bind-address" value="{jon-server-ip-address}" />

<entry key="rhq.agent.agent-update.version-url" value="http://{jon-server-ip-address}:7080/agentupdate/version" />

<entry key="rhq.agent.agent-update.download-url" value="http://{jon-server-ip-address}:7080/agentupdate/download" />

<entry key="rhq.agent.agent-update.version-url" value="http://{jon-agent-ip-address}:7080/agentupdate/version" />

<entry key="rhq.communications.connector.bind-address" value="{jon-agent-ip-address}" />

Optional line to uncomment.

<entry key="rhq.agent.name" value="{agent-name}"/>

Optional lines to uncomment. These two lines should be done together preferably and multicast should be supported by the network.

<entry key="rhq.agent.server-auto-detection" value="true" />

<entry key="rhq.communications.multicast-detector.enabled" value="true" />

cd /opt/rhq-agent/bin

./rhq-agent.sh --config ../conf/agent-configuration.xml

If the setup flag is enabled as above, check agent logs.

If the setup flag is not enabled as above, you will see the following:

Agent Name [agent-server-name] :

Agent Hostname or IP Address [!*] :

Agent Port [16163] :

RHQ Server Hostname or IP Address [jon-server-name] :

RHQ Server Port [7080] :

Leave the above values to default as you have already edited agent config.

3) Check agent.log for messages

4) Start or stop agent in background

/opt/rhq-agent/bin/rhq-agent-wrapper.sh start

/opt/rhq-agent/bin/rhq-agent-wrapper.sh stop

/opt/rhq-agent/bin/rhq-agent.sh start

/opt/rhq-agent/bin/rhq-agent.sh stop

5) Update /opt/rhq-agent/bin/rhq-agent-env.sh to run the process in foreground or background with desired parameters