Installation

Installation of required tools

Install the following tools on your system:

Installation of Zope Application Servers

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

  1. extract tarbal of Zope-2.6.1 to /usr/local/

  2. start installing by calling ./install located in Zope directory

  3. create initial user by calling python2.1 zpasswd.py access

  4. run a chmod o+t on directory /usr/local/Zope*/var

  5. create system user zope by running adduser zope

  6. pass UID of user zope to z2.py

  7. 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)

  8. create user faxuploader in Zope

Configure Apache Webserver

  1. change directory to /usr/local/Zope/pcgi/ and call commands ./configure, make, make install

  2. link /usr/local/Zope-2.6.1-x/Zope.cgi to /var/www/cgi-bin/Zope

  3. 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]

Installation and configuration of HylaFax Server

The installation is done as described by the HylaFax HowTos, that can be found at the HylaFax hoempage (http://www.hylafax.org).

  1. installing Hylafax-RPM - we are using HylaFax-4.1.7 (take a look at the pakage dependencies)

  2. run/usr/sbin/faxsetup (take a look at HylaFax-HowTo)

  3. run/usr/sbin/faxaddmodem

  4. place the line 'mo:2345:respawn:/usr/sbin/faxgetty ttySx' in /etc/inittab

  5. 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

Installation of Zope Product ZopeFax

Before importing ZopeFax check availability of following Zope Products:

The products Xron and LDAPUserFolder have to be installed. DBTab is optional.

Now you can install the product ZopeFax.

  1. Import ZopeFax (XML-File) to Zope - Attention!: Remove existing version of ZopeFax Product (not Instance) before importing the new Product

  2. create directory faxTemp/ in directory /usr/local/Zope*/var with read and write permissions for user zope (used for temporary read and write processes)

  3. 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)

  4. 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.

Create an instance of ZopeFax

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.

  1. Create a new instance using the Drop Down Box situated in the upper left corner of the window - chooseFax-Instanz and click Add

  2. Change to ZopeFax instance and customize Xron Object faxAge:

  3. check settings of LDAPUserFolder object acl_users in the top level directory of ZopeFax instance