CHAPTER 1: Installation


Installing from a floppy disk

Insert the 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. You will be presented with a menu of three options:

  1. Modify Install Parameters
  2. Begin Installation
  3. Exit
Select option one to customize installation parameters such as the web server name or the directories where files will be installed. Selecting option one will present you with a Installation Parameters screen with the following options and default values:

Parameter

ServerPort
ServerName
DocumentRoot
IconDir
CGIDir
TempDir
WelcomePage
HomeDir
ImageMapDir
HtmlEqualsHtm
ListDirs
LogFile
AccessLog
LogToScreen
Use311CGI

Default Value

80
no.name.assigned
SYS:\ETC\HTDOCS
SYS:\ETC\ICONS
SYS:\ETC\CGI-BIN
SYS:\TEMP
welcome.htm
SYS:\
SYS:\ETC\IMAGEMAP
YES
YES
SYS:\ETC\ERROR.LOG
SYS:\ETC\HTTPD.LOG
YES
YES

you can scroll through the parameters with the up/down arrow keys. Press enter to modify the highlighted parameter. Detailed descriptions of these parameters can be found in Chapter 2: Runtime Parameters. It is important that you set the ServerName parameter to the name of your server, otherwise some some features of the web server (such as image maps) will not work fully. When you are done cusomizing the install parameters, press the ESC key to return to the main install menu.

Next, choose the Begin Installation option. The install program will copy files from the floppy disk onto the server. If any of the target directories do not exist, the program will prompt you before it creates them. After the files are copied, the program will then ask you to select a Web Admin Password. The Web Admin Password is used to restrict access to the Web Based Configuration Options discussed in Chapter 2. After you enter the password, the install program will prompt you to enter it again. This is simply to verify that you typed it correctly the first time. Finally, the install program will write the web server's configuration file to SYS:\ETC\HTTPD.CFG. The installation is now complete. Pressing any key will exit the install program.

Upgrading From A Previous Version

Version 3.0 of GLACI-HTTPD has many new features and supporting files compared to earlier versions. It is recommended that you totally reinstall the software to assure that all the supporting files are properly installed. Simply copying the new HTTPD.NLM over the old one is not sufficient. Make sure you have backups of your web pages, old HTTPD.CFG file, and MIMETYPE.CFG file (if you made any changes to it). Then follow the normal installation instructions as described above. You might want to specify a different DocumentRoot directory so your existing default home page is not overwritten. You can then recofigure the server back to your original DocumentRoot after it is up and running. Chapter 2 explains how to reconfigure the server when it is running.

Running the Web Server NLM

There are now two NLMs that must be run to access take full advantage of GLACI-HTTPD's features. The NMX.NLM provides access to the powerful NetBasic scripting language specially designed for CGI Forms processing. NMX must be loaded before the HTTPD NLM. At your console prompt type LOAD NMX and press enter. Next, load the web server NLM by typing LOAD HTTPD and pressing enter. The web server should now be running. You can test it by bringing up a web browser and connecting to your servers web address (i.e. http://www.yourdomain.com). You can put the LOAD NMX and LOAD HTTPD command in your server's AUTOEXEC.NCF file so web server is automatically loaded when the server is booted.