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

[unmarkierte Version][unmarkierte Version]
Zeile 1: Zeile 1:
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).
+
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.
+
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-Scripts 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.
+
Das Massenimport-Script erwartet hierzu die E-Mail-Dateien in Ordnern, welche zu den entsprechenden MailStore Server Benutzern namensgleich sind. Eine solche Ordnerstruktur kann durch ein weiteres Script erstellt werden. In diese Ordner kopieren Sie anschliessend die zu archivierenden E-Mail-Dateien.
  
Möchten Sie nur die PST oder MBOX Dateien einzelner Benutzer archivieren, können Sie die im [[Media:MailStoreScripts.zip‎|Scripting-Paket]] enthaltenen Skripte [[Windows_Batch-Skripte|bulkImportPST.bat und bulkImportMBOX.bat‎]] verwenden; die Installation von Python ist hierfür nicht notwendig.
+
Möchten Sie lediglich mehrere PST oder MBOX Dateien einzelner Benutzer archivieren, können Sie die im [[Media:MailStoreScripts.zip‎|Scripting-Paket]] enthaltenen Scripte [[Windows_Batch-Skripte|bulkImportPST.bat und bulkImportMBOX.bat‎]] verwenden; die Installation von Python ist hierfür nicht notwendig.
  
 
= Vorbereitung Python =
 
