INSTALL:

This file details installation instructions for the  Web HylaFAX gateway 1.0
package.


For prerequisite information, Please refer to the included README file
under the PREREQUISITE section before proceeding with this installation.



INSTALLATION:
==============

My apologies, but the installation process is very shitty and manual.


Unpacking the distribution:
==========================

Unpack this distribution file (web-hylafax-gw-1.0.tar.gz) into a temporary 
working area (eg /usr/src) as follows :-

        tar -zxvf web-hylafax-gw-1.0.tar.gz

OR (if your tar dose not support automatic gunzipping) use

        gzip -d web-hylafax-gw-1.0.tar.gz | tar -xvf -

This will produce a subdirectory called :-

                web-hylafax-gw

off the current directory.

Change into this sub-directory, ie issue the command :-

	cd web-hylafax-gw


Customising Variables
=====================

The file fax/fax-gw-config.pl contains some variables that need to be altered.
The file has information inside it about each variable. On a standard system,
you should not need to change any of the variable values at all.

However, please check the value of all variables. When edit the variable values, 
please maintain all quotation marks (") and semi-colons(;).


Verifying Perls Location
=======================
The cgi scripts are written in perl, and as such, they require the
correct location of the perl interpretor.

Please confirm that the first line of the files :-
	fax/fax-gw
	fax/fax-gw-status
points to the correct location of the perl executable. The line  to look 
for is :-
	#! /usr/bin/perl

	



Copying Files To Correct Locations:
===================================

Copy the subdirectory fax/ into the web servers cgi-bin directory.

As an example, on my Slackware 3.5 linux box, the Apache CGI bin directory
is :-
	/var/lib/httpd/cgi-bin

so, I would run the command :-
 
	cp -pR fax /var/lib/httpd/cgi-bin

This should create a sub-directory the the web servers cgi-bin 
directory called :-
	fax/
with the following files inside it :-
	fax-gw
	fax-gw-status
	cgi-lib.pl
	fax-gw-config.pl

Ensure that the permissions off these files has remaind correct, viz :-

-r--r--r--   1 root     root        15091 Dec 16 17:30 cgilib.pl
-rwxr-xr-x   1 root     root         2461 Dec 16 17:30 fax-gw*
-r--r--r--   1 root     root         2194 Dec 16 17:30 fax-gw-config.pl
-rwxr-xr-x   1 root     root          870 Dec 16 17:30 fax-gw-status*



Copy the HTML interface page (fax-gw.html) to the webservers htdocs directory. 
Again, as an example, on my Slackware 3.5 linux box, 
the Apache htdocs directory is :-

	/usr/local/etc/apache_1.3.0/htdocs

so, I would run the command :- 

	cp fax-gw.html /usr/local/etc/apache_1.3.0/htdocs



USING Web HylaFAX gateway: 
==========================

Go to the URL of the fax-gw.html page and follow the on screen instructions.


COVER PAGE:
===========

On sending a fax, Web HylaFAX gateway 1.0 will include a 
cover page, filling the fields as entered on the web form. The default
cover page included with HylaFAX has Silicon Graphic's logo and info on it. 
This is probably not desirable for other users and the instructions for 
making a new cover page in the HylaFAX FAQ seem too complex.

I have included a modified version of the default HylaFAX cover page
here which basically has the Silicon Graphic's logo removed. Before
using this cover page (faxcover.ps) :-

	- edit the file and change the strings 
		COMPANY NAME 1 and
		COMPANY NAME 2 	
	  to ones that suite you. Ensure you keep the () around the strings.

	- copy this file to /usr/local/lib/fax/ ie.
		cp faxcover.ps /usr/local/lib/fax/


CONTACT DETAILS:
================

Nic Tjirkalli
EMAIL:          nic@uunet.co.za
URL  :          http://duffus.iafrica.com/~nic


