Voraussetzungen¶

• Apache-Webserver mit PHP: Apache 2, PHP 5

• Mailserver: Mailserver Einführung, Postfix

• Datenbankserver: MySQL 5

Alternativ kann man zum Testen auch eine z.T. vorkonfigurierte virtuelle Maschine auf Basis von Ubuntu 10.04 verwenden (benötigt VMware Player oder VMware Server; siehe auch Virtualisierung). Eine weitere Möglichkeit ist die auf Ubuntu basierende Server-Distribution Zentyal.

MySQL¶

Zarafa braucht eine Datenbank zur Speicherung der Daten. In der hier beschriebenen Anleitung wird MySQL als Datenbank verwendet. Falls ein anderes Datenbanksystem verwendet werden soll, wird auf die Dokumentation zu Zarafa verwiesen.

Weiterhin ist es empfehlenswert, unter Ubuntu auch einen neuen Benutzer zarafa anzulegen (siehe Benutzer und Gruppen), der nur über eingeschränkte Rechte verfügen sollte. Allerdings sollte dieser alle Rechte auf die verwendete Datenbank haben.

Zum Anlegen der Datenbank und des MySQL-Benutzers kann auch phpMyAdmin verwendet werden. Die entsprechende URL im Webbrowser lautet: http://<Server-IP>/phpmyadmin oder http://localhost/phpmyadmin (nur auf dem Server selbst möglich). Nach Anmeldung als Root (Benutzername root, ohne Kennwort) wird der Menüpunkt "Rechte -> Neuen Benutzer hinzufügen" ausgewählt und dann ein Nutzer mit folgenden Daten angelegt:

• Benutzername: beliebig, z.B. zarafa

• Host: localhost (die Datenbank befindet sich auf dem gleichen Rechner)

• Kennwort: ******** (beliebig wählbar)

• Datenbank für Benutzer: erstelle eine Datenbank mit gleichem Namen und gewähre alle Rechte

Es empfiehlt sich, an dieser Stelle auch ein MySQL-Passwort für den Benutzer root zu vergeben, falls nicht schon bei der Installation von MySQL geschehen.

Fremdquelle¶

Zarafa ist nicht in den offiziellen Paketquellen enthalten. Man kann aber Canonical Partner als Paketquelle ^[1] nutzen. Anschließend lassen sich die Pakete:

• zarafa

• zarafa-webaccess

• zarafa-libs

• zarafa-licensed

installieren ^[2] (siehe auch Installing Zarafa from Ubuntu Repository ).

Manuell¶

Vor der eigentlichen Installation müssen noch folgende Pakete, falls nicht vorhanden, installiert werden:

• libcurl3

• libldap-2.4-2 (nur wenn LDAP zur Benutzerverwaltung verwendet werden soll)

tar -xzvpf zarafa-VERSION-Ubuntu-VERSION-SYSTEMARCHTEKTUR.tar.gz 

cd zarafa-VERSION-Ubuntu-VERSION-SYSTEMARCHTEKTUR 

sudo dpkg -i zarafa*
sudo dpkg -i lib* 

Lizenz¶

Wer keine Serien-Nummer hat, lässt diese leer:

sudo echo "Serien-Nummer" > /etc/zarafa/license/base 

Postfix¶

Auch der Mailserver Postfix muss noch konfiguriert werden. Dazu wird die Datei /etc/postfix/main.cf editiert und folgende Zeilen angefügt.

mailbox_command = /usr/bin/zarafa-dagent "$USER"
mailbox_transport = zarafa: zarafa_destination_recipient_limit = 1

Wer eine eigene Maildomain berücksichtigen möchte, sucht den Eintrag mydestination = ... in dieser Datei und ändert ihn ab:

# eigene Maildomain statt example.com eintragen, ansonsten entfernen
mydestination = hostname.local, example.com, localhost.hostname.local, localhost

Auch die Datei /etc/postfix/master.cf muss noch bearbeitet werden:

zarafa    unix  -       n       n       -       10       pipe
  flags=DRhu user=vmail argv=/usr/bin/zarafa-dagent -R ${recipient}

Abschließend wird noch ein eigener Benutzer vmail angelegt:

sudo adduser --system --no-create-home vmail 

Dieser Benutzer muss auch in der Datei /etc/zarafa/server.cfg der Variablen local_admin_users hinzugefügt werden.

Dienste neu starten¶

Nun werden der Web- und der E-Mail-Server neu gestartet:

sudo /etc/init.d/apache2 restart
sudo /etc/init.d/postfix restart 

Nachdem man dies erledigt ist, muss Zarafa die Datenbank mit Werten füllen. Hierzu reicht es aus, den Dienst zu starten:

sudo /etc/init.d/zarafa-server start 

oder - falls der Dienst schon gestartet sein sollte - mit:

sudo /etc/init.d/zarafa-server restart 

neuzustarten. Nun sollte die Datenbank mit Standardwerten gefüllt worden sein.

Dateianlagen¶

In der Standardeinstellung werden alle Anlagen (attachments) in der Zarafa-Datenbank gespeichert. Dies hat den Vorteil, dass man diese einfach komplett sichern kann. Nachteilig ist unter Umständen aber die wachsende Größe der Datenbank, insbesondere da viele Benutzer ihr Postfach nicht pflegen bzw. das Postfach als Datensicherung/Backup für ihre Anlagen verwenden.

Ab Version 6 ist in Zarafa das Werkzeug /usr/share/zarafa/db-convert-attachments-to-files enthalten, das Anlagen aus der Datenbank entfernt und im Dateisystem ablegt.

max_allowed_packet is read-only¶

Wenn der verwendete MySQL-Benutzer nicht genügend Rechte besitzt, kann folgende Fehlermeldung in der Datei /var/log/zarafa/server.log auftauchen:

082FB6D0: SQL Failed: SESSION variable 'max_allowed_packet' is read-only. Use SET GLOBAL to assign the value,
Query: -SET max_allowed_packet = 16777216-
Unable to connect to database: SESSION variable 'max_allowed_packet' is read-only. Use SET GLOBAL to assign the value

Diese SQL-Meldung sagt aus, dass der gegenwärtige Benutzer die Option read-only nicht ändern darf. In diesem Falle sollten die Berechtigungen nochmals kontrolliert werden. Alternativ kann in der Datei /etc/mysql/my.cnf auch direkt max_allowed_packet = 16M gesetzt werden. Anschließend muss der MySQL-Server neu gestartet werden.