16.5.4. Install the mod_cluster Module Into Apache HTTPD or JBoss Enterprise Web Server HTTPD (RPM)

Prerequisites

  • To perform this task, you must be using Apache HTTPD installed in Red Hat Enterprise Linux 6, or JBoss Enterprise Web Server, or the standalone HTTPD included as a separate downloadable component of JBoss EAP 6.
  • If you need to install Apache HTTPD in Red Hat Enterprise Linux 6, use the instructions from the Red Hat Enterprise Linux 6 Deployment Guide, available from https://access.redhat.com/site/documentation/.
  • If you need to install the stand-alone HTTPD included as a separate downloadable component of JBoss EAP 6, refer to Section 16.3.2, “Install the Apache HTTPD included with JBoss EAP 6 (ZIP)” .
  • 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.
  • You must have an active subscription to the jbappplatform-6-ARCH-server-VERS-rpm RHN channel.
The RPM installation method is similar between Red Hat Enterprise Linux 5 and 6, only requiring minor variations for Red Hat Enterprise Linux 6 users who have Apache HTTPD 2.2.15 installed.
  1. Install the mod_cluster-native package using YUM:
    yum install mod_cluster-native
    
  2. HTTPD 2.2.15:
    • If you choose to stay on HTTPD 2.2.15, you must disable the mod_proxy_balancer module loaded by default by commmenting the LoadModule proxy_balancer_module line in the httpd.conf file.
      Either edit the file manually or use the following command:
      sed -i 's/^LoadModule proxy_balancer_module/#LoadModule proxy_balancer_module/;s/$//' /etc/httpd/conf/httpd.conf
      
    • If you choose to upgrade to HTTPD 2.2.22, install the latest version using the following command.
      yum install httpd
      
  3. To have the HTTPD service start at boot, execute the following command:
    service httpd add
    
  4. Start the mod_cluster balancer with the following command:
    service httpd start