JBoss.orgCommunity Documentation
Ensure that the following requirements have been met before continuing with the install.
Once unzipped, the JBoss Operations Network binary release requires at least 300MB of free disk space. Keep in mind that disk space requirements may change from release to release.
The JBoss Operations Network platform will run on the same hardware that the JBoss Enterprise Application Platform runs on, but it is recommended at least 2GB or 4GB of RAM memory, for 32 or 64 bit Operating Systems.
A working installation of the Java Development Kit (JDK) version 5 or higher is required in order to run the JBoss Operations Network. Note that JBoss Enterprise Application Platform is a runtime dependency, but comes bundled with the binary distribution.
For instructions on how to install the JDK, refer to Appendix A, Java Development Kit (JDK): Installing, Configuring and Running.
In order to run JBoss Operations Network, an external database must be installed.
JBoss Operations Network is distributed with a Java embedded database called "H2", so if you are just running JBoss Operations Network to test it out and play with it, you can use that and not install an external database. But this Embedded H2 database is to be considered only for demo'ing and testing purposes. For production systems, you will need to install an external database.
The supported databases are:
Postgres versions 8.2.4 and higher are supported.
Oracle versions 10g and 11g are supported.
After installing the database, make note of the JDBC URL, username and password for the database. This information is required during the JBoss Operations Network Server installation.
JBoss Operations Network is based on and plugin-compatible with the multi-vendor RHQ management project. For the JBoss Communications Plugin to work correctly, version 1.4.x of RHQ is required.
Since there's no released version of JBoss Operations Network based on RHQ 1.4.x yet, RHQ itself will be used instead.
Download RHQ Server from SourceForge. This is the platform server, which will be responsible for storing, processing and presenting the data received by the agent(s).
Unzip the distribution in a suitable place (i.e. in a directory not too deeply nested and with no spaces or non-ASCII characters in its name)
This step is optional, if you're using Embedded H2 Database, you can skip to next
Install a database like PostgreSQL (version 8.2.4 +, please choose C locale for initdb), create a database instance called 'rhq' in it and a user 'rhqadmin' that owns this 'rhq' database.
create user rhqadmin password 'rhqadmin'; create database rhq owner rhqadmin;
Eventually set RHQ_SERVER_JAVA_HOME or RHQ_SERVER_JAVA_EXE_FILE_PATH env variables appropriately. This is needed if your JAVA_HOME does not point to a java installation that is valid with JBoss Operations Network (e.g. JAVA 1.4); JBoss Operations Network requires JAVA 5+.
In a terminal console, cd into the installation directory and start the Server:
bin/rhq-server.[sh|bat] console
After a few seconds, the messages on the console will stop. When this happens, point your browser to http://localhost:7080/ and run the installer:
Click on Click here to continue the installation
Choose your desired and installed database from the Database Type drop down list. If you don't want to install/use an external Database, choose H2 (embedded).
Default settings should be fine to install the server correctly. To test the DB connection, please click
button.If the rhqadmin.
button was used, make sure that the field is still filled, as some browsers lose the data in there. Default password isReview the seleceted settings, click
and wait for it to complete.Click on
when the progress bar stops.Log in (default user/password are: rhqadmin/rhqadmin), it is time to download and install the Agent.
The Agent is the component where our plugin will be running at. It is responsible for communicating with the managed resource (in this situation, the JAIN SLEE Server) to obtain vital data (eg: availability), metrics, operations execution, etc. and report back to the Server, who will process and display that data.
To download it, follow these steps:
Click on
→ .Click on Download Agent Installer and save it to where you wish to have it installed.
In a second terminal console, cd into the directory containing the downloaded jar and install it:
java -jar <agent-download.jar> --install[=<new agent dir>]
The optional parameter, new agent dir
indicates where the files will be installed, and defaults to the path where the jar is at.
cd into the newly created rhq-agent directory and start the Agent by issuing:
bin/rhq-agent.[sh|bat]
Answer the questions asked by the Agent, if any. Default setting should be sufficient.
There should be a console with a '> ' prompt. Don't close it, leave it running, it's the agent who will perform all the work.
For more detailed and up to date information, visit the JBoss Operations Network installation instructions.
JBoss Communications JAIN SLEE Plugin is the interface between JBoss Operations Network and JBoss Communications JAIN SLEE. It is responsible for gathering data from SLEE and transform it to JBoss Operations Network format. It is an agent plugin, since it runs on the agent side.
JBoss Communications JAIN SLEE Plugin, may be installed in two ways:
In the JBoss Operations Network GUI, in the top menu, head to
→ → :On the Agent Plugins tab (selected by default), on the bottom of the page, click , browse to the JBoss Operations Network plugin JAR file and select it. It will be listed for upload, as it can be seen in the following figure:
Finally, click the
button and the plugin will be deployed. Click and it should be shown in the list as "Mobicents JSLEE Server 2.x".If the agent is not running, start it and it will automatically download the new plugin. If it was already running, you should run the following command in it's console to download/update the plugin:
> plugins update
The plugin can be deployed simply by copying it to the right folder, by following these steps:
Stop the JBoss Operations Network server and agent if they are running.
Copy the mobicents-slee-jopr-as-5-plugin-<version>.jar to the jopr-server/jbossas/server/default/deploy/rhq.ear/rhq-downloads/rhq-plugins/ directory, and it will be automatically deployed.
Start the JBoss Operations Network server.
Start the JBoss Operations Network agent.
After the plugin is installed, the server must be added to the managed resources. Choose
→ :Please make sure that the JAIN SLEE Server is running at this time, otherwise it won't be shown under Auto Discovery.
If the JAIN SLEE Server is running but not shown in the list, issue the following commands in th Jopr Agent console:
> plugins update ... > discovery
Back in the web console, refresh the Auto Discovery view and it should be present!
Check the option referring to JAIN SLEE Server (as in the figure below), and click
button.Now the server is being can be managed and monitored with JBoss Operations Network.