Der perfekte Push-Mail-Server - Debian Squeeze (Debian 6.0) mit ISPConfig 3 & Z-push

Version 1.0
Autor: Zicguy

Dieses Tutorial beschreibt die Installation und Konfiguration von Z-push auf einem Debian Squeeze-Server mit ISPConfig 3. Z-push ist eine Open-Source-Anwendung zur Synchronisierung von ActiveSync-kompatiblen PDAs und Mobiltelefonen. Z-Push wurde ursprünglich von Zarafa Deutschland GmbH (Deutschland) entwickelt. Am Ende dieses Tutorials sollten Ihre Kunden in der Lage sein, ihre Mobiltelefone mithilfe der Push-Technologie mit ihren E-Mail-Konten auf Ihrem Server zu synchronisieren.

Ich gebe keine Garantie, dass dies bei Ihnen funktioniert!

1 Anforderungen

Um Z-push zum Laufen zu bringen, benötigen Sie Folgendes:

einen voll funktionsfähigen Debian Squeeze-Server mit ISPConfig 3,
Apache 2, Php 5 und Dovecot (unter Verwendung des IMAP-Protokolls) installiert und funktionsfähig auf Ihrem Server,
ein Mobiltelefon (ich habe für dieses Tutorial ein 3GS iPhone verwendet).

2 Vorbemerkung

In diesem Tutorial verwende ich den Hostnamen example.com als Hauptdomain des Servers. Ich verwende auch die E-Mail-Domain toto.com als Kundendomain, die auf dem Server gespeichert ist. Diese Einstellungen können bei Ihnen abweichen, daher müssen Sie sie bei Bedarf ersetzen.

3 Erforderliches Paket

Um Z-push zum Laufen zu bringen, muss Ihr Server das php-soap-Paket haben. Also installieren wir es:

apt-get install php-soap

4 Z-push-Installation

Wir können Z-push herunterladen, indem wir es von zarafa-deutschland.de herunterladen. Natürlich können Sie die tar.gz-Datei durch die letzte stabile Version ersetzen. Zur Information: Die neue Version 2.0.6 ermöglicht die Verwaltung von HTML-E-Mails mit Z-push.
Wie gewohnt laden wir es in den /tmp-Ordner herunter:

cd /tmp
wget zarafa-deutschland.de/z-push-download/final/2.0/z-push-2.0.6-1616.tar.gz
tar -xzvf z-push-2.0.6-1616.tar.gz
mkdir -p /usr/share/z-push
cp -R z-push-2.0.6-1616/ /usr/share/z-push
rm -rf z-push

Jetzt ist Z-push auf Ihrem Server in /usr/share/z-push installiert.

5 Z-push-Konfiguration

Z-push benötigt zwei weitere Verzeichnisse, um zu funktionieren: /var/lib/z-push und /var/log/z-push. Also erstellen wir sie und ändern die Besitzer und Rechte:

mkdir -p /var/lib/z-push
mkdir -p /var/log/z-push
chown www-data:www-data /var/lib/z-push
chown www-data:www-data /var/log/z-push
chmod 750 /var/lib/z-push
chmod 750 /var/log/z-push

Dann müssen wir die Datei /usr/share/z-push/config.php an unsere Bedürfnisse anpassen:

vi /usr/share/z-push/config.php

Wir ändern die

Zeitzone

(z.B.

Europa/Paris

) und den

Backend-Anbieter

(in unserem Fall

BackendIMAP

[...]
define('TIMEZONE', 'Europe/Paris');
[...]
define('BACKEND_PROVIDER', "BackendIMAP");
[...]

6 Apache- & PHP-Konfiguration

Wir möchten, dass unsere Kunden ihre Mobiltelefone mit ihrer eigenen Domain konfigurieren. Zum Beispiel hat ein Kunde eine E-Mail-Domain, die toto.com heißt, die auf unserem Server gespeichert ist. Wir möchten, dass der Kunde sein E-Mail-Konto auf seinem Mobiltelefon mit toto.com konfiguriert. Also erstellen wir eine apache.conf-Datei in /usr/share/z-push:

vi /usr/share/z-push/apache.conf

Es wird so aussehen:

Alias /Microsoft-Server-ActiveSync /usr/share/z-push/index.php

      Options -Indexes
      AllowOverride None
      Order allow,deny
      allow from all

Z-Push ist eine Implementierung des ActiveSync-Protokolls, weshalb wir einen solchen Alias verwenden müssen.

Stellen Sie sicher, dass PHP die folgenden Einstellungen hat:

php_flag magic_quotes_gpc off
php_flag register_globals off
php_flag magic_quotes_runtime off
php_flag short_open_tag on

Wenn nicht, können Sie diese Zeilen in der /usr/share/z-push/apache.conf innerhalb des Directory-Tags hinzufügen.

Danach müssen wir Apache neu starten, um die Änderungen zu berücksichtigen:

service apache2 restart

7 Open Basedir PHP-Konfiguration

Das Letzte, was wir auf unserem Server tun müssen, ist die Konfiguration des Open Basedir PHP unserer Hauptdomain. Wir können dies mit ISPConfig tun.
In diesem Tutorial können wir unter https://example.com:8080 auf ISPConfig zugreifen und uns mit Administratorrechten anmelden.
Unter ISPConfig habe ich eine Website erstellt, die mit example.com übereinstimmt.
Also klicken wir auf die Registerkarte Websites und bearbeiten die example.com-Website. Dann klicken wir auf die Registerkarte Optionen.
Im open_basedir PHP-Feld fügen Sie am Ende der Zeile Folgendes hinzu:

:/usr/share/z-push:/var/lib/z-push:/var/log/z-push

Dies gibt den Webbenutzern Zugriff auf die Ordner /usr/share/z-push, /var/lib/z-push und /var/log/z-push.

Jetzt ist alles auf unserem Server erledigt!

8 Mobile Konfiguration

Wir können jetzt testen, ob das Push-Protokoll funktioniert, indem wir ein E-Mail-Konto auf einem Mobilgerät konfigurieren. Für dieses Tutorial habe ich ein 3GS iPhone verwendet, aber es sollte auch mit Android-, Windows- oder BlackBerry-Mobilgeräten funktionieren.
Um es zum Laufen zu bringen, müssen wir ein Exchange-Konto konfigurieren.
Auf dem iPhone gehen wir zu Einstellungen > Mail > Konto hinzufügen. Dann wählen wir Microsoft Exchange. Zuerst müssen wir die E-Mail-Adresse, das Passwort und die Beschreibung des Kontos, das wir verwenden möchten, ausfüllen.
Auf dem nächsten Bildschirm müssen wir das Serverfeld ausfüllen. Wenn die E-Mail-Adresse z.B. [email protected] ist, können wir toto.com für das Serverfeld verwenden. Wir verwenden die E-Mail-Adresse für das Benutzerfeld. Wir können wählen, ob wir das SSL-Protokoll verwenden möchten, wenn es auf unserem Server konfiguriert ist.
Schließlich bestätigen wir mit einem Klick auf OK.

Fertig! Jetzt sollte das Mobiltelefon E-Mails vom Server sofort empfangen…

Der perfekte Push-Mail-Server - Debian Squeeze (Debian 6.0) mit ISPConfig 3 & Z-push