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.