Chapter 2. Installing JBoss Web Server on Red Hat Enterprise Linux

You can install Red Hat JBoss Web Server on Red Hat Enterprise Linux using one of two methods:
  • ZIP files
  • RPM packages
Regardless of which method you choose, you must first install a supported Java Development Kit (JDK).

2.1. Prerequisites

2.1.1. Installing a Java Development Kit (JDK)

Before installing Red Hat JBoss Web Server, you must first install a supported Java Development Kit (JDK).

Procedure 2.1. Installing a Java Development Kit (JDK)

  1. Subscribe your Red Hat Enterprise Linux system to the appropriate supplementary channel:
    • Red Hat Enterprise Linux Server Supplementary for Red Hat Enterprise Linux 6
    • Red Hat Enterprise Linux Server Supplementary for Red Hat Enterprise Linux 7
  2. As the root user, execute the command to install a 1.7 or 1.8 JDK:
    • # yum install java-1.7.0-<VENDOR>-devel
      Replace <VENDOR> with oracle, ibm, or openjdk.
    • # yum install java-1.8.0-<VENDOR>-devel
      Replace <VENDOR> with oracle, ibm, or openjdk.
  3. Run the following commands as the root user to ensure the correct JDK is in use:
    # alternatives --config java
    # alternatives --config javac
    These commands return lists of available JDK versions with the selected version marked with a plus (+) sign. If the selected JDK is not the desired one, change to the desired JDK as instructed in the shell prompt.

    Important

    All software that use the java and javac commands uses the JDK set by alternatives. Changing Java alternatives may impact on the running of other software.

2.1.2. Red Hat Enterprise Linux Package Prerequisites

Before installing Red Hat JBoss Web Server on Red Hat Enterprise Linux, ensure the following prerequisites are met.
  • A supported version of Java is installed. See Section 2.1.1, “Installing a Java Development Kit (JDK)”.
  • The following required packages are installed for Red Hat Enterprise Linux 6:
    • krb5-workstation
    • elinks
    • mailcap. The mailcap package contains /etc/mime.types, which is used by httpd for MIME type mapping extensions. This package is not included in Red Hat Enterprise Linux and must be included.
  • The following required packages are installed for Red Hat Enterprise Linux 7:
    • apr
    • apr-devel
    • apr-util
    • apr-util-devel
    • apr-util-ldap
    • elinks
    • krb5-workstation
    • mailcap
  • You must remove the tomcatjss package before installing the tomcat-native package. The tomcatjss package uses an underlying NSS security model rather than the OpenSSL security model.

Procedure 2.2. Removing the tomcatjss Package

  • As the root user, run the following command to remove tomcatjss:
    # yum remove tomcatjss

Procedure 2.3. Installing Required Packages

  • For your version of Red Hat Enterprise Linux, run the install command below as the root user:
    • For Red Hat Enterprise Linux 6:
      # yum install krb5-workstation elinks mailcap
    • For Red Hat Enterprise Linux 7:
      # yum install apr apr-devel apr-util apr-util-devel apr-util-ldap elinks krb5-workstation mailcap