Administration and Programming Guide for OS/390
The Common Gateway Interface (CGI) is an industry-standard interface that
enables a Web server to invoke an application program such as
Net.Data. Net.Data's support for CGI lets you use
Net.Data with your favorite Web server.
Unless you modified the directory structure or name when you created the
hierarchical file system (HFS) directory for Net.Data, the SMP/E
install process installed the Net.Data executable files and DLLs in the
directory /usr/lpp/netdata/cgi-bin. Because
/usr/lpp/netdata is not your Web server's root directory, the
Web server cannot process client requests for Net.Data unless you make
some additional modifications to the Web server's configuration.
To modify the Web server:
- Stop the Web server.
- Use either of the following approaches to complete the installation of the
executable files and DLLs.
- Using Net.Data Directories
- Add an Exec directive to the Web server's configuration file,
/etc/httpd.conf, that redirects Net.Data requests to
the /usr/lpp/netdata/cgi-bin directory. For example:
Exec /netdata-cgi/* /usr/lpp/netdata/cgi-bin/*
- Add your Net.Data cgi-bin directory to the LIBPATH
statement of the Web server's environment variables file,
/etc/httpd.envvars. If your Net.Data
cgi-bin directory is /usr/lpp/netdata/cgi-bin, then your
LIBPATH statement should be similar to the following statement:
LIBPATH=/usr/lpp/internet/bin:/usr/lpp/netdata/cgi-bin
- Using Web Server Directories
- Move the executable files and DLLs (appldll, db2www,
dtwle, dtwlei, dtwsql, dtwsqlv6,
filedll, odbcdll, perldll,
rexxdll, sysdll) to the Web server's
cgi-bin directory. The Web server default cgi-bin
directory is /usr/lpp/internet/server_root/cgi-bin.
The Web server's default root directory is specified by the ServerRoot
directive in the Web server's configuration file,
/etc/httpd.conf, and might have been changed when the Web
server was installed. The Web server's default cgi-bin
directory is specified by an Exec directive in the Web server's
configuration file and might also have been changed when the Web server was
installed. If your Web server's root directory is different than
/usr/lpp/internet/server_root, or if your Web server's
cgi-bin directory is different than
/usr/lpp/internet/server_root/cgi-bin, substitute your choices as
appropriate in these instructions.
- Add the Web server's cgi-bin directory to the LIBPATH
statement of the Web server's environment variables file,
/etc/httpd.envvars. If your Web server
cgi-bin directory is
/usr/lpp/internet/server_root/cgi-bin, your LIBPATH statement
should be similar to the following statement:
LIBPATH=/usr/lpp/internet/bin:/usr/lpp/internet/server_root/cgi-bin
- Ensure that the permissions for the Net.Data executable files and
DLLs and for each directory in the path to the executable files and DLLs are
755.
- Restart the Web server
Restriction: Do not specify more than one of the following
directories in the LIBPATH statement of the Web server's environment
variables file.
- cgi-bin
- icapi-lib
- servlet-lib
For more detail on installing the Web server and on Web server
configuration file directives, refer to the following publications:
- IBM Internet Connection Secure Server Planning for Installation
Version 2 Release 2 for OS/390, GC31-8489-00
- IBM Internet Connection Secure Server Webmaster's Guide
Version 2 Release 2 for
OS/390, GC31-8490-00
- Lotus Domino Go Webserver Planning for Installation Version
4.6.1 for OS/390, SC31-8642
- Lotus Domino Go Webserver Webmaster's Guide Version
4.6.1 for OS/390, SC31-8643
[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]