Included with the QBIC installation package is a "mini" web server that you can use with the QBIC demo application. You can also use the mini web server when developing and testing your own QBIC-based applications. However, when you deploy your application, it is recommended that you replace the mini web server with a full-scale server.
This appendix describes how to replace the mini web server with a full-scale server.
There are a number of full-scale web servers available. See "General Guidelines for Setting Up a Web Server" on page 181 for general information on how to configure a web server for QBIC. The following sections give specific examples for the following web servers:
If the full-scale web server that you want to use is not described in this appendix, the general guidelines should help you to set up the parameters required to run your QBIC application. See your server's documentation for details on setting up the server.
QBIC uses an extended tcl script as its CGI script. When you configure your full-scale web server, you need to copy tcl scripts from the QBICDIR/script
directory to the cgi-bin directory of the full-scale web server.
For each catalog, the corresponding script is called catalog.tcl in QBICDIR/script
, where catalog is the catalog name. For example, QBIC comes with a script called ibm33.tcl
, which corresponds to the ibm33
catalog.
When setting up a web server, you need to add environment variables and to map directories. In most cases, you make these configuration changes by editing the server's configuration files. Check your server's documentation for details.
Add the following environment variables:
TCL_LIBRARY QBICDIR/script QBTCL_LIB QBICDIR/scriptMap the following directories:
For the IBM Internet Connection server, edit the httpd.cnf
file, which is located in ROOT/httpd.cnf. ROOT
is the location where you installed the operating system. For example, for the Windows NT operating system, ROOT
is \winnt
, and for the Windows 95 operating system, ROOT
is \windows
.
Map the following directories in the httpd.cnf
file:
pass/classes/* | QBICDIR\classes\* |
pass/images/* | QBICDIR\html\images\* |
pass/gifs/* | QBICDIR\html\gifs\* |
pass/thumb/* | QBICDIR\html\thumb\* |
pass/cgi-bin/* | QBICDIR\script |
In Windows 95, edit the autoexec.bat
file to set the following environment variables.
In Windows NT, go to Control Panel
System
Environment tab to set the following environment variables.
Set TCL_LIBRARY=QBICDIR\script Set QBTCL_LIB=QBICDIR\script
For the Apache server, edit the httpd.conf file, which is located in HTTPD/conf/httpd.conf. HTTPD
is the location where you installed the server. You will need root privileges to edit this file.
Map the following directories in the httpd.cnf
file:
Alias/classes | QBICDIR/classes |
Alias/images | QBICDIR/html/images |
Alias/gifs | QBICDIR/html/gifs |
Alias/thumb | QBICDIR/html/thumb |
Alias/cgi-bin | QBICDIR/script |
Add the following environment variables to the httpd.conf
file:
SetEnv TCL_LIBRARY QBICDIR/script SetEnv QBTCL_LIB QBICDIR/script
For the Microsoft Peer web server, after performing all of the procedures in this section, reboot the NT system for the changes to take effect.
Set the following environment variables under Control Panel
System
Environment tab:
Map the following directories. The steps in this section describe how to map the first directory. Map the others using the same steps.
/classes | QBICDIR\classes |
/images | QBICDIR\html\images |
/gifs | QBICDIR\html\gifs |
/thumb | QBICDIR\html\thumb |
/cgi-bin | QBICDIR\script |
c:\usr\local\qbic\classes
.
/classes
.
You also need to modify the Windows registry to allow script mapping:
c:\WINNT
(or wherever you installed Windows NT).
.tcl
as the Name and QBICDIR\bin\qbictcl.exe %s %s
as the Value.