Note: This documentation is for an old version of Webinator. The latest documentaion is here.

Filesystem Layout

Webinator is installed underneath your HTML document tree. It consists of several subdirectories. Assuming that your HTML document root is htdocs, this will be the structure:

                           htdocs/
                              |
                          webinator/
                              |
         +-------------+------+------+-------------+
         |             |             |             |
     index.html       bin/          db/         .master/
     search            |             |             |
     bar0.gif      .htaccess     .htaccess     .htaccess
     bar1.gif      gw            gw.log        ...
     tstonebut.gif ...           ...

All of the directories that should not be referenced by web browsers contain a .htaccess file that denies all access.

The webinator directory contains the search interface scripts, several GIF files used by the search interfaces, and an index.html that contains a pointer to the search program as an example of how to start it.

The bin directory contains the gw program and any other related utilities and readme's. The gw program may be moved to or run from any desired directory.

The db directory contains the default HTML database. It is initially empty. This is the database that gw and webinator will access if none is specified. It also contains the log file maintained by gw when working on that database. Each database will have its own log file.

The .master directory contains files that are referenced when creating a new database.

All of the files under the webinator tree must be readable and writable by the WEB server. Also, gw must be run as the WEB server user or be made setuid to it by running commands similar to the following:

   chown WEBUSERNAME gw
   chmod u+s gw
The above commands will have to be run as the root user on most systems.


Copyright © Thunderstone Software     Last updated: Tue Nov 6 10:58:47 EST 2007
Copyright © 2024 Thunderstone Software LLC. All rights reserved.