SEP sesam Extension for Zarafa

SEP bietet eine kostenlose Backuplösung für kleine Zarafaumgebungen an

(C)SEP AG

Copyright 1999-2011 by SEP AG. All Rights reserved.

Any form of reproduction of the contents or parts of this manual is allowed only with the express written permission from SEP AG. When compiling and designing user documentation SEP AG uses great diligence and attempts to deliver accurate and correct information. However, SEP AG cannot issue a guarantee for the contents of this manual.

Einleitung

Mit dem SEP sesam Online Modul für Zarafa sind Hot-Backups von Zarafa Groupware Servern möglich. Die beinhaltet das Sichern und Rücksichern einzelner E-mails, Mailboxen und öffentlicher Mailboxen.

Systemvoraussetzungen

SEP sesam / Zarafa version

• Laufende SEP sesam Server version >= 3.4.1.31
• Zarafa Server >=5.20 aufwärts in Linux - Zarafa Community Edition wird nicht unterstützt
• SEP sesam Client >= 3.4.1.31
• Funtionierende Pfadsicherung des Zarafa Servers

Zarafa Community Edition

Die Zaraga Community Edition beinhaltet kein Brick Level Backup API von Zarafa. Aus diesem Grund unterstützt die SEP sesam Zarafa Extension die Zarafa Community Edition nicht.

Siehe: http://www.zarafa.com/content/editions

Selbstverständlich können Sie SEP sesam verwenden um ein Dateisystembackup Ihres Zarafasystems durchzuführen.

Installation

Installieren Sie das SEP sesam Client Paket für Linux auf dem Zarafa Server indem Sie die Zarafa Extension (SEP sesam Extension for Zarafa) herunterladen und die Datei libsbczarafa.so in das SEP sesam Binärverzeichnis (meistens /opt/sesam/bin/sesam) kopieren.

Backup Konfiguration

Die weitere Konfiguration kann über die SEP sesam GUI durchgeführt werden.

Konfiguration von Mailbox Backups

• Erstellen Sie einen neuen Sicherungsauftrag für den Zarafa Server
• Wählen Sie Zarafa als Auftragstyp aus
• Wichtig! Die Größe des Backupverzeichnisses muss mindestens dem Volumen der größten Mailbox entsprechen.
• Geben Sie die Sicherungsquelle im folgenden Format ein:
  

ALL

Alle Benutzer und öffentlichen Ordner

ALL_USERS

Alle Benutzer

PUBLIC_FOLDER

Alle öffentlichen Ordner

<User1>, <User2>, ...

Eine oder mehrere Benutzermailboxen

Ein fertig konfigurierter Sicherungsauftrag sollte wie folgt aussehen:

Exclude list:

Die Exclude List kann verwendet werden um bestimmte Mailboxen von der Sicherung auszuschließen. Excludemuster sind reguläre Ausdrücke, die mit dem Benutzernamen verglichen werden.

Beispiel:

schließt nur den Benutzer support aus und

schließt Benutzer wie support, sepsupport und support1 aus.

Dieser Screenshot zeigt einen Sicherungsauftrag, der alle Benutzer außer "mk" und "shettler" sichert:

Backup von mehreren Mailboxen gleichzeitig

Der Sesam Client 4.0.5.x oder höher erleubt das sichern von mehreren Mailboxen gleichzeitig. Um diese Funktion zu aktivieren und die Anzahl der gleichzeitigen Mailboxen festzulegen, ist der Wert max_exports größer Null (0) zu setzen. Z.B. um die Sicherung von 5 Mailboxen gleichzeitig zu konfigurieren, ist am Backup-Auftrag die folgende Einstellung (Tab Optionen 1) zu machen:

Dieser Paramater erzwingt die angegebene Anzahl von gleichzeitigen zarafa-backup Prozessen auf dem Zarafa Server. Stellen Sie bitte sicher, dass Ihr Zarafa Serversystem soviel Prozesse zur gleichen Zeit handhaben kann.

Restore Konfiguration

Einzelner Mail Restore

Beim Restore können in der SEP sesam GUI einzelne Mails ausgewählt werden. Jetzt gibt es im letzten Register des Rücksicherungsassistenten als einzige Funktion Auto Recover nach Restore. Wird dies gewählt, importiert SEP sesam die Mail in die original Mailbox. Ansonsten werden die exportierten Maildaten und Indexdateien in das Dateisystem nach <SESAMVAR>/work/zarafa rückgesichert und können mit dem Befehl zarafa-restore manuell importiert werden.

Das folgende Beispiel zeigt eine Rücksicherung einer einzelnen Mail in den original Mailordner. SEP sesam importiert diese mit der Option "Auto Recovern und Online nach Restore" automatisch:

Problembehandlung

Allgemeine Informationen zum Sicherungsprozess

SEP sesam verwendet die Zarafa Bricklevel API um die Benutzermailboxen zu sichern. Das bedeutet, der SEP sesam Client erhält als erstes eine Liste von verfügbaren Benutzern im Zarafa System und exportiert dan die zu sichernden Mailboxen mit dem Zarafatool "Zarafa-backup".

