Servertec   ISAPI 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

 

Use the instructions below to configure Microsoft Personal Web Server, Internet Information Server or other Application/Web Servers supporting ISAPI to use iServer as their Servlet Engine.
  1. Install and configure iServer.

  2. Install and configure Microsoft Personal Web Server, Internet Information Server or other Application/Web Server that supports ISAPI.

  3. Define variables used by the ISAPI Gateway.

    For Windows 9x add the following entries to iserver.ini file in c:\windows and for Windows NT add the following entries to iserver.ini file in c:\winnt.

    [isapigateway]
    Debug=debug
    Handler=/igateway/isapiGateway.dll
    Alias=alias
    Server=hostname:port
    Interval=interval
    Retry=retry

    alias the URI or file extension used to access the iServer ISAPI Gateway, normally /servlet.
    debug whether to make a dump of the request/response to \temp\isapiGateway.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 ISAPI 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.
    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:
    Each Alias block is made up an Alias parameter, one or more Server parameter, an Interval and an Retry parameter.

    Alias blocks are terminated on the next Alias parameter, empty line or at end of file.

    Multiple Alias blocks are evaluated against the request being made in the order that they are defined.

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

    Example:

    [isapigateway]
    
    debug=false
    handler=/igateway/isapiGateway.dll
    
    alias=.jsp
    server=p8:8080
    server=p9:8080
    server=p10:8080
    interval=1000
    retry=3
    
    alias=/images
    server=p6:8080
    server=p7:8080
    interval=1000
    retry=2
    
    alias=/files
    server=p6:8080
    server=p7:8080
    interval=1000
    retry=2
    
    alias=/cgi-bin
    server=p5:8080
    interval=1000
    retry=1
    
    alias=/
    server=p1:8080
    server=p2:8080
    server=p3:8080
    server=p4:8080
    interval=1000
    retry=4
    

  4. Add the following Virtual Directory.

    For Microsoft Personal Web Server using Personal Web Manager click on Advanced and add the following Virtual Directory.

    Directory the directory where the iServer ISAPI Gateway was installed, normally c:\iws\bin\win32.
    Alias the base URI used to access the ISAPI Extension, normally igateway.
    Access the privileges, normally Execute.

    For Microsoft Internet Information Server using Internet Service Manager right mouse click on the Web Site, then click on New, followed by Virtual Directory and Use the New Virtual Directory Wizard to add the following Virtual Directory.

    Alias the base URI used to access the ISAPI Extension, normally igateway.
    Directory the directory where the iServer ISAPI Gateway was installed, normally c:\iws\bin\win32.
    Permissions the privileges, normally Execute.

    For Microsoft Internet Information Server after adding the Virtual Directory above, select the newly created Virtual Directory by right mouse clicking on igateway, then click on Properties and then on Directory Security tab. Finally in the Directory Security tab click on Edit and then set the Authentication Methods by selecting Allow Anonymous Access and clearing Basic Authentication and Windows NT Challenge/Response.

  5. Define the ISAPI Filter.

    For Microsoft Personal Web Server update the Registry.

    1. Modify c:\iws\install\win32\pws.reg as needed.

      "Filter DLLs"="c:\\iws\\bin\\win32\\isapiGateway.dll"

      Note: Each \\ represents a single \

    2. Register it.

      regedit c:\iws\install\win32\pws.reg

    For Microsoft Internet Information Server using Internet Service Manager right mouse click on the Web Site, then click on Properties and then on ISAPI Filters tab. Finally in ISAPI Filters tab add the following Filter.

    Filter Name the name of the Filter, normally isapiGateway.
    Executable the path to the ISAPI Filter,
    normally c:\iws\bin\win32\isapiGateway.dll.

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