Page 24 out of 26 total pages


Replacing the Mini Web Server


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:

General Guidelines for Setting Up a Web Server

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/script

Map the following directories:

Alias/classes
QBICDIR/classes
Alias/images
QBICDIR/html/images
Alias/gifs
QBICDIR/html/gifs
Alias/thumb
QBICDIR/html/thumb
Alias/cgi-bin
QBICDIR/script

Guidelines for the IBM Internet Connection Server

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

Guidelines for the Apache Web Server

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

Guidelines for the Microsoft Peer Web Server

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:

Environment variable Value
QBTCL_LIB
QBICDIR\script
TCL_LIBRARY
QBICDIR\script

Map the following directories. The steps in this section describe how to map the first directory. Map the others using the same steps.

Make sure you check the execute box for the "cgi-bin" directory mapping.

/classes
QBICDIR\classes
/images
QBICDIR\html\images
/gifs
QBICDIR\html\gifs
/thumb
QBICDIR\html\thumb
/cgi-bin
QBICDIR\script

  1. Start the Internet Service Manager by selecting Start Programs Microsoft Peer Web Services Internet Service Manager.
  2. Double-click Icons next to WWW service.
  3. Choose the Directories tab.
  4. Click Add.
  5. In the Directory text field, enter c:\usr\local\qbic\classes.
  6. In the Virtual directory text field, enter /classes.
  7. Do the same for the other directories.

    You also need to modify the Windows registry to allow script mapping:

  8. Go to c:\WINNT (or wherever you installed Windows NT).
  9. Type RegEdit.
  10. From within the Registry Editor, go to HKEY_LOCAL_MACHINE System Currentcontrolset Services W3svc Parameters Scriptmap.
  11. From the Edit menu, select New String Value.
  12. Enter .tcl as the Name and QBICDIR\bin\qbictcl.exe %s %s as the Value.



Page 24 out of 26 total pages


xzhu@almaden.ibm.com or tedl@almaden.ibm.com
Copyright © 1998, IBM Corporation. All rights reserved.