################################################################################
#                                                                              #
#                Fax-FLI4L-Exchange-Connector                                  #
#                         Version 0.6                                          #
#                                                                              #
#                      von Matthias Hoppe                                      #
#                         Ingo Rler                                          #
#                                                                              #
################################################################################


Funktionsumfang
---------------
OPT_FAXXCG konvertiert eingehende Faxe in PDFs und stellt diese ber einen 
MS Exchange-Server den Nutzern zur Verfgung.

Variante fr Arme ;o) :

OPT_FAXXCG konvertiert eingehende Faxe in PDFs und stellt diese in einer 
Dateifreigabe auf einem Server den Nutzern zur Verfgung und informiert diese 
ber den Windows-Informationsdienst.


Programmablauf
--------------
1. Nach der bergabe des Faxes von OPT_FAXRCV wird versucht die Faxkennung zu 
   identifizieren.
2. Die Faxdatei wird entpackt und auf den Backup-Rechner gesichert.
3. Ein Infotext wird erstellt.
4. Erstellen eines Mailtextes

5. (optional)
   Anfgen der Faxdatei an den Mailtext
   
6. (optional)
   Erstellen eines Postscriptfiles, und eines PDFs
   Kopieren des PDFs auf den Backup-Rechner
   Anfgen des PDFs an den Mailtext

7. (optional)
   Erstellen eines Mailheaders 
   Kopieren der Mail in einem ffentlichen Ordner eines MS Exchange2000-Servers
   
8. (optional)
   Versenden eines Winpopup mit der Mitteilung das ein Fax angekommen ist.
   
Die Faxkennungen sind hndisch ber das Webinterface zu pflegen.


Vorraussetzung
--------------
FLI4L 2.1.8 oder FLI4L 2.1.7, aber unter 2.1.7 nicht getestet.
Festplatteninstallation
	OPT_FAXXCG selber ist klein. Aber es werden grosse OPTs bentigt, die 
	eine Festplatte bentigen.
OPT_FAXPRINT (optional fr PDF-Ausgabe)
	Es werden die Programme des OPTs bentigt.
	OPT_FAXPRINT='yes'
	Falls der sofortige Druck der Faxe (eigentlicher Sinn des OPTs) nicht 
	gewollt ist, darf OPT_FAXPRINT nicht in der faxrcv.txt eingetragen werden.
OPT_FAXRCV
        OPT_FAXRCV muss das Fax an diese Script bergeben.
        Dies geschieht, indem in der faxrcv.txt folgendes eingetragen wird:
        FAXRCV_1_NTFYCMD_1='/usr/local/bin/fax_exchange.sh'
OPT_SAMBATOOLS
	Die Sambatools werden nicht nur fr die Popup bentigt, sondern auch um 
	auf den	Backup-Server und den Exchange-Server zuzugreifen. 
	Es werden keine Freigaben auf den Router bentigt.
OPT_HTTPD
        Wird fr das Faxkennungs-Interface bentigt.
OPT_ISDN
        Nunja, dies ist Vorraussetzung fr OPT_FAXRCV und sollte schon laufen 
        mit einer AVM-ISDN-Karte
        
Ein SMB-Server (also irgendein Windows-Rechner oder ein Linux mit Samba) fr die
Backups und ggf. die PDFs.
Ein MS Exchange-Server zum schnellen und bersichtlichen Zugriff auf Faxe. 
(optional)


Konfiguration
-------------
Server:
Auf einen beliebigen Rechner (Windows oder Linux mit Samba) eine Freigabe 
einrichten.
Dieser Rechner sollte immer zur Verfgung stehen, wenn ein FAX zu erwarten ist.
Der Freigabename muss mit einem "$" enden (z.B. faxe$ ). Damit wird verhindert, 
dass die Freigabe in der Netzwerkumgebung sichtbar wird.
Diese Rechner kann natrlich auch der Exchange-Server sein.

Exchangeserver:
Es muss kein Exchangeserver zur Verfgung stehen.
In diesem Fall ist FAXXCG_EX='no' zu whlen.
Falls der Exchange-Server zur Publikation der Faxe genutzt werden soll, muss
1. ein User im ADS eingerichtet werden. Dieser User sollte keine 
   Anmeldeberechtigung haben.
2. eine Gruppe im ADS eingerichtet werden. Diese Gruppe soll das Recht erhalten 
   FAXE zu lesen.
3. ein Ordner unter den ffentlichen Ordner im Exchange-Server erstellt werden.
   Der Admin und der User unter 1. hat volle Rechte auf diesen Ordner.	
   Die Gruppe aus 2. darf den Ordner sehen und hat Leserechte. Ob die Gruppe 
   Objekte lschen darf, ist Geschmackssache.
