2.4. Preparing for Installation on *nix Systems

2.4.1. Setting up the JDK for the JBoss ON Server

The JBoss ON server requires Java 6 or Java 7 JDK.
  1. Download and install the appropriate version of Java, if necessary.
  2. Set the JAVA_HOME environment variable to the installation directory.
    1. Open the .bashrc for the system user that will run JBoss ON. For example:
      vim /home/jon/.bashrc
    2. Add a line to set the JAVA_HOME environment variable to the specific JDK directory. For example:
      export JAVA_HOME=/usr/lib/jvm/java-1.6.0-openjdk-
  3. Set the system to use the correct version of the JDK using the system alternatives command. The selected version has the *+ symbols by it.
    /usr/sbin/alternatives --config javac
    There are 2 programs which provide 'javac'.
      Selection    Command
       1           /usr/lib/jvm/java-1.6.0-bea/bin/javac
    *+ 2           /usr/lib/jvm/java-1.6.0-openjdk/bin/javac
    Enter to keep the current selection[+], or type selection number:

2.4.2. Configuring NTP

Synchronize machine clocks. All JBoss ON servers and agents must have synchronized clocks. Clock variations cause issues in availability reporting, metric measurements, graphing, and even identifying and importing resources into inventory. The Network Time Protocol project, http://www.ntp.org/, has information on installing and configuring NTP to ensure your clocks are synchronized.

2.4.3. Configuring DNS

Both forward and reverse DNS mapping entries must be present for all systems for which host servers, storage nodes, and agents.
Every IP address must have a corresponding entry in the DNS server or must be explicitly defined in every /etc/hosts file for each system which is managed by JBoss ON or hosts a server or storage node.

2.4.4. Configuring Ports

Configure the firewall to allow communication over the server, agent, and storage node ports. If the required ports are blocked, then individual components will be unable to communicate with each other.
Using the default configuration, JBoss ON uses the ports listed in Table 2.2, “Default JBoss ON Ports”.

Table 2.2. Default JBoss ON Ports

Port Purpose
7080 Standard HTTP port for server-client communication
7443 HTTPS port for secure server-client communication
16163 For agent communication from the server
9142 For storage cluster communication
7299 For storage node JMX communication
7100 For the storage node gossip (node-to-node) communication