Sun Java System Application Server Enterprise Edition 8.1 2005Q2 High Availability Administration Guide

Configuration before Installing the Load Balancer Plug-in

Before installing the load balancer plug-in for Apache, install the Apache Web Server. The Apache source must be compiled and built to run with SSL. This section describes the minimum requirements and high-level steps needed to successfully compile Apache Web Server to run the load balancer plug-in. These requirements and steps only apply to the Solaris and Linux versions of the software. For information on the Windows version of Apache, see the Apache web site.

ProcedureTo Install SSL-aware Apache

Before You Begin

You must have already downloaded and uncompressed the Apache software.

  1. Download and unpack the OpenSSL source.

  2. Compile and build OpenSSL.

    This step is not required on the Linux platform if OpenSSL 0.9.7.e is installed.

    Enter these commands:


    cd openssl-0.9.7e
    make
    make install

    For more information about OpenSSL, see the http://www.openssl.org/.

  3. Follow one of these procedures, depending on the version of Apache:

    • For Apache 1.3, configure Apache with mod_ssl with the following steps:

      1. Unpack the mod_ssl source.

      2. cd mod_ssl-2.8.14–1.3.x

      3. ./configure –with-apache=../apache_1.3.x --with-ssl=../openssl-0.9.7e --prefix=install_path --enable-module=ssl --enable-shared=ssl --enable-rule=SHARED_CORE --enable-module=so

      In the above commands, x is the Apache version number, and install_path is the directory in which to install Apache.

      For more information on mod_ssl, see http://www.modssl.org.

    • For Apache 2.0, configure the source tree:

      1. cd http-2.0_ x.

      2. Run ./configure --with-ssl= open_ssl_install_path --prefix= install_path --enable-ssl --enable-so

        In the above commands, x is the Apache version number, open_ssl_install_path is the directory where OpenSSL is installed, and install_path is the directory in which to install Apache.

  4. For Apache on Linux 2.1, before compiling:

    1. Open src/MakeFile and find the end of the automatically generated section.

    2. Add the following lines after the first four lines after the automatically generated section:

      LIBS+= -licuuc -licui18n -lnspr4 -lpthread -lxerces-c 
      -lsupport -lnsprwrap -lns-httpd40
      LDFLAGS+= -L/appserver_installdir/lib -L/opt/sun/private/lib

      Note that -L/opt/sun/private/lib is only required if you installed Application Server as part of a Java Enterprise System installation.

      For example:

      ## (End of automatically generated section)
      ## 
      CFLAGS=$(OPTIM) $(CFLAGS1) $(EXTRA_CFLAGS)
      LIBS=$(EXTRA_LIBS) $(LIBS1)
      INCLUDES=$(INCLUDES1) $(INCLUDES0) $(EXTRA_INCLUDES)
      LDFLAGS=$(LDFLAGS1) $(EXTRA_LDFLAGS)
      "LIBS+= -licuuc -licui18n -lnspr4 -lpthread 
      -lxerces-c -lsupport -lnsprwrap -lns-httpd40
      LDFLAGS+= -L/appserver_installdir /lib -L/opt/sun/private/lib
    3. Set environment variable LD_LIBRARY_PATH.

      With all installations, set it to: appserver_install_dir/lib

      With Java Enterprise System Installations, set it to appserver_install_dir/lib:opt/sun/private/lib .

  5. Compile Apache as described in the installation instructions for the version you are using.

    For more information, see the http://httpd.apache.org/

    In general the steps are:

    1. make

    2. make certificate (Apache 1.3 only)

    3. make install

      The command make certificate asks for a secure password. Remember this password as it is required for starting secure Apache.

  6. Configure Apache for your environment.