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

[unmarkierte Version][gesichtete Version]
 
(66 dazwischenliegende Versionen von 5 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
= +++ DRAFT +++ =
+
Beim Archivieren von E-Mail-Dateien ermöglicht der MailStore Client nur das Archivieren von einzelnen E-Mail-Dateien (PST, MBOX) oder von Verzeichnissen, welche E-Mail-Dateien (EML, MSG) einzelner Benutzer enthalten.
  
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).
+
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.
  
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 erwartet hierzu die E-Mail-Dateien in Ordnern, welche zu den entsprechenden MailStore Server Benutzern namensgleich sind. Eine solche Ordnerstruktur kann durch ein weiteres Skript erstellt werden. In diese Ordner kopieren Sie anschliessend die zu archivierenden E-Mail-Dateien.
  
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. Zu letzt führen Sie das eigentliche Archivierungs-Skript aus.
+
Möchten Sie lediglich mehrere PST- oder MBOX-Dateien einzelner Benutzer archivieren, können Sie die im [[Media:Batchscripts.zip|Batch Skripting Paket]] enthaltenen Bulk-Import Skripte verwenden; die Installation von Python ist hierfür nicht notwendig.
  
Im Folgenden wird beschrieben wie Sie sämtliche PST, MBOX, EML und MSG Dateien aller Benutzer in wenigen Schritten archivieren können.
+
== Vorbereitung Python ==
 +
Die bereitgestellten Skripte sind in Python geschrieben. Python 3.6 oder höher und das [[Media:scripts.zip|Python Skripting Paket]] werden benötigt.
 +
Der [[Python API-Wrapper Tutorial|Python API-Wrapper]] muss ebenfalls installiert sein.
  
Möchten Sie nur die PST oder MBOX Dateien einzelner Benutzer archivieren, können Sie auf Python verzichten und die im [[Media:MailStoreScripts.zip‎|Scripting-Paket]] enthaltenen Skripte [[Windows_Batch-Skripte|bulkImportPST.bat und bulkImportMBOX.bat‎]] verwenden.
+
== Vorbereitung Ordnerstruktur ==
 +
Im Skripting-Paket befindet sich das Skript <code>create_user_folders_server/spe.py</code>. Dieses bereitet die Archivierung vor, indem es die vorhandenen MailStore Server Benutzer ausliest und gleichnamige Ordner im Dateisystem anlegt. Das eigentliche Archivierungssript verwendet diese Ordnernamen um die darin enthaltenen Dateien den entsprechenden Benutzern in MailStore Server zuzuordnen.
  
= Vorbereitung Python =
+
Die MailStore Server Administration API muss in der [[MailStore Server Dienst-Konfiguration]] aktiviert sein, damit die vorhandenen Benutzer ausgelesen werden können.
  
Die bereitgestellten Skripte sind in Python geschrieben. Python 3.2 oder höher und das [[Media:MailStoreScripts.zip‎|Scripting-Paket]] werden benötigt.
+
Nach der Installation von Python kann das Skript per Rechtsklick in ''IDLE'', dem mitgelieferten Python Editor, bearbeitet werden. Passen Sie die Werte <code>USER</code>, <code>PASS</code>, <code>HOST</code> und <code>PORT</code> entsprechend Ihrer Installation an.
Python kann von der Python Homepage www.python.org bezogen werden. Das Verzeichnis ''mailstoreapi'' 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.
 
  
= Vorbereitung Ordnerstruktur =
+
Die Variable <code>rootpath</code> enthält den Pfad, in dem die Ordner angelegt werden sollen.
  
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.
+
Mit F5 können Sie das Skript ausführen. Es folgt eine Sicherheitsabfrage.
  
Die [[MailStore Server Dienst-Konfiguration|MailStore Administrations API]] muss aktiviert sein, damit die vorhandenen Benutzer gelesen werden können.
+
== 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.
  
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.
+
Das Archivierungsprofil muss vom Typ ''Einzelner Benutzer'' sein. Die Einstellungen in diesem Archivierungsprofil gelten für alle eingelesenen Dateien. Wenn Sie z.B. Order ein- oder ausschließen und Filter definieren, werden diese Einstellungen auf alle zu archivierenden Dateien angewandt.
  
