Saturday, May 2, 2009

Testing JOPR 2.2.0 - Installation

What is JOPR, RHQ, JBoss ON
JOPR is an open source project from Redhat to develop complex management platform. JOPR is agent based JAVA/J2EE system, where agent is standalone JAVA running and server runs on top of JBOSS Application Server(AS). It can be used to manage JBOSS AS, Tomcat, Apache as well as Oracle, and any IT resources.

JBoss Operations Network (JBoss ON) is commercial offer of JOPR in form of support service by Redhat.

JOPR is developed on top of RHQ project. RHQ serves as an maven upstream project for JOPR. RHQ consists of GUI management console, agent container and a set of agent plugins for management of common IT resources.
JOPR extends RHQ by adding additional plugins for JBoss App Server, Tomcat Web Server, etc. . JOPR version 2.2.0 is corresponding with RHQ version 1.2.0.

The original of RHQ is Hyperic HQ. Redhat and Hyperic work together to extract common reusable parts of Hyperic HQ and maintain it as RHQ. The aim is to create a common infrastructure for developing management's application. That is why the project named RHQ, where R stand for Redhat.

Install JOPR Server
Download JOPR binary from JOPR website
Follow instruction in Installation Guide to prepare database server for JOPR server
Change working directory to jopr-server-2.2.0 and type
bin/rhq-server.sh start
then open web browser and point to http://localhost:7080
Follow instructions in screen to set database driver, url, username/password to correct values. After that verify database connection.
Hit button Install JOPR server to complete installation process

Modify JOPR server properties file for agent communication
Modify rhq-server.properties file
# jopr-server-2.2.0/bin/rhq-server.properties
rhq.communications.connector.transport=servlet
rhq.communications.connector.bind-address=<jopr-server-ip-address>
rhq.communications.connector.bind-port=7080
Restart JOPR server
bin/rhq-server.sh stop
bin/rhq-server.sh start
Login to JOPR console and watch its log file
Pointing Web browser to http://localhost:7080/Dashboard.do
Login use default rhqadmin/rhqadmin as initial username/password
JOPR log file is located in jopr-server-2.2.0/logs/rhq-server-log4j.log

Install JOPR Agent
This shall be done in all machines that we want JOPR to manage .
Download agent from http://<jopr-server-hostname>:7080/agentupdate/download
Install JOPR Agent by typing
java -jar rhq-enterprise-agent-1.2.0.jar --install
Modify JOPR Agent configuration file
#rhq-agent/conf/agent-configuration.xml

# ask jopr agent not to ask for configuration during startup
<entry key="rhq.agent.configuration-setup-flag" value="true" />

<entry key="rhq.agent.name" value="<jopr-agent-hostname>"/>

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

# ask jopr agent to listen to on particular ip
<entry key="rhq.communications.connector.bind-address" value="<jopr-agent-ip-address>" />
Start RHQ Agent and watch its log file
change working directory to rhq-agent and run
bin/rhq-agent.sh -c conf/agent-configuration.xml 
If we reinstall JOPR server then agent's local data and server'data is not in sync. In that case we shall ask agent to clean it's local data when start by using
bin/rhq-agent.sh -l -c conf/agent-configuration.xml 
The most recent agent's log file is located in rhq-agent/logs/agent.log

2 comments:

André said...

My 2 cents.

On the rhq-agent.sh script have a little mistake on the line 207. When you try to start the script a error occur. Unexpected error... The patch this remove the second equal "==" on the if statement.

Now , one question.

I recently install the latest version of jopr-server, and then configure the agent.

But when i start the agent it's take a hour, day, week and does not start.. i only have the message "The agent does not have plugins - it will now wait for them to be downloaded..." ..

do you know how can i fix this ??
thanks

Michi

Sonny Gill said...

Michi,

That is probably due to problems with the hostname/I.P. resolution.
See Heiko's comment on http://pilhuhn.blogspot.com/2008/08/rhq-tip-of-day-agent-waiting-at-startup.html