2.7. Basic Setup: Installing the Server on Linux

  1. Log into the system as root.
  2. Download the JBoss ON binaries from the Customer Support Portal.
    1. In the Customer Support Portal, click the Downloads tab, and then the Downloads icon in the page.
    2. Select the JBoss Operations Network link under the System Management area in the Downloads page.
    3. Download the JBoss Operations Network 3.2 Base Distribution package by clicking the Download icon.
    4. There are additional plug-in packs available for EAP, EDS, EWS, and SOA-P. If any of those plug-ins will be used with the JBoss ON server, then download them as well.
  3. Unzip the server distribution to the desired home directory for JBoss ON. For example:
    [root@server ~]# unzip jon-server-3.2.0.GA.zip -d /opt/jon
    This creates a version-specific installation directory, /opt/jon/jon-server-3.2.0.GA. A directory with this name should not exist prior to the unzip operation.
  4. Optional. By default, the script assumes that the backend database is a PostgreSQL server running on the same system as the server. Other settings — such as the database password, the server port numbers, the server name, and the way it handles database schema — use predefined defaults. One parameter, the bind address for the server, is empty and prompted by the control script.
    To change any of these defaults or to set additional information, edit the rhq-server.properties file. This is briefly covered in Section 2.6.2, “Attributes in the Properties File”.

    Note

    To configure JBoss ON to run as a service, see Running the JBoss ON Server as a Service in the Configuring JON Servers and Agents manual.

    Important

    It is recommended that you do not execute JBoss ON as a root user.
  5. Run the JBoss ON control script to configure the server and other services. If the rhq-server.properties file is not edited, then the script prompts for a bind address for the server; this can be set to 0.0.0.0.
    [root@server ~]# serverRoot/jon-server-3.2.0.GA/bin/rhqctl.sh install --start
    23:07:00,901 INFO  [org.jboss.modules] JBoss Modules version 1.2.2.Final-redhat-1
    
    The [jboss.bind.address] property is required but not set in [rhq-server.properties].
    Do you want to set [jboss.bind.address] value now?
    yes|no: yes
    jboss.bind.address: 0.0.0.0
    Is [0.0.0.0] correct?
    yes|no: yes
    This command does two things:
    • Configure the JBoss ON server, a storage node, and an agent.
    • Start all services when the configuration process is complete.
  6. It may take several minutes for the server process to start fully. Afterward, log into the server web UI to begin configuring resources.
    The default administrator username and password are rhqadmin/rhqadmin. The server URL is http://hostname:7080. For example:
    http://server.example.com:7080