Die Variable '''rootpath''' enthält den Pfad, in dem die Ordner angelegt werden sollen.
+
Der Pfad zur PST- oder MBOX-Datei bzw. der Ordner der EML/MSG-Dateien, den Sie im Profil auswählen, spielt keine Rolle, da dieser vom Massenimport-Skript überschrieben wird. Weiterhin werden bei der EML/MSG-Archivierung Unterordner immer berücksichtigt, die MailStore-Header in EML-Dateien jedoch grundsätzlich ignoriert.
  
Mit F5 können Sie das Skript ausführen, es folgt eine Sicherheitsabfrage.
+
<p class="msnote">'''Wichtiger Hinweis:''' Möchten Sie aus PST-Dateien archivieren, so muss Microsoft Outlook auf dem System, welches die Archivierung durchführt, installiert sein.</p>
  
= Vorbereitung Archivierungsprofil =
+
Die erstellten Profile müssen je nach zu archivierendem Dateityp <code>templateBulkImportEMLMSG</code>, <code>templateBulkImportPST</code> oder <code>templateBulkImportMBOX</code> benannt sein.
  
Damit das Archivierungs-Skript ein vorhandenes Profil modifizieren kann, müssen Sie ein passendes Profil Erstellen.
+
== Befüllen der Ordner ==
 +
Platzieren Sie die zu archivierenden E-Mail-Dateien der einzelnen Benutzer in den entsprechenden Ordnern unterhalb von <code>rootpath</code>. Bei der Archivierung von PST-Dateien, dürfen Sich diese auch in weiteren Unterordnern befinden. 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.
  
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.
+
== Archivierung ==
 +
Die Archivierung wird vom Skript <code>bulk_import.py</code> durchgeführt. Dieses muss vor der Ausführung ebenfalls mittels ''IDLE'' an Ihre MailStore Installation angepasst werden. Anders als das Skript für die ''Vorbereitung der Ordnerstruktur'' verbindet sich dieses Skript nicht mit der MailStore Administration API, sonder ruft den MailStore Client mit angepassten Parametern auf, daher müssen hier teilweise andere Werte angegeben Werten.
  
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.
+
Sie müssen den Pfad zur <code>MailStoreCmdSilent.exe</code>, den Servernamen, Zugangsdaten eines Administrator, sowie den <code>rootpath</code> angeben.
  
Beim der EML, MSG Archivierung werden die Unterordner immer berücksichtigt. Die MailStore Header werden immer ignoriert.
+
Bei MailStore Server hat der <code>HOST</code> die Form <code>computer:port</code>. Bei der SPE ist die Form <code><nowiki>https://computer:port/instanceid</nowiki></code>.
  
Möchten Sie PST Dateien importieren, so muss Outlook auf dem System installiert sein, welches die Archivierung durchführt.
+
Die Variable <code>rootpath</code> zeigt analog dem Skript <code>create_user_folders_sever/spe.py</code> auf den Ordner, der die einzelnen Benutzerordner enthält.
 +
Die Variable <code>filetype</code> hat entsprechend dem zu archivierenden Dateityp einen der Werte <code>pst</code>, <code>mbox</code> oder <code>emlmsg</code>.
  
Die erstellten Profile müssen entweder '''templateBulkImportEMLMSG''', '''templateBulkImportPST''' oder '''templateBulkImportMBOX''' heißen. Dies lässt sich im Nachhinein mittels F2 ändern.
+
Innerhalb von ''IDLE'' startet ein Druck auf die F5-Taste das Skript.
  
= Befüllen der Ordner =
+
== 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 <code>rootpath</code> angelegt und haben das Namensschema
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.
 
 
 
= 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 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 beherzter 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 sind. 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
 
  
 
  Datum-Zeit-Benutzer-Datei.log (PST, MBOX)
 
  Datum-Zeit-Benutzer-Datei.log (PST, MBOX)
Zeile 69: Zeile 55:
 
bzw.
 
bzw.
  
  Datum-Zeit-Benutzer.log (EML und MSG)
