The CGI interface enables the Web server to run stand-alone executable programs in response to requests from clients. Most Web servers support CGI, so if you aren't sure which interface to use, CGI is probably a safe choice. However, its performance is typically slower than that of the other, server-specific interfaces.
To install the CGI files, follow these steps:
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
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 field.
Note: | You must use forward slashes (/) when specifying the path information for the ABTWSI_BASENAME field. Java treats backward slashes (/) as escape characters. |
After you install the files, you must customize the WSI configuration file for your system. See Customizing the WSI configuration file for more information.
If you are running the Netscape server, you can edit your obj.conf file and change the first Init line to set the environment dynamically for each CGI invocation:
Init fn="init-cgi" ABTWSI_BASENAME=d:/cgi-bin/abtwsi
This technique can also be used for setting any other environment variables you need at run time. For example, if you are running under AIX and LIBPATH is not being passed through to the CGI program by the server, you can edit your obj.conf file and set LIBPATH dynamically so that abtwsac can find its shared object files (abtwsc.a, abtwstt.so):
Init fn="init-cgi" ABTWSI_BASENAME=d:/cgi-bin/abtwsi LIBPATH=/usr/mylibs:/otherlibs
Proceed to Testing your installation to setup, test and run the Web Connection interface.