Difference between revisions of "Bulk Import of Email Files"

[unchecked revision][unchecked revision]
(Created page with "= +++ DRAFT +++ = Beim Archivieren von PST, MBOX, EML und MSG Dateien ermöglicht der MailStore Client das Archivieren von einzelnen Dateien (PST, MBOX) oder von Verzeichniss...")
 
Line 1: Line 1:
= +++ DRAFT +++ =
+
When archiving e-mail files, MailStore only allows the archiving of individual e-mail files (PST, MBOX) or directories which contain e-mail files of one user (EML, MSG).
  
Beim Archivieren von PST, MBOX, EML und MSG Dateien ermöglicht der MailStore Client das Archivieren von einzelnen Dateien (PST, MBOX) oder von Verzeichnissen einzelner Benutzer (EML, MSG).
+
The following procedure describes how to archive all PST-, MBOX-, EML- and MSG-files of all users in a few steps, using the Python bulk import script.
  
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.
+
The bulk import script expects the e-mail files in folders that have the same name like the corresponding MailStore users. Such a folder structure can be created by another included script.
  
Der Massenimport basiert darauf, dass es im Dateisystem Ordner gibt, die wie MailStore Benutzer heißen. Das Skript liest die Ordnernamen und ändert das Zielarchiv im Archivierungsprofil auf den entsprechenden Benutzer.
+
If you only want to archive PST- or MBOX-files of one user, you can use the [[Windows Batch Scripts|bulkImportPST.bat- and bulkImportMBOX.bat-]]scripts of the [[Media:MailStoreScripts.zip‎|scripting package]]. The installation of Python is not required for this purpose.
  
Die bereitgestellten Skripte sind in Python geschrieben. Python 3.2 oder höher und das [[Media:MailStoreScripts.zip‎|Scripting-Paket]] werden benötigt.
+
= Preperation of Python =
Python kann von der Python Homepage www.python.org bezogen werden.
 
  
== Vorbereitung Ordnerstruktur ==
+
The scripting package contains the createUserFolders.py script. This prepares the folders by reading the existing MailStore Server users and creating folders with the same name in the filesystem. The actual reading bulk archive script uses these folder names to assign the files appropriate users in MailStore.
  
Im Scripting Package 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.
+
The MailStore Administration API must be enabled.
  
Die [[MailStore Server Dienst-Konfiguration|MailStore Administrations API]] muss hierzu aktiviert sein.
+
After installing Python, the script can be edited by right-clicking on it, then selecting ''IDLE'', the supplied Python editor. Adjust the values ​​of <tt>USER</tt>, <tt>PASSWORD</tt>, <tt>HOST</tt> and <tt>PORT</tt> according to your installation.
  
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.
+
The <tt>rootpath</tt> variable contains the path where the folders will be created in.
  
Die Variable '''rootpath''' enthält den Pfad, in dem die Ordner angelegt werden sollen. Möchten Sie PST Dateien importieren, so muss Outlook auf dem System installiert sein, welches die Archivierung durchführt.
+
Press F5 to run the script. A security query follows.
 
 
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.
 
 
 
Beim der EML, MSG Archivierung werden die Unterordner immer berücksichtigt. Die MailStore Header werden immer ignoriert.
 
 
 
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. 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 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 ==
 
 
 
Das Skript schreibt Log Dateien in den Ordner, der die Benutzerordner enthält. Diese haben das Format
 
 
 
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.
 
  
 
[[de:Massenimport von E-Mail-Dateien]]
 
[[de:Massenimport von E-Mail-Dateien]]

Revision as of 15:43, 8 April 2013

When archiving e-mail files, MailStore only allows the archiving of individual e-mail files (PST, MBOX) or directories which contain e-mail files of one user (EML, MSG).

The following procedure describes how to archive all PST-, MBOX-, EML- and MSG-files of all users in a few steps, using the Python bulk import script.

The bulk import script expects the e-mail files in folders that have the same name like the corresponding MailStore users. Such a folder structure can be created by another included script.

If you only want to archive PST- or MBOX-files of one user, you can use the bulkImportPST.bat- and bulkImportMBOX.bat-scripts of the scripting package. The installation of Python is not required for this purpose.

Preperation of Python

The scripting package contains the createUserFolders.py script. This prepares the folders by reading the existing MailStore Server users and creating folders with the same name in the filesystem. The actual reading bulk archive script uses these folder names to assign the files appropriate users in MailStore.

The MailStore Administration API must be enabled.

After installing Python, the script can be edited by right-clicking on it, then selecting IDLE, the supplied Python editor. Adjust the values ​​of USER, PASSWORD, HOST and PORT according to your installation.

The rootpath variable contains the path where the folders will be created in.

Press F5 to run the script. A security query follows.