"Hylafax Client on NT with Netscape Solution Kit"
=================================================


Ok, this is a package with some files which will help 
you to install the Kail-style hylafax client system.

What do you need for this:
---------------------------

1) A working hylafax installation on a Linux or Unix box.
2) A intranet web server with the ability to run cgi scripts.
3) A working sendfax on the machine where the cgi scripts will
   be executed
4) Redmon up and running on a NT Box. Get redmon from 
   http://www.cs.wisc.edu/~ghost/rjl.html and follow the
   instructions.

How does this work:
--------------------

A) The user print to the redmon printer device with a 
   random application.

B) Redmon is starting faxredir, feeding the document data
   to stdin of faxredir.

C) faxredir writes the data to a file and starts a batch file.
   Example: faxredir c:\temp\psfile.ps c:\fax\mybatch.bat
      will write the stdin up to eof to c:\temp\psfile.ps. 
      After that it will run c:\fax\mybatch.bat

D) (happens in the batch file) the created data file will be 
   uploaded to the intranet web server with ftp.

E) (happens in the batch file) netscape will be started with
   a random url. The url will contain the name of the file 
   written with ftp as cgi parameter.

F) The user gets a html-form asking for the fax number. Pressing 
   the submit button of the form will start a cgi script running
   sendfax with the approbiate parameters.

Example:
---------

I assume that your NT installation is living on drive c:
You install redmon with 
Program name: c:\fax\faxredir.exe
Parameters:   c:\fax\faxfile.ps c:\fax\fax.bat
Create a directory c:\fax. 
Copy fax.bat and fax.ftp to this directory

YOU HAVE TO EDIT THIS FILES TO ADAPT THEM TO YOUR SITUATION.
It is very unlikely that they will work for you out of the box 
;-))

faxsetup.bat
-------------

faxsetup.bat is a small batch file which takes one parameter 
(a drive letter. Example: faxsetup.bat c:) and creates 

- the directory x:\fax
- x:\fax\fax.bat
- x:\fax\fax.ftp
and copies 
- faxredir.exe to x:\fax.

This batch file makes sense if you have to install this on several
NT boxes. You have to change faxsetup.bat according to your needs.

Remarks:
---------

Instead of ftping the data to your web server it would also possible 
to use samba and simply copy the file. Disadvantage: You need samba 
and maybe you are running into authentification problems. However, I 
assume that you are knowing what you do, so its up to you.

It is a good idea to create a user only for receiving the fax files 
on the linux (or unix) box. 

Bugs, Problems:
----------------

There are no cgi scripts included yet, because my cgi scripts are 
not usable in a stand alone manner. (I don't think that you want to 
install 100k perl scripts, 5 or 6 different perl modules, php/fi, 
postgres and 20 data base tables only to get fax running). I would be
happy if someone can contribute some example scripts.

You can easily produce race conditions on the NT box and get a 
mess with the fax files. Instruct your users to complete one 
fax sending action before starting the next.

faxredir.exe is a very dumb program with no error handling. 
If you dont give two command line parameters you will get 
ugly error messages. redrun is included in the redmon distribution 
and should do the same as faxredir. Unfortunately redrun doesn't 
work for me, I don't know why.

I don't know if this also works with Windows 95. I tested this with 
Linux and Windows NTWS 4.0 German Edition.

Files:
-------
Message 	- this is my original posting on the hylafax mailinglist
README  	- this file
fax.bat 	- example batch file
fax.ftp 	- example ftp response file
faxredir.c 	- source for faxredir.exe
faxredir.exe	- binary: faxredir.exe 
faxsetup.bat	- example installation batch file

Richard Kail:
-------------
If you have remarks, contributions or whatever, feel free to send me Email:

rkail@prip.tuwien.ac.at
or
e8903122@student.tuwien.ac.at


Legal stuff:
-------------
All files in this archive are placed into public domain.


Vienna, Apr 25 1998

