Chapter 5. Installing httpd modules

5.1. Configuration
5.2. Installing and using the bundles

Several bundles are available at http://www.jboss.org/mod_cluster/downloads.html.

In case you can't find a prepared package of mod_cluser in the download area, it is possible to build mod_cluster for the sources. You need a distribution of httpd (at least 2.2.8) or (better) a source tarball of httpd and the sources of mod_cluster. Building explains how to build mod_cluster for it sources.

5.1. Configuration

A minimal configuration is needed in httpd (See httpd.conf). A listener must be a added in in JBossWEB conf/server.xml (See Configuring JBoss AS/Web).

5.2. Installing and using the bundles

The bundles are tar.gz on POSIX platforms just extract them in root something like:

  cd /
  tar xvf mod-cluster-1.x.y-linux2-x86-ssl.tar.gz

The httpd.conf is located in /opt/jboss/httpd/httpd/conf to quick test just add something like:

Listen 10.33.144.3:6666
 <VirtualHost 10.33.144.3:6666>
 
   <Directory />
      Order deny,allow
      Deny from all
      Allow from 10.33.144.
   </Directory>
 
 KeepAliveTimeout 60
 MaxKeepAliveRequests 0
 
 ManagerBalancerName mycluster
 AdvertiseFrequency 5
 
 </VirtualHost>

To start httpd do the following:

/opt/jboss/httpd/sbin/apachectl start

NOTE: Make sure to use SSL before going in production.