GLACI HTTPD NLM Version 2.00 demo INSTALLATION INSTRUCTIONS
-----------------------------------------------------------

This file contains instructions for installing version 2.00
of HTTPD.NLM.  The first section explains how to use the
HTSETUP NLM included on the install floppy to install the
software from the server console.  The second section lists
manual installation instructions.

INSTALLING FROM THE FLOPPY DISK
-------------------------------
First, download the httpd200.zip file from the /pub/netware directory
on the anonymous FTP server ftp.glaci.com.  Unzip the file to a floppy
disk.  If you do not have a program for handling ZIP files, don't
worry; just download the entire contents of the /pub/netware/httpd
directory from the ftp.glaci.com anonymous FTP server.  It contains
the unarchived contents of the httpd105.zip file.

Insert the newly created GLACI-HTTPD install diskette in your file 
server's floppy drive.  Type the following command at the server 
console:

load a:\htsetup

This will load and run the install/setup NLM from the floppy.
HTSETUP will then prompt you for the location of the install files.
Since you are installing from the server's A drive simply press
Enter to select the default value of  A:\.

HTSETUP will ask you where it should install the HTTPD NLM.  Press 
enter to select the default value SYS:\SYSTEM, otherwise, type in
the volume and path of the directory to install the NLM in and press
Enter.  HTSETUP will copy HTTPD.NLM to the specified directory.

Next the server will prompt you for the location of the Document Root 
Directory.

Select the Document Root Directory [C:/ETC/HTDOCS]-->

The Document Root is the path to prepend to every HTTP file request.  
This protects you from HTTP clients getting into other directories on
the NetWare server.  You may simply press enter to select the default
value SYS:/ETC/HTDOCS.  If you plan to have many documents
administered by many different users, you should probably create a
document directory on some other volume besides SYS.  In that case,
just type in the complete volume and path of the document directory
and press Enter.  If the directory does not exist, you will be asked
if it should be created for you.

The directory C:/ETC/HTDOCS does not exist.
Should I create it? [y/n]-->

Press Y for yes and then hit the Enter key.  The directory will be
created and sample HTML documents will be copied to it.

README.TXT      A quick introduction
INSTALL.TXT     A text version of these instructions
LICENSE.TXT     Terms of the GLACI-HTTPD software license
WELCOME.HTM     Sample HTML document
LOGO.GIF        Inline graphic used in WELCOME.HTM
TEST.MAP        An example image map file
TESTMAP.GIF     A graphic for testing ISMAP support

HTSETUP will then ask you to choose the Icon Directory.

Select the Icon Directory [C:/ETC/ICONS]-->

This directory will contain useful graphic image files used with
GLACI-HTTPD's ListDirs feature.  You may simply press enter to select
the default value SYS:/ETC/ICONS.  Otherwise, to select a different
Icon Directory type in the complete volume and path of the icon
directory and press Enter.  If the directory does not exist, you will
be asked if it should be created for you.

The directory C:/ETC/ICONS does not exist.  Should I create it? [y/n]-->

Press Y for yes and then hit the Enter key.  The directory will be
created and the icon files will be copied to it.

BINARY.XBM       Executable programs and other binary data
BLANK.XBM        An empty icon image file
DIR.XBM          A folder icon
DOCUMENT.XBM     Text, word processor, or HTML documents
IMAGE.XBM        Graphic images such as GIF or JPEG
GOBACK.XBM       Arrow icon for parent directory
MOVIE.XBM        MPEG video files
SOUND.XBM        A digitized sound file
UNKNOWN.XBM      Icon for unknown file types

HTSETUP will then ask you to choose the Image Map Directory.

Select the Image Map Directory [C:/ETC/IMAGEMAP]-->

This directory will contain useful image map files used with
ISMAP clickable images.  You may simply press enter to select
the default value SYS:/ETC/IMAGEMAP.  Otherwise, to select a different
Image Map Directory type in the complete volume and path of the 
directory and press Enter.  If the directory does not exist, 
you will be asked if it should be created for you.

The directory C:/ETC/IMAGEMAP does not exist. Should I create it? [y/n]-->

Press Y for yes and then hit the Enter key.  The directory will be
created and the example file TEST.MAP will be copied to it.