Die Mailbox wird standarsmäßig in das Verzeichnis <SESAM_ROOT>/var/work exportiert. Bitte stellen sie sicher, dass die Partition, in der sich Ihr Arbeitsverzeichnis befindet mindestens do groß ist, wie die größte Mailbox in Ihrer Zarafa-Umgebung.

Wenn der Export einer bestimmten Mailbox aus irgendeinem Grund fehlschlägt (nicht genügend Speicherplatz, interne Zarafa Fehler) raten wir, einen Blick auf das SEP sesam Suicherungsprotokoll zu werfen.

Das Sicherungsprotokoll

Das SEP sesam Sicherungsprotokoll enthält eine detaillierte Angabe der Vorgänge während des Zarafa Backups. Weiterhin enthält jeder Aufruf die Zarafa Bricklevel Backup API.

Diese Beispiel zeigt einen Teil eines Zarafa Sicherungsprotokolls mit einem erfolgreichen Aufruf des Zarafa Brickleveltools:

Nach dem Export der Mailbox fährt SEP sesam fort und sichert die exportierten Dateien.

Wenn der Export aus irgendeinem Grund fehlschlägt, wird der Fehler in der SEP sesam Logfile notiert. Dieses Beispiel zeigt eine Sicherung eines Benutzers, der nicht existiert:

Lokaler Test der Sicherung auf dem Zarafa Server

In manchen Fällen kann es wichtig sein erst einen Eindruck davon zu bekommen, wieviel Zeit die Sicherung benötigt. Dies können Sie tun, indem Sie die Zarafa Mailboxen direkt auf den Zarafa Server selbst sichern, ohne auf irgendwelche Medien zu schreiben. Es ist zudem eine praktische Möglichkeit herauszufinden, ob Ihre Firewall Ports aufgrund von kurzen Timeouts schließt, oder nicht.

Sie können dies tun, indem Sie den SEP sesam Backup Clienten auf der Kommandozeile verwenden.

Der folgende Befehl führt eine Sicherung aller Zarafa Mailboxen durch und schreibt die Daten auf /dev/null :

Selbstverständlich ist es auch möglich auf der Kommandozeile nur bestimmte Benutzer zu sichern ("cl" ist in diesem Fall der Benutzername):

Test des Zarafa Bricklevel Exports mit Zarafatools

In manchen Fällen macht es Sinn den Export von Mailboxen nur mit Zarafatools zu testen. Der Export einer Mailbox kann mit dem Befehl "zarafa-backup" durchgeführt werden. Dieses Beispiel zeigt den Export des Benutzers "test" in das aktuelle Verzeichnis:

Nach dem Export sollte das Verzeichnis zwei Dateien enthalten:

Die Datei "index.zbk" enthält eine indizierte Auflistung der Mail IDs der enthaltenen Mailbox und die Datei "data.zbk" enthält die tatsächlichen Daten.

Wenn dieser Export mit den Zarafa Brickleveltools fehlschlägt, nehmen Sie bitte Kontakt zu Ihrem Zarafa Support Techniker auf.

Spezielle Konfigurationseinstellungen für Connection Timeouts / Firewalls

In jedem Fall öffnet der SEP sesam Client eine Kontrollverbindung zum SEP sesam server. Diese Kontrollverbindung bleibt während des gesamten Sicherungsvorgangs bestehen, jedoch werden dort keine Daten übertragen. Falls keine Kommunikation zwischen dem Clienten und dem SEP sesam Server zustande kommt, kann es sein, dass diese Verbindung von manchen Firewalls aufgrund von Timeoutwerten abgebrochen wird. Bitte setzen Sie die Timeouteinstellungen Ihrer Firewall auf einen adäquaten Wert.

Der Export von großen Mailboxen durch das Zarafa Brickleveltool kann als solches auch einige Zeit benötigen. Wenn Sie Lognachrichten wie "XBSA Fehler" und "Connection Timeouts" sehen, ist es anzuraten Ihre Firewall protokolle zu überprüfen.

SMS timout value (SERVER SIDE) für große Mailboxen

Wenn Sie große Mailboxen haben und der Export daher lange braucht, ist es ratsam auch die DATA_TIMEOUT Einstellung für die STPD Datentransfers zu erweitern.

Die folgende Konfigurationsvariable in <SESAM_ROOT>/var/ini/stpd.ini kann auf einen Zeitraum in Sekunden gesetzt werden. Der Standardwert ist "7200". Fall ihre größte Mailbox zum Export länger als zwei Stunden benötigt, kann dies ein Problem sein.

SBC Timeoutwert (CLIENT SIDE) für große Mailboxen

Fügen Sie am Clienten die folgende Konfigurationsangabe in <SESAM_ROOT>/var/ini/sm.ini ein:

Das sorgt dafür, dass der Timeout des SEP sesam Backup Clienten drei Stunden auf Datentransfer wartet.

Weiterführende Links/Literatur

• SEP sesam Extension for Zarafa (Nur für Sesam version 3.4. Client Installationen 3.6.x beinhalten die Extension standardmäßig.)
• FAQ: Wo bekomme ich die kostenlose Zarafa Extension