Sun Java System Application Server Standard and Enterprise Edition 7 2004Q2 Update 3 Administration Guide |
Appendix C
Compiling and Configuring Apache Web Server (Enterprise Edition)This appendix describes how you should compile the Apache source code and configure your installation of Apache Web Server to use Sun Java System Application Server 7, Enterprise Edition load balancer plug-in.
You must download the appropriate Apache source code for the platform on which you want to run Apache Web Server. The load balancer plug-in is certified to work with Apache 1.3.29 and 2.0.49 on the following platforms:
This appendix contains the following topics:
Minimum RequirementsYou must meet the following requirements to successfully compile Apache web server to run the load balancer plug-in. The Apache source must be compiled and built to run with SSL. Requirements for Apache 1.3 and Apache 2 are slightly different. These are listed separately in this section. Requirements common to both versions of Apache are listed under Requirements Common to Apache 1.3 and 2.
Minimum Requirements for Apache 1.3
Minimum Requirements for Apache 2
Requirements Common to Apache 1.3 and 2
- On Solaris 8, ensure that gcc and make are in the PATH.
- On Solaris 9, ensure that gcc version 3.3 and make are in the PATH, and flex is installed.
- If you are using gcc On Red Hat Enterprise Linux Advanced Server 2.1, make sure you have a version later than gcc 3.0.
Note
- To use another C compiler, set the path of the C compiler and make utility in the PATH environment variable. For example:
exportLD_LIBRARY_PATH=$LD_LIBRARY_PATH:appserver_installdir/lib- These software sources are available at http://www.sunfreeware.com
Installing SSL-aware ApacheThe procedures described in this section are common to both Apache 1.3 and 1, except where specifically mentioned. Although, the examples show compiling and building Apache 1.3.29, the same procedures apply for Apache 2.
For instructions on compiling and installing Apache on Microsoft Windows platforms, see the following web sites:
Follow these steps to compile, configure, and install SSL-aware Apache web server.
Compiling and Building Open SSL
Unpack the openssl-0.9.7c source and follow these steps.
Configuring Apache with mod SSL
Unpack the mod_ssl-2.8.14-1.3.29 source and follow these steps.
- cd mod_ssl-2.8.14-1.3.29
- run ./configure --with-apache=../apache_1.3.27--with-ssl=../openssl-0.9.7c --prefix=<install path> --enable-module=ssl --enable-shared=ssl --enable-rule=SHARED_CORE --enable-module=so
The directory specified in the above command is a variable. You can specify the path where you install Apache. The prefix argument indicates where you wish to install Apache. This command will output several lines on the screen.Essentially this command creates the make files for the build according to your system configuration. If there are errors in configure, you may be missing some header files or utility programs which you must install before proceeding.
Compiling and Building Apache
- Download the apache_1.3.29 source distribution.
Unpack the source distribution. The source distribution comes as a compressed archive. If you are installing apache_1.3.29, the source distribution archive will read apache_1.3.29.tar.gz.
- Decompress and untar the archive using the following command:
tar -zxvf apache_1.3.29.tar.gz
This command will create a directory called apache_1.3.29 in your current working directory.
- Compile Apache using the make command, as follows:
- cd apache_1.3.29
- make
- make certificate
- make install
This installs apache in the location provided in the --prefix attribute in Configuring Apache with mod SSL.
Note
- On Linux, include the following lines in src/MakeFile after End of automatically generated section
LIBS+= -licuuc -licui18n -lnspr4 -lpthread -lxerces-c -lsupport -lnsprwrap -lns-httpd40
LDFLAGS+= -L/appserver_installdir/lib- These settings must be performed before executing Step 3.
- make certificate would ask for a secure password. Remember this password as it’s required for starting secure Apache.
The command make install will output several lines on the screen indicating that the process is compiling Apache source code and linking Apache. This process should normally conclude without errors. However if any errors occur, please check if all the library files and utility programs of Apache have been properly downloaded.
Configure this installation of Apache by entering the appropriate values for your environment in the apache_install_path/conf/httpd.conf file.
Starting and Stopping Apache
Apache comes bundled with a script titled apachectl that facilitates starting, stopping and restarting Apache.
Run the follow command to start Apache:
apache_install_dir/bin/apachectl start
Run the follow command to start Apache in SSL mode:
apache_install_dir/bin/apachectl startssl
To stop apache, run the following command:
apache_install_dir/bin/apachectl stop
After you start, you can test your installation of Apache. Once Apache is running, type the following address in your web browser: http://localhost/. If your installation was successful and Apache is running, you should see a test page displaying a message to that effect.
Now you are ready to install the loadbalancer plug-in. To install and configure the loadbalancer plug-in, follow instructions in Chapter 17, "Configuring HTTP Load Balancing and Failover (Enterprise Edition)."