Red Hat Training

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

5.2. Install Proxy Server Components

Task: Install Proxy Server Components

Follow this task to install the JBoss HTTP Connector on a JBoss Enterprise Web Server.
The JBoss HTTP Connector is supported in production only with JBoss Enterprise Web Server as the proxy server. Refer to the JBoss Enterprise Web Server Installation Guide to download and install the JBoss Enterprise Web Server.
The Native components are Operating System and processor architecture specific. Refer to the JBoss Enterprise Application Platform Installation Guide to download the correct Native Components package for your server Operating System and processor architecture.

Prerequisites

  • JBoss Enterprise Web Server v1.0.1 or later installed.
  • JBoss Enterprise Application Platform 5 Native components downloaded.

  1. Extract Apache modules from Native Components download

    Extract the four modules mod_advertise.so, mod_manager.so, mod_proxy_cluster.so, mod_slotmem.so from the appropriate Native Components package directory for your processor architecture: either native/lib/httpd/modules or native/lib64/httpd/modules.

  2. Copy Apache modules to JBoss Enterprise Web Server

    Copy the JBoss HTTP Connector modules to the JBOSS_EWS_DIST/httpd/modules directory of the JBoss Enterprise Web Server.

  3. Disable the mod_proxy_balancer module

    Edit the JBoss Enterprise Web Server Apache configuration file JBOSS_EWS_DIST/httpd/conf/httpd.conf and comment out the following line by adding an initial #: 
    LoadModule proxy_balancer_module modules/mod_proxy_balancer.so
    This module is incompatible with the JBoss HTTP Connector.

  4. Configure the server to load the JBoss HTTP Connector modules

    1. Create the file JBOSS_EWS_DIST/httpd/conf.d/JBoss_HTTP.conf.
    2. Add the following lines to the file JBOSS_EWS_DIST/httpd/conf.d/JBoss_HTTP.conf: 
      LoadModule slotmem_module JBOSS_EWS_DIST/modules/mod_slotmem.so
LoadModule manager_module JBOSS_EWS_DIST/modules/mod_manager.so
LoadModule proxy_cluster_module JBOSS_EWS_DIST/modules/mod_proxy_cluster.so
LoadModule advertise_module JBOSS_EWS_DIST/modules/mod_advertise.so

  5. Restart the JBoss Enterprise Web Server Apache service

    Refer to the JBoss Enterprise Web Server documentation for detailed instructions.