Massenimport von E-Mail-Dateien

+++ DRAFT +++

Beim Archivieren von E-Mail Dateien ermöglicht der MailStore Client nur das Archivieren von einzelnen Dateien (PST, MBOX) oder von Verzeichnissen einzelner Benutzer (EML, MSG).

Im Folgenden wird beschrieben, wie Sie sämtliche PST, MBOX, EML und MSG Dateien aller Benutzer in wenigen Schritten mittels des in Python geschriebenen Massenimport Skripts archivieren können.

Das Massenimport Skript benötigt hierzu die E-Mail Dateien in Ordnern, die zu den entsprechenden MailStore Server Benutzern namensgleich sind. Eine solche Ordnerstruktur kann durch ein weiteres Skript erstellt werden. Diese Ordner befüllen Sie mit Ihren E-Mail-Dateien.

Möchten Sie nur die PST oder MBOX Dateien einzelner Benutzer archivieren, können Sie die im Scripting-Paket enthaltenen Skripte bulkImportPST.bat und bulkImportMBOX.bat‎ verwenden; die Installation von Python ist hierfür nicht notwendig.

Vorbereitung Python

Die bereitgestellten Skripte sind in Python geschrieben. Python 3.2 oder höher und das Scripting-Paket werden benötigt. Python kann von der Python Homepage www.python.org bezogen werden. Das Verzeichnis mailstoreapi aus dem Scripting-Paket verschieben Sie in das site-packages Verzeichnis Ihrer Python Installation. Bei Python 3.3 unter Windows ist dies standardmäßig C:\Python33\Lib\site-packages. Das Skript selber können Sie z. B. in den "Eigenen Dateien" speichern.

Vorbereitung Ordnerstruktur

Im Scripting-Paket befindet sich das Skript createUserFolders.py. Dieses bereitet die Archivierung vor, in dem es die vorhandenen MailStore Server Benutzer ausliest und gleichnamige Ordner im Dateisystem anlegt. Das eigentliche Archivierungsskript liest diese Ordnernamen und kann die darin enthaltenen Dateien dann den entsprechenden Benutzern in MailStore Server zuordnen.

Die MailStore Administration API muss aktiviert sein, damit die vorhandenen Benutzer gelesen werden können.

Nach der Installation von Python kann das Skript per Rechtsklick in IDLE, dem mitgelieferten Python Editor, bearbeitet werden. Passen Sie die Werte USER, PASSWORD, HOST und PORT entsprechend Ihrer Installation an.

Die Variable rootpath enthält den Pfad, in dem die Ordner angelegt werden sollen.

Mit F5 können Sie das Skript ausführen, es folgt eine Sicherheitsabfrage.

Vorbereitung Archivierungsprofil

Vor der Ausführung des Massenimport Skripts muss in MailStore Server zunächst manuell ein dem zu archivierenden E-Mail-Dateityp (PST, MBOX, EML/MSG) entsprechendes Archivierungsprofil angelegt werden.

Die Einstellungen in diesem Archivierungsprofil gelten für alle eingelesenen Datein. Wenn Sie z.B. Ordner Filter setzen, wird dieser Filter auf jede PST Datei angewandt.

Der Pfad zur PST oder MBOX Datei bzw. der Ordner der EML/MSG Dateien, den Sie im Profil auswählen, spielt keine Rolle, dieser wird vom Massenimport Skript überschrieben. Weiterhin werden bei der EML/MSG Archivierung Unterordner immer berücksichtigt. Die MailStore Header werden grundsätzlich ignoriert.

Wichtiger Hinweis: Möchten Sie aus PST Dateien archivieren, so muss Microsoft Outlook auf dem System installiert sein, welches die Archivierung durchführt.

Die erstellten Profile müssen je nach zu archivierendem Dateityp templateBulkImportEMLMSG, templateBulkImportPST oder templateBulkImportMBOX heißen.

Befüllen der Ordner

Platzieren Sie die zu archivierenden E-Mail-Dateien der einzelnen Benutzer in den entsprechenden Ordnern unterhalb von rootpath. Ein gleichzeitiger Import unterschiedlicher Dateitypen ist nicht möglich. Möchten Sie z. B. PST und MBOX Dateien archivieren, so müssen Sie diese in unterschiedlichen Durchgängen archivieren.

Archivierung

Die Archivierung wird vom Skript bulkImport.py durchgeführt. Dies muss vor der Ausführung ebenfalls mittels IDLE modifiziert werden. Da dieses Skript nicht auf die Administrations API zugreift, sondern auf den lokal installierten MailStore Client, müssen hier etwas andere Werte angegeben werden.

Um an die Werte für Ihre Installation zu gelangen, öffnen Sie entweder einen vorhandenen "Geplanten Task" eines MailStore Archivierungsprofils über den MailStore Client und kopieren die Zeile "Ausführen" in einen Editor Ihrer Wahl, oder Sie erstellen einen neuen Zeitplan für ein beliebiges Archiverungsprofil in dem Sie auf "Zeitgesteuert..." und anschließend auf "Cmd kopieren" klicken. Wenn Sie die Zwischenablage nun in einen Editor kopieren, sehen Sie die benötigten Werte. Das Erstellen des Zeitplans können Sie abbrechen, dieser wird nicht benötigt.

Sie können für die Variable MAILSTORECMD anstatt MailStoreCmd.exe auch MailStoreCmdSilent.exe verwenden, dies verhindert das Aufpoppen leerer Kommandozeilenfenster während der Archivierung.

In diesem Skript wird die verschlüsselte Variante des Passworts benötigt, dies entspricht dem Wert hinter --pc=.

Die Variable rootpath zeigt auf den gleichen Ordner, wie im vorherigen Skript. Die Variable filetype hat einen der Werte pst, mbox oder emlmsg.

Ein Druck auf F5 startet das Skript

Logging

Während der Archivierung können Sie im Statusfenster den Vorgang verfolgen. Die Meldung exitcode: 0 besagt, dass die Datei bzw. der Ordner erfolgreich archiviert worden ist. Eine andere Ausgabe zeigt einen Fehler an. Die Task Logs zu den Vorgängen werden im Ordner rootpath angelegt und haben das Namensschema

Datum-Zeit-Benutzer-Datei.log (PST, MBOX)

bzw.

Datum-Zeit-Benutzer.log (EML und MSG)

Über die "Letzten Ergebnisse" im MailStore Client kann eine Übersicht gewonnen werden. Die Modifikationen werden hier nicht angezeigt, die Startzeit kann jedoch verwendet werden um fehlerhafte Vorgänge zu identifizieren. Die Namen der Log-Dateien auf der Festplatte beginnen mit der Startzeit.