Web Connection User's Guide
To install the ICAPI files, follow these steps:
- Copy the following shared library files to a directory on your Web
server's cgi-bin subdirectory. Make sure your
cgi-bin directory is added to your computer's PATH statement at run
time. When adding the directory to your PATH statement, be sure that
the exact directory structure is in the PATH variable. Do not use a
. to specify the current path.
- abtwsai.dll (adapter module)
- abtwsc.dll (common module)
- abtwstt.dll (TCP/IP transport module)
- Edit your operating system configuration file and include the
ABTWSI_BASENAME environment variable. This environment variable
specifies where WSI looks for configuration and error message files.
Include the parameter abtwsi at the end of your directory
structure. The abtwsi parameter designates the
abtwsi.cnf and
abtwsi.htm files.
For Intel platforms, use a set statement. For example:
set ABTWSI_BASENAME=d:\webserver\cgi-bin\abtwsi
For UNIX platforms, use an export statement. For example
export ABTWSI_BASENAME=/webserver/cgi-bin/abtwsi
- Copy the following files to the directory specified by the ABTWSI_BASENAME
environment variable.
- abtwsi.cnf (configuration file)
- abtwsi.htm (error format file)
When you install Web Connection, these files are installed in the
webconn directory. You can copy them to another directory
and also rename them. If you do either, you must reflect their new
location and name in the ABTWSI_BASENAME environment variable. For
example, if you moved the files to d:\wsifiles, and renamed
them from abtwsi.* to mywsi.*, you would supply a value
d:\wsifiles\mywsi for the ABTWSI_BASENAME environment
variable.
Note: | You must use forward slashes (/) when specifying the path
information for the ABTWSI_BASENAME field. Java treats backward slashes
(/) as escape characters.
|
- Update your Web server configuration.
- Start your Web server
- Open a web browser and point it to your server location (the hostname of
the server)
- On the Go Webserver page, select Configuration and Administration
Forms
- On the Configuration and Administration Forms page, select GWAPI
Application Processing
- On the GWAPI page, for ServerInit, specify the server
initialization directive. For example:
d:\webserver\cgi-bin\abtwsai.dll:AbtWsiServerInit
- For ServerTerm, specify the server termination
directive. For example:
d:\webserver\cgi-bin\abtwsai.dll:AbtWsiServerTerm
- Apply the changes
- On the Configuration and Administration Forms page, select Request
Routing
- On the Request Routing page, select *Service in the
Action drop-down list.
- Route all URL requests that start with abtwsi to the dll
AbtWsiService:
- For URL request template, specify
/abtwsi*
- For Replacement file path, specify the service
directive. For example:
d:\webserver\cgi-bin\abtwsai.dll:AbtWsiService*
- Apply the changes and restart the Web server.
The drive and directory (d:\webserver\cgi-bin in the
examples above) should be the directory you copied the WSI executable
components to. The Service directive path (/abtwsi/*) can be
any path descriptor that you want your end users to use to invoke your Web
Connection part.
After you install the files, you must customize the WSI configuration file
for your system. See Customizing the WSI configuration file for more information. After customizing the WSI
configuration file, proceed to Testing your installation to setup, test and run the Web Connection interface.
[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]