Web Connection User's Guide

Setting up for the IBM Internet Connection API (ICAPI)

To install the ICAPI files, follow these steps:

  1. 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.
  2. 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
    
  3. Copy the following files to the directory specified by the ABTWSI_BASENAME environment variable.

    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.
  4. Update your Web server configuration.
    1. Start your Web server
    2. Open a web browser and point it to your server location (the hostname of the server)
    3. On the Go Webserver page, select Configuration and Administration Forms
    4. On the Configuration and Administration Forms page, select GWAPI Application Processing
    5. On the GWAPI page, for ServerInit, specify the server initialization directive. For example:
      d:\webserver\cgi-bin\abtwsai.dll:AbtWsiServerInit
      
    6. For ServerTerm, specify the server termination directive. For example:
      d:\webserver\cgi-bin\abtwsai.dll:AbtWsiServerTerm
      
    7. Apply the changes
    8. On the Configuration and Administration Forms page, select Request Routing
    9. On the Request Routing page, select *Service in the Action drop-down list.
    10. Route all URL requests that start with abtwsi to the dll AbtWsiService:
      1. For URL request template, specify
        /abtwsi*
        
      2. For Replacement file path, specify the service directive. For example:
        d:\webserver\cgi-bin\abtwsai.dll:AbtWsiService*
        
    11. 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 ]