ZopeFax Quick Installation Guide: Dokumentation der T-Systems GEI GmbH Business Unit Sachsen, Version 1.0 (01.04.2004) | ||
---|---|---|
<<< Previous | Quick Installation Guide - Deutsch |
Installation von python2.1
Installation/Überprüfen folgender Python-Module nach der Installation des Zope Servers:
ldap
os
gzip
PIL - Python Imaging Library (nachträglich zu installieren)
re
StringIO
string
sys
time
traceback
ZODB
Zope
Installation von Perl
Perl-Module installieren:
perl-MIME-Base64
perl-libwww-perl-5.63-9
perl-libnet-1.0901-17
perl-URI-1.17-16
perl-Sendmail
perl-ldap
perl-Convert-ASN1
Installation von libtiff-3.5.7-2
Installation von ghostscript-6.52-9.5
Installation von tiff2png-0.91
Bemerkung: Zope bringt einen eigenen Python-Interpreter und die dazugehörigen Bibliotheken mit. Dieser neue Interpreter ist dann für die Bearbeitung der Python-Skripte in Zope zuständig. Der Python2.1-Interpreter wird hauptsächlich für die Installation von Zope benötigt.
Grundinstallation von Zope 2.6.1
Entpacken von Zope-2.6.1 nach /usr/local/
Starten der Installation durch Aufruf ./install im Zope-Verzeichnis
Initialnutzer anlegen durch das Ausführen von python2.1 zpasswd.py access
Ausführen von chmod o+t auf das Verzeichnis /usr/local/Zope*/var
Anlegen des Nutzers zope durch Aufruf adduser zope
UID des Nutzers zope in z2.py hinterlegen
Verzeichnis site-packages von python2.1 nach /usr/local/Zope*/lib/python2.1/ verlinken (z.B. ln -s /usr/lib/python2.1/site-packages /usr/local/zope/lib/python2.1/site-packages)
Anlegen des Nutzers faxuploader in Zope
Anpassung des Apache-Webservers
innerhalb von /usr/local/Zope/pcgi/ die Befehle ./configure, make, make install ausführen
Datei von /usr/local/Zope-2.6.1-x/Zope.cgi nach /var/www/cgi-bin/Zope verlinken
Hinterlegen der benötigten RewriteRules in der Apache-Config-Datei
Unsere RewriteRules in httpd.conf:
RewriteEngine on RewriteRule ^/static/(.*) /var/www/html/$1 [l] RewriteRule ^/cgi-bin/(.*) /var/www/cgi-bin/$1 [e=HTTP_CGI_AUTHORIZATION:%1,t=application/x-httpd-cgi,l] RewriteCond %{HTTP:Authorization} ^(.*) RewriteRule ^/(.*) /var/www/cgi-bin/Zope/FaxDB/Fax/$1 [e=HTTP_CGI_AUTHORIZATION:%1,t=application/x-httpd-cgi,l] |
Die Installation des HylaFax-Servers erfolgte nach den HowTos, die auf der Hersteller-Seite des HylaFax-Servers zu finden sind (http://www.hylafax.org). Es wurde dabei wie folgt vorgegangen.
Installieren von Hylafax-RPM - in unserem Fall HylaFax-4.1.7 (Packetabhängigkeiten beachten)
Ausführen von /usr/sbin/faxsetup (siehe HylaFax-HowTo)
Ausführen von /usr/sbin/faxaddmoden
Den Eintrag 'mo:2345:respawn:/usr/sbin/faxgetty ttySx' in die Datei /etc/inittab einfügen
Anlegen des Nutzers 'fax'
Nach dieser Grundinstallation sind noch weitere Vorkehrungen zu treffen. Es muss für das jeweilig verwendete Modem eine gültige Konfigurationsdatei vorliegen, die eventuell an die spezifischen Gegebenheiten angepasst werden muss (z.B. Dialstring anpassen).
Nach der Installation und Konfiguration des Fax-Servers und des Modems ist die mitgelieferte Datei faxrcvd nach /var/spool/hylafax/bin/faxrcvd zu kopieren. Danach muss das Skript konfiguriert werden, indem spezielle Variablen im Skript mit aktuellen Werten belegt werden. Es müssen u.a. Angaben zum Namen des Zope-Servers (FQDN), des Mail-Servers, des LDAP-Servers und dessen Base DN gemacht werden sowie die Angabe von Absender- und Empfängeradressen für automatisch generierte Mails (durch faxrcvd) und die Angabe des Zope-FTP-Users faxuploader sowie dessen Passwort. Wurden alle benötigten Informationen eingetragen, so führt dieses Skript bei dem Empfang von Faxen folgende Aktionen durch:
bei fehlerhaftem Empfang spezielle E-Mail-Adresse anschreiben
Fax wird in alle notwendigen Formate konvertieren
durch den Einsatz der Perl-Module Net::FTP und HTTP::Request wird das Faxobjekt bzw. dessen Properties auf dem Zope-Server angelegt und die Dateien übertragen
Benachrichtigung der Faxmanager (LDAP-Gruppe) per Email über Faxeingang
Diese Installation und Konfiguration ermöglicht den Fax-Empfang über den jeweiligen Server. Für das Versenden von Faxen ist eine spezielle Client-Applikation unter Microsoft Windows vorgesehen - der Windows HylaFax Client (WHFC). Um Clients das Versenden von Faxen über HylaFax zu ermöglichen, muss die Datei $hylafax/etc/hosts.hfaxd dahingehend verändert werden, dass beispielsweise Clients einer bestimmten Domain Faxe versenden dürfen.
Vor der Installation bzw. des Imports des ZopeFax-Produktes müssen zusätzlich folgende Zope-Produkte installiert/importiert werden:
DBTab - optional (z.B. zur Erstellung einer eigenen Zope-DB zur Trennung der Daten einer Fax-Instanz von der Zope-DB)
Xron
LDAPUserFolder (Konfiguration der LDAP-Parameter)
Nach der Installation dieser Produkte kann die Installation des ZopeFax-Produktes vorgenommen werden.
Import des Fax-Produktes (als XML-File) in Zope-Umgebung - Achtung!: Bereits vorhandene Version des Fax-Produktes (nicht Instanzen) vor dem Import löschen
Anlegen eines Verzeichnises faxTemp/ im Verzeichnis /usr/local/Zope*/var mit Lese- und Schreibrechten für den Nutzer zope(benötigt für temporäre Lese-/Schreibprozesse des Fax-Produktes)
Kopieren der benötigten Zope-externen Skripte (rotateFax.py, faxRecover.py, libRotate.py, searchLDAP_sort.py) in das Verzeichnis /usr/local/Zope*/Extensions (User zope muss zur Ausführung der Skripte berechtigt sein)
Überprüfen des Xron-Scheduler Catalog - im Fax-Produkt gibt es ein Xron-Objekt, das durch den Import im Scheduler auftaucht und sich dort repliziert, obwohl es deaktiviert ist -> "update catalog" oder explizites Löschen des Xron-Objektes
Vor dem Erzeugen der neuen Faxinstanz sollten noch bestimmte Konfigurationsangaben in dem Faxprodukt überprüft werden. Diese Angaben sind in den Propertysheets des Fax-Produktes enthalten. Bitte vergewissern Sie sich, dass die Angaben in den Propertysheets korrekt sind oder passen Sie diese eventuell auf Ihre Bedürfnisse an.
Anlegen einer neuen Fax-Instanz über die Drop-Down-Box im oberen rechten Fensterbereich des Zope-Management-Interfaces - Fax-Instanz auswählen und Add klicken (bei Bedarf über fstab als Unterverzeichnis einer eigenen Zope-Datenbank)
Wechsel in die Fax-Instanz (in oberste Verzeichnisebene) und Anpassung des Xron-Objektes faxAge:
aktuelles Datum und Zeitangabe für Execute at setzen zur Ausführung der Überprüfung auf veraltete Faxe (z.B. 2003/11/28 01:00:00 GMT+1)
Wert setzen für Reschedule Interval als Angabe für Periodizität der Überprüfung (z.B. 1.0 bedeutet einmalige Ausführung pro Tag)
Überprüfen der Einstellungen im LDAPUserFolder-Objekt acl_users auf der obersten Verzeichnisebene der Fax-Instanz auf
Korrekte User Base DN - Verzeichnis der Nutzer im LDAP
Korrekte Groups Base DN - Verzeichnis der Gruppen im LDAP
Unter Tab "LDAP Schema" Mappings kontrollieren:
LDAP Attribut mail muss vorhanden sein, unter dem E-Mail-Adressen zu finden sind
LDAP Attribut uid muss vorhanden sein, unter dem Nutzer-ID zu finden ist
LDAP Attribut cn muss vorhanden sein, unter dem Canonical User Name zu finden ist
LDAP Attribut sn muss vorhanden sein, unter dem Last Name des Users zu finden ist
<<< Previous | Home | |
Quick Installation Guide - Deutsch | Up |