4.4. Configuring the Environment

After you have installed JBoss Enterprise Web Server, set the JAVA_HOME for your Tomcat (see Procedure 4.4, “Configuring Tomcat”).
Optionally, you can also:

Procedure 4.4. Configuring Tomcat

Before starting Tomcat, set its JAVA_HOME variable to point to a supported JDK (1.6.0):
  1. Locate the tomcat configuration file:
    • For Tomcat 7: /opt/jboss-ews-2.1/etc/sysconfig/tomcat7
    • For Tomcat 6: /opt/jboss-ews-2.1/etc/sysconfig/tomcat6
  2. Open the configuration file and delete the hash (#) sign at the beginning of the following line:
    # JAVA_HOME="/usr/java"

Procedure 4.5. Removing SSL

JBoss Enterprise Web Server by default supports SSL. However, you may remove the SSL support.
Follow this procedure to remove or add SSL:
  1. Go to /opt/jboss-ews-2.1/etc/httpd/conf.d
  2. Rename the SSL configuration file:
    • To remove SSL, rename ssl.conf to ssl.conf.disabled.
    • To re-enable the SSL, rename ssl.conf.disabled to ssl.conf.

Procedure 4.6. Configuring log4j

Follow this procedure to add log4j logging to Tomcat:
  1. Go to the /opt/jboss-ews-2.1/share/extras directory.
  2. Copy the log4j-eap6.jar, log4j.properties, and tomcat-juli-adapters.jar files to the lib directory of the Tomcat directory.
    For example:
    extras]# cp log4j.properties ../tomcat<VERSION>/lib/
    extras]# cp log4j-eap6.jar ../tomcat<VERSION>/lib/
    extras]# cp tomcat-juli-adapters.jar ../tomcat<VERSION>/lib/
    Replace <VERSION> with the respective Tomcat version number (6 or 7).
  3. Replace tomcat-juli.jar file in your Tomcat bin directory with the tomcat-juli.jar file from /opt/jboss-ews-2.1/share/extras:
    extras]# cp tomcat-juli.jar ../tomcat<VERSION>/bin/

Procedure 4.7. Configuring mod_jk

To configure the HTTP Server to use mod_jk, define the following:
  • available workers (JBoss instances) in the workers.properties file
  • the mod_jk configuration file mod_jk.conf
Follow this procedure to configure the HTTP Server to use mod_jk as its load balancer:
  1. Create a workers.properties file in /opt/jboss-ews-2.1/etc/httpd/conf (see http://tomcat.apache.org/connectors-doc/reference/workers.html).
  2. Create a mod_jk.conf in /opt/jboss-ews-2.1/etc/httpd/conf.d/, (see http://tomcat.apache.org/connectors-doc/reference/apache.html).

    Note

    You can also copy and modify the sample files mod_jk.conf.sample and workers.properties.sample available in /opt/jboss-ews-2.1/etc/httpd/conf/: modify their content as needed and rename them to mod_jk.conf and workers.properties.

Procedure 4.8. Configuring mod_cluster

  1. Mod_cluster is part of the JBoss Enterprise Web Server 2.1 installation.
  2. In /opt/jboss-ews-2.1/httpd/conf/httpd.conf add a hash (#) sign at the beginning of the following line to disable the mod_proxy_balancer module:
    LoadModule proxy_balancer_module modules/mod_proxy_balancer.so
    This module is incompatible with the JBoss HTTP Connector.
  3. Configure the server to load the JBoss HTTP Connector modules:
    1. Create the file /opt/jboss-ews-2.1/httpd/conf.d/mod_cluster.conf.
    2. Add the following lines to the file /opt/jboss-ews-2.1/httpd/conf.d/mod_cluster.conf:
      LoadModule slotmem_module modules/mod_slotmem.so
      LoadModule manager_module modules/mod_manager.so
      LoadModule proxy_cluster_module modules/mod_proxy_cluster.so
      LoadModule advertise_module modules/mod_advertise.so