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

1. Subscribe your Red Hat Enterprise Linux system to the appropriate channel:

   • OpenJDK:

     • rhel-6-server-rpms
     • rhel-7-server-rpms

   • IBM:

     • rhel-6-server-supplementary-rpms
     • rhel-7-server-supplementary-rpms

2. As the root user, execute the command to install a 1.8 JDK:

   # yum install java-1.8.0-<VENDOR>-devel

   Replace <VENDOR> with 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.

Removing the tomcatjss Package

1. As the root user, run the following command to remove tomcatjss:

   # yum remove tomcatjss

1. Open a browser and log in to the Red Hat Customer Portal.
2. Click Downloads.
3. Click Red Hat JBoss Web Server in the Product Downloads list.
4. Select the correct JBoss Web Server version from the Version drop-down menu.

5. Click Download for each of the following files, ensuring that you select the correct platform and architecture for your system:

   • The Red Hat JBoss Web Server 5.0 Application Server (jws-application-servers-5.0.0.zip).
   • The Red Hat JBoss Web Server 5.0 Native Components for RHEL (jws-application-servers-5.0.0-<platform>-<architecture>.zip).

6. Unzip the downloaded ZIP files to your installation directory.

   For example:

   # unzip jws-application-server-5.0.0.zip -d /opt/
   # unzip -o jws-application-server-5.0.0-<platform>-<architecture>.zip -d /opt/

1. Log in to the Red Hat Subscription Manager.
2. Click on the Systems tab.
3. Click on the Name of the system to add the subscription to.
4. Change from the Details tab to the Subscriptions tab, then click Attach Subscriptions.
5. Select the check box beside the subscription to attach, then click Attach Subscriptions.

Installing JBoss Web Server from RPM packages using YUM

1. On a command line, subscribe to the JBoss Web Server CDN repositories for your operating system version using subscription-manager:

   # subscription-manager repos --enable <repository>

   • For Red Hat Enterprise Linux 6:

     • jws-5-for-rhel-6-server-rpms
     • jb-coreservices-1-for-rhel-6-server-rpms

   • For Red Hat Enterprise Linux 7:

     • jws-5-for-rhel-7-server-rpms
     • jb-coreservices-1-for-rhel-7-server-rpms

2. Issue the following command as the root user to install JBoss Web Server:

   # yum groupinstall jws5

   Note
   • Although not recommended, instead of using the group install, you can install each of the packages and their dependencies individually.
   • The Red Hat JBoss Core Services repositories above are required for the installation of JBoss Web Server.

1. Install the selinux-policy-devel package:

   yum install -y selinux-policy-devel

2. Execute the .postinstall.selinux script:

   cd <JWS_home>/tomcat/
   sh .postinstall.selinux

3. Make and install the SELinux module:

   cd selinux
   make -f /usr/share/selinux/devel/Makefile
   semodule -i jws5-tomcat.pp

4. Apply the SELinux contexts for JBoss Web Server:

   restorecon -r <JWS_home>/tomcat/

5. Add access permissions to the required ports for JBoss Web Server. The JBoss Web Server has access to ports 8080, 8009, 8443 and 8005 on Red Hat Enterprise Linux 7 systems.

   When additional ports are required for JBoss Web Server, use the semanage command to provide the necessary permissions, replacing the port number with the port required:

   semanage port -a -t http_port_t -p tcp <port>

   Note

   The JBoss Web Server on Red Hat Enterprise Linux 6 systems has access to the same ports as Red Hat Enterprise Linux 7 systems, with the exception of port 8005. To grant the JBoss Web Server access to this port on a Red Hat Enterprise Linux 6 system, as the root user, issue:

   semanage port -a -t http_port_t -p tcp 8005

6. Start the Tomcat service:

   <JWS_home>/tomcat/bin/startup.sh

7. Check the context of the running process expecting jws5_tomcat:

   ps -eo pid,user,label,args | grep jws5_tomcat | head -n1

8. To verify the contexts of the Tomcat directories, for example:

   ls -lZ <JWS_home>/tomcat/logs/