Red Hat Training

A Red Hat training course is available for Red Hat JBoss Operations Network

2. JBoss Operations Network Prerequisites and Basic Installation

2.1. Software and Hardware Requirements

The list of supported platforms for JBoss Operations Network are listed at https://access.redhat.com/knowledge/articles/112523.
Regardless of the server or database platform, there are certain minimum requirements that must be met to install the JBoss ON server and its associated database.

Table 1. Recommended Minimum Hardware

Minimum
Memory 2 GB
Installation Directory Storage[a] 10 GB
Temporary Directory Storage 10 GB
[a] The server runs as a system user. Make sure that any system limits on user memory are set high enough to accommodate the JBoss ON server and all its data.

2.2. Installing JBoss Operations Network 3.1.2

The Installation Guide has more information on configuration databases for the JBoss ON server, upgrading servers, and other installation information. This is a quick summary of performing an initial installation.
  1. Set up a database named rhqadmin and a database user named rhqadmin. Make sure the database user has adequate permissions to perform operations on the JBoss ON database.
  2. Stop any currently running JBoss ON instances. 
    serverRoot/jon-server-3.1.2.GA/bin/rhq-server.sh stop
    If the new JBoss ON server will use a database that existing JBoss ON instances are also using, then all of the existing JBoss ON instances have to be stopped. Otherwise, the installer will hang when it tries to contact the database and the database is unavailable because it is in use by another JBoss ON server.
  3. Download the server packages from the Red Hat Customer Portal.
    1. Open the Downloads tab in the top menu, and click the Downloads link under the JBoss Enterprise Middleware section.
    2. In the Product field, select the JBoss Operations Network product.
    3. Set the version to 3.1.2.
    4. Click the Download link for the base distribution and save the package to the appropriate location on the local system.
  4. Unzip the server distribution to the directory where it will be executed from. For example: 
    cd /opt

unzip jon-server-3.1.2.GA.zip
    This creates a jon-server-3.1.2.GA/ directory in your chosen installation root.
  5. Run the JBoss ON server: 
    serverRoot/jon-server-3.1.2.GA/bin/rhq-server.sh start
  6. Open the server UI, which initially displays the JBoss ON server installer. 
    http://server.example.com:7080
  7. Clicking the Click here to continue the installation link brings you to the main installer page.
  8. Go through the installer and fill in the information. Advanced settings can be exposed in the form.
    The main installer page appears different depending on the database settings.
  9. Install any additional agent plug-ins. Plug-in packs are available for all JBoss products:
    • Enterprise Application Platform (EAP)
    • Enterprise Business Rules Management System (BRMS)
    • Data Grid (JDG)
    • Enterprise Data Services Platform (EDS-P)
    • Enterprise Portal Platform (EPP)
    • SOA Platform (SOA-P)
    To install a plug-in pack, extract the JAR files and copy them into the JBoss ON server deployment directory, plugins/: 
    [root@server ~]# cd /tmp
[root@server ~]# unzip jon-plugin-pack-agent_plugin_name-3.1.2.GA.zip
[root@server ~]# cp jon-plugin-pack-agent_plugin_name/*.jar /opt/jon/jon-server-3.1.2.GA/plugins
    The server will detect and deploy the new plug-ins after a couple of minutes.