= Vorbereitung Python =
  
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 Scripte 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 [http://www.python.org www.python.org] bezogen werden. Das Verzeichnis <tt>mailstoreapi</tt> aus dem Scripting-Paket verschieben Sie in das <tt>site-packages</tt> Verzeichnis Ihrer Python Installation. Bei Python 3.3 unter Windows ist dies standardmäßig <tt>C:\Python33\Lib\site-packages</tt>. Das Skript selber können Sie z. B. in den "Eigenen Dateien" speichern.
+
Python kann von der Python Homepage [http://www.python.org www.python.org] bezogen werden. Das Verzeichnis <tt>mailstoreapi</tt> aus dem Scripting-Paket verschieben Sie in das <tt>site-packages</tt> Verzeichnis Ihrer Python Installation. Bei Python 3.3 unter Windows ist dies standardmäßig <tt>C:\Python33\Lib\site-packages</tt>. Das Script selber können Sie z.B. unter "Eigenen Dateien" speichern.
  
 
= Vorbereitung Ordnerstruktur =
 
= Vorbereitung Ordnerstruktur =
  
Im Scripting-Paket befindet sich das Skript <tt>createUserFolders.py</tt>. 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.
+
Im Scripting-Paket befindet sich das Script <tt>createUserFolders.py</tt>. Dieses bereitet die Archivierung vor, indem es die vorhandenen MailStore Server Benutzer ausliest und gleichnamige Ordner im Dateisystem anlegt. Das eigentliche Archivierungssript liest verwendet diese Ordnernamen um die darin enthaltenen Dateien dann den entsprechenden Benutzern in MailStore Server zuzuordnen.
  
Die [[MailStore Server Dienst-Konfiguration|MailStore Administration API]] muss aktiviert sein, damit die vorhandenen Benutzer gelesen werden können.
+
Die [[MailStore Server Dienst-Konfiguration|MailStore Administration API]] muss 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 <tt>USER</tt>, <tt>PASSWORD</tt>, <tt>HOST</tt> und <tt>PORT</tt> 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 <tt>USER</tt>, <tt>PASSWORD</tt>, <tt>HOST</tt> und <tt>PORT</tt> entsprechend Ihrer Installation an.
Zeile 22: Zeile 22:
 
Die Variable <tt>rootpath</tt> enthält den Pfad, in dem die Ordner angelegt werden sollen.
 
Die Variable <tt>rootpath</tt> enthält den Pfad, in dem die Ordner angelegt werden sollen.
  
Mit F5 können Sie das Skript ausführen, es folgt eine Sicherheitsabfrage.
+
Mit F5 können Sie das Skript ausführen. Es folgt eine Sicherheitsabfrage.
  
 
= Vorbereitung Archivierungsprofil =
 
= 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.
+
Vor der Ausführung des Massenimport-Scripts 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.
+
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, dieser wird vom Massenimport-Skript überschrieben. Weiterhin werden bei der EML/MSG Archivierung Unterordner immer berücksichtigt. Die MailStore Header werden grundsätzlich ignoriert.
+
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-Script überschrieben wird. Weiterhin werden bei der EML/MSG-Archivierung Unterordner immer berücksichtigt, die MailStore-Header jedoch grundsätzlich ignoriert.
  
<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>
+
<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>
  
 
Die erstellten Profile müssen je nach zu archivierendem Dateityp <tt>templateBulkImportEMLMSG</tt>, <tt>templateBulkImportPST</tt> oder <tt>templateBulkImportMBOX</tt> benannt sein.
 
Die erstellten Profile müssen je nach zu archivierendem Dateityp <tt>templateBulkImportEMLMSG</tt>, <tt>templateBulkImportPST</tt> oder <tt>templateBulkImportMBOX</tt> benannt sein.
Zeile 38: Zeile 38:
 
= Befüllen der Ordner =
 
= Befüllen der Ordner =
  
Platzieren Sie die zu archivierenden E-Mail-Dateien der einzelnen Benutzer in den entsprechenden Ordnern unterhalb von <tt>rootpath</tt>. 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.
+
Platzieren Sie die zu archivierenden E-Mail-Dateien der einzelnen Benutzer in den entsprechenden Ordnern unterhalb von <tt>rootpath</tt>. 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 =
 
= Archivierung =
  
Die Archivierung wird vom Skript <tt>bulkImport.py</tt> durchgeführt. Dieses muss vor der Ausführung ebenfalls mittels ''IDLE'' an Ihre MailStore Server Installation angepasst werden.
+
Die Archivierung wird vom Skript <tt>bulkImport.py</tt> durchgeführt. Dieses muss vor der Ausführung ebenfalls mittels ''IDLE'' an Ihre MailStore Server Installation angepasst werden (siehe ''Vorbereitung Ordnerstruktur'').
  
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 Archivierungsprofil, 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 korrekten Parameterwerte 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 Archivierungsprofil, indem Sie auf ''Zeitgesteuert...'' und anschließend auf ''Cmd kopieren'' klicken. Wenn Sie die Zwischenablage nun in einen Editor kopieren, sehen Sie die benötigten Parameterwerte. Das Erstellen des Zeitplans können Sie abbrechen, dieser wird nicht benötigt.
  
Sie können für die Variable <tt>MAILSTORECMD</tt> anstatt MailStoreCmd.exe auch MailStoreCmdSilent.exe verwenden, dies verhindert die Anzeige leerer Kommandozeilenfenster während der Archivierung.
+
Sie können für die Variable <tt>MAILSTORECMD</tt> anstatt MailStoreCmd.exe auch MailStoreCmdSilent.exe verwenden. Dies verhindert die Anzeige leerer Kommandozeilenfenster während der Archivierung.
  
Im Massenimport Skript wird die verschlüsselte Variante des Passworts benötigt, dies entspricht dem Wert hinter <tt>--pc=</tt>.
+
Im Massenimport-Script wird die verschlüsselte Variante des Passworts benötigt.  Dies entspricht dem Wert des Parameters <tt>--pc=</tt>.
  
 
Die Variable <tt>rootpath</tt> zeigt analog dem Skript <tt>createUserFolders.py</tt> auf den Ordner, der die einzelnen Benutzerordner enthält.
 
Die Variable <tt>rootpath</tt> zeigt analog dem Skript <tt>createUserFolders.py</tt> auf den Ordner, der die einzelnen Benutzerordner enthält.
 
Die Variable <tt>filetype</tt> hat entsprechend dem zu archivierenden Dateityp einen der Werte <tt>pst</tt>, <tt>mbox</tt> oder <tt>emlmsg</tt>.
 
Die Variable <tt>filetype</tt> hat entsprechend dem zu archivierenden Dateityp einen der Werte <tt>pst</tt>, <tt>mbox</tt> oder <tt>emlmsg</tt>.
  
Innerhalb von ''IDLE'' startet ein Druck auf F5 das Skript.
+
Innerhalb von ''IDLE'' startet ein Druck auf die F5-Taste das Skript.
  
 
= Logging =
 
= Logging =
Zeile 65: Zeile 65:
 
  Datum-Zeit-Benutzer.log (EML/MSG)
 
  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.
+
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.
  
 
[[en:Bulk Import of Email Files]]
 
[[en:Bulk Import of Email Files]]

Version vom 11. März 2013, 09:49 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-Scripts archivieren können.

Das Massenimport-Script erwartet hierzu die E-Mail-Dateien in Ordnern, welche zu den entsprechenden MailStore Server Benutzern namensgleich sind. Eine solche Ordnerstruktur kann durch ein weiteres Script 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 Scripting-Paket enthaltenen Scripte bulkImportPST.bat und bulkImportMBOX.bat‎ verwenden; die Installation von Python ist hierfür nicht notwendig.

Vorbereitung Python

Die bereitgestellten Scripte 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 Script selber können Sie z.B. unter "Eigenen Dateien" speichern.

Vorbereitung Ordnerstruktur

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

Die MailStore Administration API muss 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, 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-Scripts 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 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-Script überschrieben wird. Weiterhin werden bei der EML/MSG-Archivierung Unterordner immer berücksichtigt, die MailStore-Header 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. 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. Dieses muss vor der Ausführung ebenfalls mittels IDLE an Ihre MailStore Server Installation angepasst werden (siehe Vorbereitung Ordnerstruktur).

Um an die korrekten Parameterwerte 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 Archivierungsprofil, indem Sie auf Zeitgesteuert... und anschließend auf Cmd kopieren klicken. Wenn Sie die Zwischenablage nun in einen Editor kopieren, sehen Sie die benötigten Parameterwerte. 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 die Anzeige leerer Kommandozeilenfenster während der Archivierung.

Im Massenimport-Script wird die verschlüsselte Variante des Passworts benötigt. Dies entspricht dem Wert des Parameters --pc=.

Die Variable rootpath zeigt analog dem Skript createUserFolders.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.