kshEngine - Web Site Generator System

Version 1.0.1

INSTALLATION
------------

To extract the files contained within this archive,
perform the following steps:

1. Save this archive out to a file in the /tmp directory
   called inst2036.uue

2. Login as "root". This step is essential because the install program
   must change permissions, group, and owner of the files being installed.

3. Change directories to /tmp as follows:
	cd /tmp

4. run uudecode on the file as follows:
	uudecode inst2036.uue

5. The result will be a file called inst2036.tar.Z
   Uncompress that file as follows:
	uncompress inst2036.tar.Z

6. The result will be a tape archive (tar) file called inst2036.tar
   Extract the tar file as follows:
	tar xvf ./inst2036.tar

7. This will create several file and a subdirectory called pgm2036
   change directories into that subdirectory as follows:
	cd pgm2036

8. Start a Korn shell session as follows:
	ksh

9. Run the install program as follows:
	./install.sh

   IF YOU EXPERIENCE PROBLEMS with the install program, run the alternate
   install program: "./altinstall.sh".  Then skip to step 13.

10. Select option "2 = kshEngine Configuration" on the main menu

11. Select option "2 = MODIFY kshEngine Configuration"

12. You will be prompted with "Modify this Record...(Y/N)?"
    answer with "Y"

13. Now modify each line of the screen to fit your configuration

    LINE 1: Dir above CGI-BIN
	Enter the full path to the directory above the CGI directory
	where the kshEngine System should reside.  For instance, if
	your CGI directory is "/home/httpd/cgi-bin", then your answer
	for this line should be "/home/httpd".

    LINE 2: CGI directory
	Enter the CGI directory where the kshEngine System will reside.
	For instance, if your CGI directory is "/home/httpd/cgi-bin",
	then your answer for this line should be "cgi-bin".

    LINE 3: Dir above DOCS
	Enter the full path to the directory above the DOCS directory
	where the kshEngine System should reside.  For instance, if
	your DOCS directory is "/home/httpd/docs", then your answer
	for this line should be "/home/httpd".

    LINE 4: DOCS directory
	Enter the DOCS directory where the kshEngine System will reside.
	For instance, if your DOCS directory is "/home/httpd/docs",
	then your answer for this line should be "docs".

    LINE 5: Program directory
	Enter the directory where the kshEngine System will reside.
	This line may have a default answer of "kshEngine", if not, change
	it to "kshEngine".

    LINE 6: Main Title
	Enter the title you want displayed on the kshEngine System.
	The default is "Web Site Generator". You may want to change
	this to reflect your company name.

    LINE 7: HTTPD user ID
	Enter the user ID which will own all files under the CGI
	directory.  This will default to "nobody" and is dependent
	upon your HTTP server.  You MUST select the proper user ID
	or this system will not work.  The default "nobody" will
	work with Netscape, but may not work with other servers.

    If you are running the alternate installation program, review
    the log file in "/tmp/Log" and then skip to step 19.

14. Enter 0 when all modifications are complete. You will be asked
    if you want to "Save this Record...(Y/N)?".  Enter "Y".

15. Enter 0 to return to the main menu

16. Select "3 = Install kshEngine System"

17. Select "1 = Run Install Script"
    this will start installing the kshEngine System

18. When you return to the menu screen,
    Select "2 = View Install Log".  Look through this
    log and see if the word ERROR appears anywhere. If it
    does, the problem is usually some sort of permission error.
    Correct any problems and run the install script again.

19. If no errors occur in the event log, then the install is
    complete.  You may exit from the menu system

20. start your web browser and direct it to the following:

	http://<YOUR WEB SERVER>/<YOUR CGI DIR>/<YOUR PROGRAM DIR>/engine.cgi

    example:

	http://www.mtxia.com/cgi-bin/kshEngine/engine.cgi


################################################################