Content
Introduction
Release Notes
Features
FAQs
Requirements
Installation
How To
Change Log
Future Plans
Knowledge Base
Documentation
Examples
Legal
Contact Us
|
Use the instructions below to configure Microsoft Personal Web Server,
Internet Information Server or other Application/Web Servers supporting
ISAPI to use Servertec Internet Server as their Servlet Engine.
- Install and configure Servertec Internet Server.
- 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/Me/XP add the following entries to iserver.ini file in
c:\windows and for Windows NT/2000/2003 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 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 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.
|
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:
Each Alias block is made up an Alias parameter, one or more Server parameter,
an Interval and a 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 ISAPI Gateway was installed,
normally c:\iws.net\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 ISAPI Gateway was installed,
normally c:\iws.net\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.net\install\win32\pws.reg as needed.
"Filter DLLs"="c:\\iws.net\\bin\\win32\\isapiGateway.dll"
Note: Each \\ represents a single \
- Register it.
regedit c:\iws.net\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.net\bin\win32\isapiGateway.dll.
|
- Restart the computer.
|
|