+
  Datum-Zeit-Benutzer.log (EML/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.
+
Die Tabelle ''Letzte Ergebnisse'' im MailStore Client zeigt eine Übersicht der Durchläufe des Archivierungsprofils an. Über die Startzeit können fehlerhafte Vorgänge identifiziert werden, da die Namen der Log-Dateien mit dieser beginnen.
  
 +
[[de:Massenimport von E-Mail-Dateien]]
 
[[en:Bulk Import of Email Files]]
 
[[en:Bulk Import of Email Files]]

Aktuelle Version vom 10. April 2024, 15:35 Uhr

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

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 erwartet hierzu die E-Mail-Dateien in Ordnern, welche zu den entsprechenden MailStore Server Benutzern namensgleich sind. Eine solche Ordnerstruktur kann durch ein weiteres Skript erstellt werden. In diese Ordner kopieren Sie anschliessend die zu archivierenden E-Mail-Dateien.

Möchten Sie lediglich mehrere PST- oder MBOX-Dateien einzelner Benutzer archivieren, können Sie die im Batch Skripting Paket enthaltenen Bulk-Import Skripte verwenden; die Installation von Python ist hierfür nicht notwendig.

Vorbereitung Python

Die bereitgestellten Skripte sind in Python geschrieben. Python 3.6 oder höher und das Python Skripting Paket werden benötigt. Der Python API-Wrapper muss ebenfalls installiert sein.

Vorbereitung Ordnerstruktur

Im Skripting-Paket befindet sich das Skript create_user_folders_server/spe.py. Dieses bereitet die Archivierung vor, indem es die vorhandenen MailStore Server Benutzer ausliest und gleichnamige Ordner im Dateisystem anlegt. Das eigentliche Archivierungssript verwendet diese Ordnernamen um die darin enthaltenen Dateien den entsprechenden Benutzern in MailStore Server zuzuordnen.

Die MailStore Server Administration API muss in der MailStore Server Dienst-Konfiguration aktiviert sein, damit die vorhandenen Benutzer ausgelesen 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, PASS, 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.

Das Archivierungsprofil muss vom Typ Einzelner Benutzer sein. Die Einstellungen in diesem Archivierungsprofil gelten für alle eingelesenen Dateien. Wenn Sie z.B. Order ein- oder ausschließen und Filter definieren, werden diese Einstellungen auf alle zu archivierenden Dateien angewandt.

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

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

Die erstellten Profile müssen je nach zu archivierendem Dateityp templateBulkImportEMLMSG, templateBulkImportPST oder templateBulkImportMBOX benannt sein.

Befüllen der Ordner

Platzieren Sie die zu archivierenden E-Mail-Dateien der einzelnen Benutzer in den entsprechenden Ordnern unterhalb von rootpath. Bei der Archivierung von PST-Dateien, dürfen Sich diese auch in weiteren Unterordnern befinden. 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 bulk_import.py durchgeführt. Dieses muss vor der Ausführung ebenfalls mittels IDLE an Ihre MailStore Installation angepasst werden. Anders als das Skript für die Vorbereitung der Ordnerstruktur verbindet sich dieses Skript nicht mit der MailStore Administration API, sonder ruft den MailStore Client mit angepassten Parametern auf, daher müssen hier teilweise andere Werte angegeben Werten.

Sie müssen den Pfad zur MailStoreCmdSilent.exe, den Servernamen, Zugangsdaten eines Administrator, sowie den rootpath angeben.

Bei MailStore Server hat der HOST die Form computer:port. Bei der SPE ist die Form https://computer:port/instanceid.

Die Variable rootpath zeigt analog dem Skript create_user_folders_sever/spe.py auf den Ordner, der die einzelnen Benutzerordner enthält. Die Variable filetype hat entsprechend dem zu archivierenden Dateityp einen der Werte pst, mbox oder emlmsg.

Innerhalb von IDLE startet ein Druck auf die F5-Taste 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/MSG)

Die Tabelle Letzte Ergebnisse im MailStore Client zeigt eine Übersicht der Durchläufe des Archivierungsprofils an. Über die Startzeit können fehlerhafte Vorgänge identifiziert werden, da die Namen der Log-Dateien mit dieser beginnen.