3.7. Basic Setup: Installing the Server on Linux

Procedure 3.2. 

1. Download the JBoss ON binaries from the Customer Support Portal.
   1. In the Customer Support Portal, click the Downloads tab to open the Product Downloads page.
   2. Select the Red Hat JBoss Operations Network link under the JBoss Development and Management to access the Software Downloads page.
   3. Download the Red Hat JBoss Operations Network 3.3 Base Distribution package by clicking the Download link.
   4. There are additional plug-in packs available for use with the JBoss ON server, accessable by using the Product drop-down menu. Plug-ins include:
      • Red Hat JBoss Enterprise Application Platform (JBoss ON for EAP),
      • Red Hat JBoss Enterprise Data Services (JBoss ON for EDS),
      • Red Hat JBoss Enterprise Web Server (JBoss ON for EWS), and
      • Red Hat JBoss Service Oriented Architecture Platform (JBoss ON for SOA-P).
2. Unzip the server distribution to the desired home directory for JBoss ON. For example:

   [jsmith@server ~]$ unzip jon-server-3.3.2.GA.zip -d /path/to/install_dir/

   This creates a version-specific installation directory, /path/to/jon-server-3.3.2.GA. Ensure that no directory with this name already exists prior to the unzip operation.
3. 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 3.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.
4. 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 an administration password and a bind address for the server; this can be set to 0.0.0.0 and for rhq.autoinstall.server.admin.password.

   [jsmith@server ~]$ serverRoot/jon-server-3.3.2.GA/bin/rhqctl install --start
   06:21:40,773 INFO  [org.jboss.modules] JBoss Modules version 1.3.3.Final-redhat-1
   
   The [rhq.autoinstall.server.admin.password] property is required but not set in [rhq-server.properties].
   Do you want to set [rhq.autoinstall.server.admin.password] value now?
   yes|no: yes
   rhq.autoinstall.server.admin.password (enter as plain text): 
   Confirm:
   rhq.autoinstall.server.admin.password (enter as plain text): 
   
   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:
   • It configures the JBoss ON server, a storage node, and an agent.
   • It starts all services when the configuration process is complete.
5. It may take several minutes for the server process to start. Once started, the web-based user interface for the JBoss ON server can be accessed to configure resources via a web browser using the server URL http://hostname:7080. For example:

   http://server.example.com:7080

   or http://localhost:7080 for local installs.
   The username is rhqadmin and the password is the value set when running the installation program in the previous step, or configured manually by altering the value for rhq.autoinstall.server.admin.password in the rhq-server.properties file as described in Section 3.6.2, “Attributes in the Properties File”.