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: 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