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

 

Select the platform to install the Apache Gateway under:
Windows 9x/Me/NT/2000/2003/XP
Linux/Solaris/Unix


Use the instructions below to configure the Apache Web Server or other Application/Web Servers running on Windows 9x/Me/NT/2000/2003/XP supporting Apache Modules to use Servertec Internet Server as their Servlet Engine.
  1. Install and configure Servertec Internet Server.

  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 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 Servertec Internet Server. localhost can be used if both servers are running on the same computer.
    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 Apache Gateway, normally c:/iws/bin/win32/apacheGateway.dll.
    port is the port number Servertec Internet Server 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 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 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/Solaris/Unix supporting Apache Modules to use Servertec Internet Server as their Servlet Engine.
  1. Install and configure Servertec Internet Server.

  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 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 Servertec Internet Server. localhost can be used if both servers are running on the same computer.
    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 Apache Gateway, normally /iws/bin/platform/apacheGateway.so.
    platform the platform, linux, solaris/x86 or solaris/sparc.
    port is the port number Servertec Internet Server 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 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 Apache Gateway will then loaded and should run without any problems.

 top of page
Copyright © 1998-2005 Servertec. All rights reserved.
Privacy Statement.
Last Modified: Sun Sep 04 14:56:49 EDT 2005