MANUAL INSTALLATION INSTRUCTIONS
--------------------------------

If for some reason you do not wish to use the automated install
procedure, you can manually install the GLACI-HTTPD software with
the following steps.

The GLACI-HTTPD demo package should contain the following files:

README.TXT      A quick introduction
INSTALL.TXT     This file
LICENSE.TXT     Terms of the demo release
ORDER.TXT       Instructions for ordering 
ORDRFORM.TXT    Order form for the production version
BETA.TXT        A questionnaire for beta testers
HTTPD.NLM       The web server NLM
HTTPD.CFG       Configuration file for the NLM
MIMETYPE.CFG    MIME type configuration file
WELCOME.HTM     Sample HTML document
LOGO.GIF        Inline graphic used in WELCOME.HTM
TEST.MAP        An example image map file
TESTMAP.GIF     A graphic for testing ISMAP support
BINARY.XBM       
BLANK.XBM        |
DIR.XBM          |
DOCUMENT.XBM     |
IMAGE.XBM        | Icon files used by ListDir feature
GOBACK.XBM       |
MOVIE.XBM        |
SOUND.XBM        |
UNKNOWN.XBM     


INSTALLATION STEPS
------------------
1. Make sure that the TCPIP.NLM is properly configured and loaded.
   Read the TCP/IP manual that came with your NetWare documentation
   to find out how to install TCPIP.NLM.  If you are using IP
   encapsulation routing or some other TCP/IP based NLM, then the
   TCPIP.NLM is already running and you can go straight to the next
   step.

2. Copy the HTTPD.NLM to your NetWare file server.  You can load
   the NLM from almost anywhere, but copying it to SYS:/SYSTEM makes
   the most sense.

3. Copy the HTTPD.CFG and MIMETYPE.CFG file into SYS:/ETC

4. Select or create a directory for storing your HTML documents.  By
   default, the HTTPD NLM is configured use SYS:/ETC/HTDOCS.  If that
   is acceptable to you, then just create a directory called HTDOCS
   in SYS:/ETC.  You might plan to have many documents administered
   by many different users.  If that is the case, you should create
   a document directory on some other volume and then modify the
   HTTPD.CFG file appropriately.

5. Copy the files WELCOME.HTM and LOGO.GIF into the document directory
   you selected in the previous step.

6. Select or create a directory for the icon image files.  The
   default location is SYS:/ETC/ICONS.  If that is acceptable, create
   a directory named ICONS in SYS:/ETC.  If you select a different
   location for the icon directory you will also need to change the
   IconDir setting in the HTTPD.CFG file.

7. Copy all the files with a .XBM extension to icon directory created
   in the previous step.

8. Select or create a directory for the image map files.  The
   default location is SYS:/ETC/IMAGEMAP.  If that is acceptable, 
   create a directory named IMAGEMAP in SYS:/ETC.  If you select a 
   different location for the icon directory you will also need to 
   change the ImageMapDir setting in the HTTPD.CFG file.

9. An example image map file named TEST.MAP has been included with 
   your GLACI-HTTPD package.  If you wish to test it, copy it to the
   image map directory.

10. Creat a directory named \TEMP on the SYS volume.  If you create
    the temporary directory in any other location, be sure to change
    the TempDir option in the HTTPD.CFG file.

11. Edit the configuration file SYS:/ETC/HTTPD.CFG and make any site 
    specific changes you think appropriate.  Be sure to change the  
    DocumentRoot setting if you selected a document directory other
    than SYS:/ETC/HTDOCS.  Also, change the IconDir setting if you
    selected an icon directory other than SYS:/ETC/ICONS.  The
    configuration file should be fairly self explanatory.

12. Load the NLM by typing 'LOAD HTTPD' at the system console.  You
    may need to specify the full path to HTTPD if you installed
    it someplace other than SYS:/SYSTEM.

13. Now test the server.  Go to a workstation with a web browser
    (i.e. Mosaic).  Try opening the following URL: 
  
    http://your.server.name/welcome.htm
  
    The string 'your.server.name' should instead be the IP hostname
    assigned to your NetWare server.


REPORTING PROBLEMS
------------------
Send us email at httpd-bugs@glaci.com or call 414-475-6388.

