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.
- Install and configure iServer.
- Install and configure Microsoft Personal Web Server, Internet
Information Server or other Application/Web Server that supports ISAPI.
- 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
- 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.
- Define the ISAPI Filter.
For Microsoft Personal Web Server update the Registry.
- Modify c:\iws\install\win32\pws.reg as needed.
"Filter DLLs"="c:\\iws\\bin\\win32\\isapiGateway.dll"
Note: Each \\ represents a single \
- 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.
|
- Restart the computer.
|
|