Massenimport von E-Mail-Dateien: Unterschied zwischen den Versionen

[unmarkierte Version][unmarkierte Version]
Zeile 14: Zeile 14:
  
 
Die bereitgestellten Skripte sind in Python geschrieben. Python 3.2 oder höher und das [[Media:MailStoreScripts.zip‎|Scripting-Paket]] werden benötigt.
 
Die bereitgestellten Skripte sind in Python geschrieben. Python 3.2 oder höher und das [[Media:MailStoreScripts.zip‎|Scripting-Paket]] werden benötigt.
Python kann von der Python Homepage www.python.org bezogen werden. Das Verzeichnis ''mailstoreapi'' aus dem Scripting-Paket kopieren Sie in das ''site-packages'' Verzeichnis Ihrer Python Installation. Bei Python 3.3 unter Windows wäre das C:\Python33\Lib\site-packages. Das Skript selber können Sie z. B. in den "Eigenen Dateien" speichern.
+
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 wäre das C:\Python33\Lib\site-packages. Das Skript selber können Sie z. B. in den "Eigenen Dateien" speichern.
  
 
= Vorbereitung Ordnerstruktur =
 
= Vorbereitung Ordnerstruktur =
Zeile 22: Zeile 22:
 
Die [[MailStore Server Dienst-Konfiguration|MailStore Administrations API]] muss aktiviert sein, damit die vorhandenen Benutzer gelesen werden können.
 
Die [[MailStore Server Dienst-Konfiguration|MailStore Administrations 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.
+
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.
 
Die Variable '''rootpath''' enthält den Pfad, in dem die Ordner angelegt werden sollen.
Zeile 44: Zeile 44:
 
= Befüllen der Ordner =
 
= Befüllen der Ordner =
  
Nun sammeln Sie in Ihrem Unternehmen die E-Mail Dateien der Mitarbeiter und platzieren Sie in den entsprechenden Ordnern. Beachten Sie bitte, dass Sie die verschiedenen Dateitypen nicht vermischen. Sollten Sie z. B. PST und MBOX Dateien Ihrer Mitarbeiter haben, so müssen Sie diese in unterschiedlichen Durchgängen archivieren.
+
Nun sammeln Sie in Ihrem Unternehmen die E-Mail Dateien der Mitarbeiter und platzieren Sie in den entsprechenden Ordnern unterhalb von '''rootpath'''. Beachten Sie bitte, dass Sie die verschiedenen Dateitypen nicht vermischen. Möchten Sie z. B. PST und MBOX Dateien Ihrer Mitarbeiter archivieren, so müssen Sie diese in unterschiedlichen Durchgängen archivieren.
  
 
= Archivierung =
 
= 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.
+
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.
 
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 anstatt MailStoreCmd.exe auch MailStoreCmdSilent.exe verwenden, dies verhindert das Aufpoppen leerer Kommandozeilenfenster während der Archivierung.
+
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=".
+
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 '''rootpath''' zeigt auf den gleichen Ordner, wie im vorherigen Skript.
 
Die Variable '''filetype''' hat einen der Werte '''pst''', '''mbox''' oder '''emlmsg'''.
 
Die Variable '''filetype''' hat einen der Werte '''pst''', '''mbox''' oder '''emlmsg'''.
  
Ein beherzter Druck auf F5 startet das Skript
+
Ein Druck auf F5 startet das Skript
  
 
= Logging =
 
= 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 Fehler können in den Task Log eingesehen werden, die in den Ordner geschrieben werden, der die Benutzerordner enthält. Die Logs haben das Format
+
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)
 
  Datum-Zeit-Benutzer-Datei.log (PST, MBOX)

Version vom 26. Februar 2013, 09:36 Uhr

+++ DRAFT +++

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

Mittels MailStore Server Management Shell ist es möglich, vorhandene Archivierungsprofile vor der Ausführung zu modifizieren. Dadurch ist es möglich mehrere Dateien oder auch ganze Ordner automatisiert zu archivieren.

Das Massenimport Skript benötigt die E-Mail Dateien in Ordnern, die wie MailStore Benutzer heißen. Dies wird durch ein weiteres Skript vorbereitet. Diese Ordner befüllen Sie mit Ihren Dateien.

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

Möchten Sie nur die PST oder MBOX Dateien einzelner Benutzer archivieren, können Sie auf Python verzichten und die im Scripting-Paket enthaltenen Skripte bulkImportPST.bat und bulkImportMBOX.bat‎ verwenden.

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 wäre das 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 Benutzer ausliest und die Benutzer-Ordner im Dateisystem anlegt. Das eigentliche Archivierungsskript liest diese Ordnernamen und kann die darin enthaltenen Dateien den entsprechenden Benutzern zuordnen.

Die MailStore Administrations 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

Damit das Archivierungs-Skript ein vorhandenes Profil modifizieren kann, müssen Sie ein passendes Profil Erstellen.

Das vorgehen ist für die drei Typen (PST, MBOX, EML und MSG) ähnlich. Erstellen Sie ein Profil des entsprechenden Types. 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 Dateien, den Sie im Profil auswählen, spielt keine Rolle, dieser wird vom Archivierungsskript überschrieben.

Beim der EML, MSG Archivierung werden die Unterordner immer berücksichtigt. Die MailStore Header werden immer ignoriert.

Möchten Sie PST Dateien importieren, so muss Outlook auf dem System installiert sein, welches die Archivierung durchführt.

Die erstellten Profile müssen entweder templateBulkImportEMLMSG, templateBulkImportPST oder templateBulkImportMBOX heißen. Dies lässt sich im Nachhinein mittels F2 ändern.

Befüllen der Ordner

Nun sammeln Sie in Ihrem Unternehmen die E-Mail Dateien der Mitarbeiter und platzieren Sie in den entsprechenden Ordnern unterhalb von rootpath. Beachten Sie bitte, dass Sie die verschiedenen Dateitypen nicht vermischen. Möchten Sie z. B. PST und MBOX Dateien Ihrer Mitarbeiter 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.