GLACI-HTTPD v1.05 demo README FILE
----------------------------------
This is the version 2.00 demo release of GLACI-HTTPD, a web server NLM
for NetWare 3.11 and up.  It will expire on December 14, 1995.  Be sure
to read the files LICENSE.TXT and INSTALL.TXT before starting.  Read the
file ORDER.TXT if you decide you would like to purchase GLACI-HTTPD.
the file lists license costs, educational discounts, and explains how
to submit your order.


NEW FEATURES
------------
Several new features have been added to since version 1.03.
They are listed and explained below.

1. MIMETYPE CONFIGURATION FILE
------------------------------
A configuration file for MIME types has been added to the software.
The file is named MIMETYPE.CFG and is stored in SYS:\ETC.  Each line
in the file defines a single MIME type.  The leftmost column contains
the MIME type string.  It is followed by a space seperated list of
filename extensions that should be associated with that MIME type.
A line that begins with a '#' character is considered a comment and
is ignored.  The default MIMETYPE.CFG file that comes with
GLACI-HTTPD is probably sufficient for most users, but it can be
easily added to if you have special MIME types you wish to
accomidate.


2. ISMAP CLICKABLE IMAGE SUPPORT
--------------------------------
Support for the ISMAP feature has been added to the GLACI server.  An
additional configuration option has been added to the HTTPD.CFG file,
The keyword 'ImageMapDir' followed by volume and path where image
files may be located.  The default location is SYS:/ETC/IMAGEMAP.
Thus, the new entry in the HTTPD.CFG file would look like the
following:

ImageMapDir SYS:/ETC/IMAGEMAP

A map file is used to define the clickable locations within an
image.  The map file must have a .MAP extension.  For example, an  
image named TEST.GIF might be mapped by a file named TEST.MAP.   
The TEST.MAP file might contain the following text:

# This is a sample image map file
default http://www.foobar.com/test/four.html
rect    http://www.glaci.com/test/one.html   10,10 50,50
rect    http://www.glaci.com/test/two.html   10,60 50,110
circle  http://www.glaci.com/test/three.html 140,55 140,75

The above example defines two squares and a circle within TEST.GIF.  A
rectangle is defined with two points, the upper left corner and lower
right corner.  The points are shown as X,Y pairs.  The URL associated
with that rectangle is listed before the points defining it.

A circle is defined by a center point followed by a point on the edge.
The URL associated with the circle is listed before the points.  In the
above example, clicking within the circle will cause the document
/test/three.html to be loaded from the server www.glaci.com.

Clicking outside a specified shape will cause the default URL to be
loaded.

A above test image could be accessed with the following HTML code:

<A HREF="/img/test.map"><IMG SRC="/test/test.gif" ISMAP></A>


3. IP ACCESS LISTS
------------------
Two additional keywords have been added to the HTTPD.CFG file to
allow support for IP access lists.  The 'ipallow' keyword is used
to specify systems and networks which may connect to the web server.
The keyword 'ipdeny' is used to specify systems that should be
refused access.  An ipallow or ipdeny keyword is follow by an
ip address in dotted decimal notation.  Individual octets of the
address can be replaced with a '*' wildcard character.  This allows
entire networks or subnetworks to be specified.  An example access
list follows:

ipdeny  199.170.176.2
ipallow 199.170.176.*
ipdeny  *.*.*.*

Access lists are always scanned from top to bottom.  The web server
compares the connecting address with each entry in the list and stops
at the first matching entry.  It allows or denies access as specified
by the entry.  In the above example, the first line specifies that
address 199.170.176.2 will be denied access to the web server.  Line
two specifies that all other addresses on that network will be allowed
access.  The final line indicates that all other nodes on the internet
will be denied access.

If no matching entry is found, the connecting address is given access.
If the access list is emtpy, then IP access lists security is disabled
and anyone can connect to the server.



4. PERSONAL WEB PAGES
---------------------
The personal web page option allows a NetWare user to store HTML
documents withing his or her home directory and make them accessible to
the rest of the world via the GLACI-HTTPD web server.  Ideally, the web
server should be able to find a user's home directory by looking it up
in the Network Directory Services.  We have encountered some
difficulties with this approach have implemented a work around.  A
user's home directory is determined with the help of a new 'HomeDir'
option in the HTTPD.CFG file.  The login name is appended to HomeDir
path to obtain the user's full home directory path.  For example,
given the following HomeDir configuration line:

HomeDir DATA:/USERS

A user with the login name JOHN would have a home directory of
DATA:/USERS/JOHN.  The web server will look for his personal web pages
in a subdirectory named HTDOCS within his home directory.

For example, if web server receives a request for the following URL:

http://sparrow.glaci.com/~john/mydoc.htm

It will attempt to send a file named DATA:/USERS/JOHN/HTDOCS/MYDOC.HTM.
Note that in the above URL, the document path begins with ~john.  The
'~' tilde character tells the web server that a user name follows.

This option is continuing to be refined and debugged.

5. CGI FORMS SUPPORT
--------------------
GLACI-HTTPD now supports CGI scripting via C and C++ programs as
well as Perl scripts.  A copy of the freely available Perl NLM is
available on our anonymous FTP server ftp.glaci.com in the
/pub/netware directory.  The file is called plxxxx.zip.  The Perl
NLM was not developed by GLACI, we have a copy of it on our FTP server
just for our customers' convienence.  We include several example
Perl scipts with the package, as well as several C programs that
can be compiled into NLMs using the Watcom C/C++ compiler.  The  
example web page WELCOME.HTM shows how they can be used.  Be sure
to read the text CGI.TXT to learn more about using CGI with
GLACI-HTTPD.

CAN WE ASK A FAVOR?
-------------------
We would like to ask a simple favor of those people using GLACI-HTTPD
on Internet connected machines.  Somewhere on your NetWare server's  
home page please create a link that points to to the URL 
'http://www.glaci.com/info/glaci-httpd.html' where we plan to keep 
an up to date page describing the GLACI-HTTPD server software.  It 
is not required that you create such a link, but we would certainly 
appreciate the help in making our product known. If you have any 
questions, don't hesitate to contact us.

Thad Phetteplace
Network Systems Analyst
Great Lakes Area Commercial Internet
P.O. Box 26354, Wauwatosa, WI 53226 - USA
414-475-6388
support@glaci.com

