Red Hat Training

A Red Hat training course is available for Red Hat JBoss Web Server

Chapter 3. Installing Enterprise Web Server on Red Hat Enterprise Linux

On Red Hat Enterprise Linux, you can install JBoss Enterprise Web Server in two ways:

Warning

RPM installation shares Java library files. Library version conflicts occcur when Enterprise Web Server coexists with the Enterprise Application Platform and both were installed from RPM packages. To workaround the issue, install one software with RPM, and the other from a ZIP file.

3.1. Prerequisites

Before installing JBoss Enterprise Web Server on Red Hat Enterprise Linux, ensure the following:

Procedure 3.1. Installing Java

Follow this procedure to install and set up a supported Java version:
  1. Subscribe your system to the appropriate channel:
    • RHEL Server Supplementary for Red Hat Enterprise Linux 6
    • RHEL Supplementary for Red Hat Enterprise Linux 5
    • Extras for Red Hat Enterprise Linux 4
  2. On the command line, as the root user run the command to install Java 1.6:
    • On Red Hat Enterprise Linux 5 and Red Hat Enterprise Linux 6, execute the yum install command: 
      # yum install java-1.6.0-<VENDOR>-devel
      Substitute <VENDOR> with sun, ibm, or openjdk.
    • On Red Hat Enterprise Linux 4, execute the up2date command: 
      # up2date java-1.6.0-<VENDOR>-devel
      Substitute <VENDOR> with sun or ibm.
  3. Run the following commands as the root user (if switching from another user, make sure to run the command su -) to make sure the correct JDK is in use: 
    # alternatives --config java
    # alternatives --config javac
    These commands return lists of available JDK versions with the version in use marked with a plus (+) sign. If the set JDK is not the desired option, switch to the right JDK as instructed on the command line.

    Important

    Any software that makes use of the java and javac commands is using the JDK set by alternatives. Switching java alternatives may negatively influence running of such software.
  4. Install the required packages (refer to Procedure 3.2, “Installing Required Packages”)

Procedure 3.2. Installing Required Packages

If you are using a system registered with Red Hat Network and subscribed to the appropriate channel, you may either mount a repository with the packages or install them from the online repository. Follow this procedure to install the packages from the online repository.
Follow this procedure to install the required packages from the online repository:
  1. Depending on your operating system version, run the respective installation command as the root user:
    • On Red Hat Enterprise Linux 6 and 5: 
      # yum install distcache pcre
    • On Red Hat Enterprise Linux 4: 
      # up2date distcache pcre
  2. When prompted, press y to proceed.
  3. When the installation is complete, run the following command to check that the packages are installed: 
    # rpm -q distache pcre
    If the packages are installed, the command output shows the package names with their version numbers.
  4. Install JBoss Enterprise Web Server either from a ZIP file (Section 3.2, “Installing Enterprise Web Server from a ZIP File”) or from RPMs (Section 3.3, “Installing Enterprise Web Server from RPM Packages”).

Procedure 3.3. Removing classpathx-jaf

Follow this procedure to uninstall the classpathx-jaf package.
  1. At the shell prompt, become the root user.
  2. Depending on your Red Hat Enterprise Linux version, run the respective command to uninstall the package:
    • On Red Hat Enterprise Linux 5 and 6: 
      # yum remove classpathx-jaf
    • On Red Hat Enterprise Linux 4: 
      # rpm -e classpathx-jaf