# Installing httpd modules

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.

## 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).

## 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.