4. Dieser Ordner wird wiederum freigegeben. Auch hier muss der Freigabename mit 
   einem "$" enden (z.B. faxe$ ).
   Der User aus 1. erhlt volle Rechte.

Router:
Eine Festplatten-Installation nach Doku wird unumgnglich sein.
Weiterhin muss die AVM-ISDN-Karte korrekt eingebunden sein.

faxrcv.txt
FAXRCV_1_NTFYCMD_X='/usr/local/bin/fax_exchange.sh'
Entscheidend um OPT_FAXRCV dazu zu bewegen, das eingehende Fax an dieses OPT 
weiterzureichen.

faxprint.txt
OPT_FAXPRINT='yes'
Falls das OPT an sich NICHT genutzt werden soll, recht dies.

samba_lpd.txt:
OPT_SAMBATOOLS='yes'

httpd.txt
OPT_HTTPD='yes'
Bitte in die entsprechende Doku schauen, wie dieses OPT konfiguriert wird.

faxxcg.txt:

OPT_FAXXCG='no'
	Das OPT wird installiert mit der Einstellung 'yes'.


FAXXCG_EX='no'
	Es steht ein MS Exchange-Server zur Verfgung und dieser soll zur 
	FAX-Publikation genutzt werden.
	Falls dies nicht sein soll einfach FAXXCG_EX='no' eintragen.
	Die weiteren FAXXCG_EX_... Einstellungen knnen dann ignoriert werden.

FAXXCG_SRV_EX='exchange'
	Name des Exchange-Servers

FAXXCG_EX_SHARE='faxe'
	Name der Freigabe auf dem Exchangeserver ohne abschliesendes "$"!!
	Die Freigabe heisst 'faxe$', dann ist hier nur 'faxe' einzutragen.

FAXXCG_EX_USER='user'
	User mit Schreibrechten auf diese Freigabe

FAXXCG_EX_PASS='12345'
	Passwort des o.g. Users

FAXXCG_EX_MOUNT='/data/exchange'
	Mountpoint des o.g. Freigabe auf dem Router

FAXXCG_EX_MAIL='root@fli4l.lan'
	Absenderadresse der Notiz im ffentlichen Ordner des MS Exchange-Servers

FAXXCG_EX_SFF='no'
	Die Standard-AVM-Faxdatei wird nicht mit ausgeliefert.
	Diese ist nur spezieller Software lesbar (Fritzfax, Irfan)
	
FAXXCG_EX_PDF='yes'
	In der Notiz im ffentlichen Ordner des MS Exchange-Servers wird das Fax
	als PDF ausgeliefert.
	Hierzu ist die Installation von FAXPRINT zwingend notwendig!


FAXXCG_SRV_BK='server'
	Name des Backuprechner im Netz.
	
FAXXCG_BK_SHARE='faxe'
	Name der Freigabe auf dem Backupserver ohne abschliesendes "$"!!
	Die Freigabe heisst 'faxe$', dann ist hier nur 'faxe' einzutragen.

FAXXCG_BK_USER='user'
	User mit Schreibrechten auf diese Freigabe
	
FAXXCG_BK_PASS='12345'
	Passwort des o.g. Users
	
FAXXCG_BK_MOUNT='/data/fax-backup'
	Mountpoint des o.g. Freigabe auf dem Router
	
FAXXCG_BK_PDF='yes'
	Die Faxe werden zustzlich als PDF auf dem Backup-Server gesichert.
	Hierzu ist die Installation von FAXPRINT zwingend notwendig!
	

FAXXCG_MES='yes'
	Information ber den Windowsnachrichtendienst.
	Dieser Dienst muss auf dem Zielrechner aktiviert sein (Da wir einen 
	FLI4L haben ist dies im Allgemeinen auch kein Problem ;o))
	.
FAXXCG_MES_PC='client1'
	Zielrechner des Windowsnachrichtendienstes


Danksagung
----------
Hiermit mchten wir uns ganz herzlich bei Henri van Riel bedanken, der uns 
uuencode kopilierte.
Und nicht zuletzt gilt unser Dank Frank Meyer und seinem Team fr den FLI4L!
Insbesondere gilt unser Dank der DATEXT IT-Beratungs GmbH (www.datext.de), 
fr die dieses OPT ursprnglich geschrieben wurde.


Kontakt
-------
Bei Fragen, Kritik und Anregungen bitte bei uns melden.
Danke!

Ingo Rler (roessler@gmx.de)
Mathias Hoppe (Mat.Hoppe@gmx.de)