Installing JRun
Connecting JRun to External Web Servers

Connecting an Apache web server

This section describes how to configure JRun to communicate with an Apache web server running on Windows or UNIX. For more information about advanced web server connection techniques, see JRun Administrator's Guide.

To connect Apache and JRun:

1. UNIX only Configure the DSO module (if necessary for your system).

   For detailed procedures, see the Apache documentation.

2. Run the Web Server Configuration tool, and connect to a JRun server.

   For details, see "Running the Web Server Configuration tool".

3. In the Web Server Properties section of the Web Server Configuration tool, select Apache, as the following figure shows:

   

4. Enter the directory path or browse to the Apache server conf directory.

   The Select Directory window appears.

5. Select the Apache server conf directory, and click Select.

   

   The Add Web Server Configuration window appears, with the configuration directory path (conf_dir) in the Web Server Properties Directory field:

   

   For example, on Windows NT, the web server conf_dir might be C:\Program Files\Apache Group\Apache\conf. On UNIX, it might be /usr/local/apache/conf.

6. To enable the following connector and Apache settings, click Advanced:

   Connector Settings

   • Verbose logging in the connector log
   • The native OS memory allocator, not the web server memory allocator

     Apache Settings

   • (Optional) Path to server binary-If you do not enter a path, JRun searches for the binary file, as follows:

     (Windows) conf_dir\..\apache.exe, conf_dir\..\bin\apache.exe

     (UNIX) conf_dir/../bin/httpd, /usr/sbin/httpd, /usr/apache/bin/httpd, or for httpd in the system path

   • When running Apache as a Windows service, you must specify the Windows Service Name, as the following figure shows:

     

7. Click OK.
8. Click Install.

   JRun connects to the web server.

9. Ensure that your web server is running.
10. To verify the JRun connection to your Apache web server, open a web browser on the Apache web server to the following URL: http://web-server-hostname.

    Note:   This step assumes that Apache is listening for connections on the default port 80. If not, use http://web-server-hostname:webserver-port-number.

    The default page for the web server to which you connected appears, showing that you successfully configured the connection between JRun and your external web server.

Removing the JRun connection to Apache

You can remove the web server configuration in one of two ways:

• Using the Web Server Configuration tool:

  

  Select the Apache web server configuration, and click Remove.

• Using the following command:

  java -jar jrun_root/lib/wsconfig.jar -ws apache -dir apache_root/conf -r