ZopeFax Quick Installation Guide: Dokumentation der T-Systems GEI GmbH Business Unit Sachsen, Version 1.0 (01.04.2004) | ||
---|---|---|
<<< Previous | Quick Installation Guide | Next >>> |
Install the following tools on your system:
python2.1
install/check availability of Python modules after installing Zope Application Server:
ldap
os
gzip
PIL - Python Imaging Library
re
StringIO
string
sys
time
traceback
ZODB
Zope
Perl
Perl modules:
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
libtiff-3.5.7-2
ghostscript-6.52-9.5
tiff2png-0.91
Notice: Zope is shipped with an own Python interpreter an several libraries. This interpreter is (after installing Zope) responsible for interpreting python scripts. Python 2.1 interpreter is only used for installation purpose.
Installing Zope 2.6.1
extract tarbal of Zope-2.6.1 to /usr/local/
start installing by calling ./install located in Zope directory
create initial user by calling python2.1 zpasswd.py access
run a chmod o+t on directory /usr/local/Zope*/var
create system user zope by running adduser zope
pass UID of user zope to z2.py
link directory site-packages of python2.1 to /usr/local/Zope*/lib/python2.1/ (for example ln -s /usr/lib/python2.1/site-packages /usr/local/zope/lib/python2.1/site-packages)
create user faxuploader in Zope
Configure Apache Webserver
change directory to /usr/local/Zope/pcgi/ and call commands ./configure, make, make install
link /usr/local/Zope-2.6.1-x/Zope.cgi to /var/www/cgi-bin/Zope
Add the folowing RewriteRule to your Apache config file
Our 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] |
The installation is done as described by the HylaFax HowTos, that can be found at the HylaFax hoempage (http://www.hylafax.org).
installing Hylafax-RPM - we are using HylaFax-4.1.7 (take a look at the pakage dependencies)
run/usr/sbin/faxsetup (take a look at HylaFax-HowTo)
run/usr/sbin/faxaddmodem
place the line 'mo:2345:respawn:/usr/sbin/faxgetty ttySx' in /etc/inittab
create user 'fax'
After this general installation steps you have to configure your modem. Search for a valid configuration file for your modem and customize the configuration (for example customize dial string)
After finishing installation and configuration of HylaFax and you modem you have to copy the file faxrcvd (shipped with ZopeFax) to /var/spool/hylafax/bin/faxrcvd. After copying the file you have to customize the content of faxrcvd. Customizing means to assign the variables for Zope Server (FQDN), Mail Server, LDAP Server and Base DN, addresses of sender and recipient of e-mail and the password for Zopeuser faxuploader to the correct values. After configuring faxrcvd, the script will perform the following actions if a fax is received by the HylaFax Server:
send e-mail to specified address if a fax is not received completely
convert fax to required formats
create fax object and its properties on Zope-Server by transferring files via ftp
notify faxmanager (LDAP group) via e-mail about new fax
Before importing ZopeFax check availability of following Zope Products:
DBTab - optional
Xron
LDAPUserFolder (Used for LDAP authentication)
Now you can install the product ZopeFax.
Import ZopeFax (XML-File) to Zope - Attention!: Remove existing version of ZopeFax Product (not Instance) before importing the new Product
create directory faxTemp/ in directory /usr/local/Zope*/var with read and write permissions for user zope (used for temporary read and write processes)
copy external Zope-Scripts (rotateFax.py, faxRecover.py, libRotate.py, searchLDAP_sort.py) to /usr/local/Zope*/Extensions (user zope must have permissions to execute these scripts)
check Xron-Scheduler Catalog - it could be possible, that the import leads to replication of a Xron Object (included in Zopefax) in the scheduler, so that the scheduler includes one or more Xron Objects. Delete these objects or try "update catalog" to clear the scheduler. The Xron Objects are only used by an instance of the ZopeFax but not by the product.
Before creating a new instance, you have to do some configuration tasks. You can configure ZopeFax by editing the Propertysheets of the product. Please check the if all values are set correctly.
Create a new instance using the Drop Down Box situated in the upper left corner of the window - chooseFax-Instanz and click Add
Change to ZopeFax instance and customize Xron Object faxAge:
set current date and time for Execute at to let faxAge check for old fax (for example 2003/11/28 01:00:00 GMT+1)
customize Reschedule Interval (for example 1.0 means once per day)
check settings of LDAPUserFolder object acl_users in the top level directory of ZopeFax instance
set correct User Base DN - LDAP Directoy of users
set correct Groups Base DN - LDAP Directory of groups
in Tab "LDAP Schema" check following mappings:
LDAP Attribut mail has to exist, which represents email addresses of an users
LDAP Attribut uid has to exist, which represents the user id
LDAP Attribut cn has to exist, which represents the Canonical User Name of an user
LDAP Attribut sn has to exist, which represents the Last Name of an user
<<< Previous | Home | Next >>> |
Quick Installation Guide | Up | Quick Installation Guide - Deutsch |