Servertec   Apache Gateway
Content
Introduction
Release Notes
Features
FAQs
Requirements
Installation
iServer
AOL Gateway
Apache Gateway
ISAPI Gateway
NSAPI Gateway
CGI Gateway
Java Gateway
Add-ons
How To
Change Log
Future Plans
Knowledge Base
Documentation
Samples
Sales
Legal
Feedback

 

Select the platform to install the Apache Gateway under:
Windows 9x/NT
Linux/Unix
Use the instructions below to configure the Apache Web Server or other Application/Web Servers running on Windows 9x/NT supporting Apache Modules to use iServer as their Servlet Engine.
  1. Install and configure iServer.

  2. Install and configure Apache Web Server or other Application/Web Server that supports Apache Modules to use Dynamically Loadable Modules.

  3. Add the following lines to the httpd.conf file.

    LoadModule apache_gateway_module mod_path
    <Location alias>
       SetHandler apache-gateway-handler
       Debug debug
       Server host_name:port
       Interval interval
       Retry retry
    </Location>

    alias the URI used to access the iServer Apache Gateway, normally /servlet.
    debug whether to make a dump of the request/response to \temp\apacheGateway.log [ true | false ], normally false.
    host_name the name of the host computer running iServer. If iServer is running on the same computer as the iServer Apache Gateway then localhost can be used.
    interval the number of milliseconds to wait before attempting to retry a workgroup server that is down, a value greater than or equal to 50 ms, normally 1000 ms.
    mod_path the path to the iServer Apache Gateway, normally c:/iws/bin/win32/apacheGateway.dll.
    port is the port number iServer is listening on, normally port 8080.
    retry the number of workgroup server to try to connect to, normally the number of servers defined.

    Notes:
    A separate Server parameter must be entered for each workgroup server.

    Example:

    LoadModule apache_gateway_module
      c:/iws/bin/win32/apacheGateway.dll
    
    <Location /images> 
      SetHandler apache-gateway-handler 
      Debug false
      Server p6:8080
      Server p7:8080
      Interval 1000
      Retry 2
    </Location> 
    
    <Location /files> 
      SetHandler apache-gateway-handler 
      Debug false
      Server p6:8080
      Server p7:8080
      Interval 1000
      Retry 2
    </Location> 
    
    <Location /cgi-bin> 
      SetHandler apache-gateway-handler 
      Debug false
      Server p5:8080
      Interval 1000
      Retry 1
    </Location> 
    
    <Location />
      SetHandler apache-gateway-handler 
      Debug false
      Server p1:8080
      Server p2:8080
      Server p3:8080
      Server p4:8080
      Interval 1000
      Retry 4
    </Location>
    

  4. Restart the Apache Web Server.

Notes:
When starting Apache Web Server configured for Secure Socket Layer (SSL) the following warning will be displayed when loading the iServer Apache Gateway:

c:/iws/bin/win32/apacheGateway.dll uses plain Apache 1.3 API, this module might crash under EAPI! (please recompile it with -DEAPI)

The iServer Apache Gateway will then loaded and should run without any problems. top of page


Use the instructions below to configure the Apache Web Server or other Application/Web Servers running on Linux/Unix supporting Apache Modules to use iServer as their Servlet Engine.
  1. Install and configure iServer.

  2. Install and configure Apache Web Server or other Application/Web Server that supports Apache Modules to use Dynamically Loadable Modules.

  3. Add the following lines to the httpd.conf file.

    LoadModule apache_gateway_module mod_path
    <Location alias>
       SetHandler apache-gateway-handler
       Debug debug
       Server host_name:port
       Interval interval
       Retry retry
    </Location>

    alias the URI used to access the iServer Apache Gateway, normally /servlet.
    debug whether to make a dump of the request/response to /tmp/apacheGateway.log [ true | false ], normally false.
    host_name the name of the host computer running iServer. If iServer is running on the same computer as the iServer Apache Gateway then localhost can be used.
    interval the number of milliseconds to wait before attempting to retry a workgroup server that is down, a value greater than or equal to 50 ms, normally 1000 ms.
    mod_path the path to the iServer Apache Gateway, normally /iws/bin/linux/apacheGateway.so.
    port is the port number iServer is listening on, normally port 8080.
    retry the number of workgroup server to try to connect to, normally the number of servers defined.

    Notes:
    A separate Server parameter must be entered for each workgroup server.

    Example:

    LoadModule apache_gateway_module
      /iws/bin/linux/apacheGateway.so
    
    <Location /images> 
      SetHandler apache-gateway-handler 
      Debug false
      Server p6:8080
      Server p7:8080
      Interval 1000
      Retry 2
    </Location> 
    
    <Location /files> 
      SetHandler apache-gateway-handler 
      Debug false
      Server p6:8080
      Server p7:8080
      Interval 1000
      Retry 2
    </Location> 
    
    <Location /cgi-bin> 
      SetHandler apache-gateway-handler 
      Debug false
      Server p5:8080
      Interval 1000
      Retry 1
    </Location> 
    
    <Location />
      SetHandler apache-gateway-handler 
      Debug false
      Server p1:8080
      Server p2:8080
      Server p3:8080
      Server p4:8080
      Interval 1000
      Retry 4
    </Location>
    

  4. Restart the Apache Web Server.

Notes:
When starting Apache Web Server configured for Secure Socket Layer (SSL) the following warning will be displayed when loading the iServer Apache Gateway:

/iws/bin/linux/apacheGateway.so uses plain Apache 1.3 API, this module might crash under EAPI! (please recompile it with -DEAPI)

The iServer Apache Gateway will then loaded and should run without any problems.

 top of page
 Built with iScript Copyright © 1997-2000 Servertec. All rights reserved.
Last Modified: Sat Aug 12 11:20:03 EDT 2000