16.6.4. Install the Mod_jk Module Into the Apache HTTP Server (RPM)

Prerequisites

  • To perform this task, you must be using Apache HTTP Server installed on a supported environment or the Apache HTTP Server installed in JBoss Enterprise Web Server. Note that the Apache HTTP Server installed in JBoss Enterprise Web Server is part of the JBoss EAP 6 distribution.
  • If you need to install Apache HTTP Server, use the instructions from the Red Hat Enterprise Linux Deployment Guide, available from https://access.redhat.com/site/documentation/.
  • If you need to install JBoss Enterprise Web Server, use the instructions from the JBoss Enterprise Web Server Installation Guide, available from https://access.redhat.com/site/documentation/.
  • You must be logged in with administrative (root) privileges.

Procedure 16.10. Red Hat Enterprise Linux 5: mod_jk with Apache HTTP Server 2.2.3

  1. Install mod_jk-ap22 1.2.37 and its dependency mod_perl from the jbappplatform-6-*-server-5-rpm channel:
    yum install mod_jk
    
  2. Optional: Copy the sample configuration files for use:
    cp /usr/share/doc/mod_jk-ap22-1.2.37/mod_jk.conf.sample /etc/httpd/conf.d/mod_jk.conf
    
    cp /usr/share/doc/mod_jk-ap22-1.2.37/workers.properties.sample /etc/httpd/conf/workers.properties
    
    These files should be edited to suit your needs.
  3. Start the server:
    service httpd start
    

Note

The following error message indicates that your mod_jk module had been loaded before mod_perl was present:
Cannot load /etc/httpd/modules/mod_jk.so into server: /etc/httpd/modules/mod_jk.so: undefined symbol: ap_get_server_description
To ensure mod_perl module is loaded before mod_jk module add the following to the /etc/httpd/conf.d/mod_jk.conf:
 <IfModule !perl_module>
        LoadModule perl_module modules/mod_perl.so
</IfModule>
LoadModule jk_module modules/mod_jk.so

Procedure 16.11. Red Hat Enterprise Linux 5: mod_jk with JBoss EAP Apache HTTP Server 2.2.22

  1. Install both mod_jk and the latest Apache HTTP Server 2.2.22 provided by the jbappplatform-6-*-server-5-rpm channel with this command:
    yum install mod_jk httpd
    
  2. Optional: Copy the sample configuration files for use:
    cp /usr/share/doc/mod_jk-ap22-1.2.37/mod_jk.conf.sample /etc/httpd/conf.d/mod_jk.conf
    
    cp /usr/share/doc/mod_jk-ap22-1.2.37/workers.properties.sample /etc/httpd/conf/workers.properties
    
    These files should be edited to suit your needs.
  3. Start the server:
    service httpd start
    

Procedure 16.12. Red Hat Enterprise Linux 6: mod_jk with JBoss EAP Apache HTTP Server 2.2.22

  1. Install mod_jk-ap22 1.2.37 and Apache HTTP Server 2.2.22 httpd package from the jbappplatform-6-*-server-6-rpm channel (any existing versions will be updated):
    yum install mod_jk httpd
    
  2. Optional: Copy the sample configuration files for use:
    cp /usr/share/doc/mod_jk-ap22-1.2.37/mod_jk.conf.sample /etc/httpd/conf.d/mod_jk.conf
    
    cp /usr/share/doc/mod_jk-ap22-1.2.37/workers.properties.sample /etc/httpd/conf/workers.properties
    
    These files should be edited to suit your needs.
  3. Start the server:
    service httpd start
    

Procedure 16.13. Red Hat Enterprise Linux 6: mod_jk with Apache HTTP Server 2.2.15

  1. Instal mod_jk with Apache HTTP Server 2.2.15 with the following command:
    yum install mod_jk
    
  2. Optional: Copy the sample configuration files for use:
    cp /usr/share/doc/mod_jk-ap22-1.2.37/mod_jk.conf.sample /etc/httpd/conf.d/mod_jk.conf
    
    cp /usr/share/doc/mod_jk-ap22-1.2.37/workers.properties.sample /etc/httpd/conf/workers.properties
    
    These files should be edited to suit your needs.
  3. Start the server:
    service httpd start