Difference between revisions of "Bulk Import of Email Files"

[unchecked revision][unchecked revision]
Line 44: Line 44:
 
= Archiving =
 
= Archiving =
  
Archiving is done by the <tt>bulkImport.py</tt> script. Before execution it must be adjusted to your MailStore Server installation by using ''IDLE'' (see ''Vorbereitung Ordnerstruktur'').
+
Archiving is done by the <tt>bulkImport.py</tt> script. Before execution it must be adjusted to your MailStore Server installation by using ''IDLE'' (see ''Preparing the Folder Structure'').
  
To retrieve the correct parameter values for your installation, open the properties of an existing scheduled task of a MailStore archiving profile and copy the ''Run'' command line into a text editor of your choice.<br/>Alternatively you can pretend creating a new archiving profile for an existing archiving profile, by clicking on ''Schedule'' and then ''Copy CMD''. Now open a text editor and paste  the command line to see all parameter values. IT is now safe to cancel the creation of a new scheduled task,
+
To retrieve the correct parameter values for your installation, open the properties of an existing scheduled task of a MailStore archiving profile and copy the ''Run'' command line into a text editor of your choice.<br/>Alternatively you may pretend creating a new archiving profile for an existing archiving profile, by clicking on ''Schedule'' and then ''Copy CMD''. Now open a text editor and paste  the command line to see all parameter values. It is now safe to cancel the creation of a new scheduled task.
  
 
[[File:Cmd values.png|center|640px]]
 
[[File:Cmd values.png|center|640px]]
Line 54: Line 54:
 
The bulk import script requires the encrypted version of the password. This corresponds to the value of the <tt>--pc=</tt> parameter.
 
The bulk import script requires the encrypted version of the password. This corresponds to the value of the <tt>--pc=</tt> parameter.
  
Analog to the <tt>createUserFolders.py</tt> script, <tt>rootpath</tt> points to the folder that contains the user folders.
+
Analog to the <tt>createUserFolders.py</tt> script, <tt>rootpath</tt> points to the folder containing the actual user folders.
 
The <tt>filetype</tt> variable can have one of the following values corresponding to the file type to archive: <tt>pst</tt>, <tt>mbox</tt> or <tt>emlmsg</tt>.
 
The <tt>filetype</tt> variable can have one of the following values corresponding to the file type to archive: <tt>pst</tt>, <tt>mbox</tt> or <tt>emlmsg</tt>.
  
 
In ''IDLE'', pressing the F5 key executes the script.
 
In ''IDLE'', pressing the F5 key executes the script.
  
 +
= Logging =
 +
 +
While the archiving process runs, the progress can be monitored in the status window. The message ''exitcode: 0'' means, that the file or folder has been archived successfully. A different output would show the error. The task logs of the procedures are store in the <tt>rootpath</tt> folder and are named as follows:
 +
 +
  Date-Time-User-File.log (PST,MBOX)
 +
 +
or
 +
 +
  Date-Time-User.log (EML/MSG)
 +
 +
The table ''Recent Results'' in MailStore Client gives you an overview of all executed archiving profiles. Failed runs can by easily identified by its start time, as the file names of the log files begin with the same value.
  
 
[[de:Massenimport von E-Mail-Dateien]]
 
[[de:Massenimport von E-Mail-Dateien]]

Revision as of 12:38, 16 April 2013

+++DRAFT+++

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

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

The bulk import script expects the email files in folders that are named after the corresponding MailStore users. Such a folder structure can easily be created by another included script.

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

Preparing Python

The provided scripts are written in Python. Python 3.2 or newer is required as well as the [Media:MailStoreScripts.zip‎|scripting package]]. Python con be downloaded from the Python website www.python.org. The mailstoreapi directory from the scripting package must be moved into the site-packages directory of your Python installation. The default location of Python 3.3 under Windows is C:\Python33\Lib\site-packages. The scripts themselves can be stored in any other location such as "My Documents".

Preparing the Folder Structure

The scripting package contains the createUserFolders.py script. This prepares the folders by fetching a list of existing MailStore Server users and creating folders with the same names in the filesystem. The actual bulk archiving script uses these folder names to assign the files to their appropriate users in MailStore.

The MailStore Server Administration API must be enabled in the MailStore Server Service Configuration.

After installing Python, the script can be modified 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.

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

Preparing the Archiving Profile

Before executing the bulk import script, a new archiving profile that corresponds to the email files (PST, MBOX, EML/MSG) to be archived must be created manually in MailStore Server.

The properties of the archiving profile get applies to all read files. For instance, if your exclude or include folders or define filters, it will be applied to all files you archive from.

The path to the PST or MBOX file, or the folder containing EML/MSG files, that you specify in the profile does not play a role, as it gets overwritten by the bulk import script. Additionally sub folder are recognized when archiving EML/MSG files, whereas MailStore headers are always ignored.

Important Notice: If you want to archive PST files, Microsoft Outlook must be installed on the machine where the archiving profile is executed.

The created profiles must be named after the file type to archive, e.g. templateBulkImportEMLMSG, templateBulkImportPST or templateBulkImportMBOX.

Filling the Folders

Put the email files of the users to archive into the corresponding folders under the rootpath. A simultaneous import of multiple file types is not supported. Would you like to archive PST and MBOX files, a separate run is necessary for each.

Archiving

Archiving is done by the bulkImport.py script. Before execution it must be adjusted to your MailStore Server installation by using IDLE (see Preparing the Folder Structure).

To retrieve the correct parameter values for your installation, open the properties of an existing scheduled task of a MailStore archiving profile and copy the Run command line into a text editor of your choice.
Alternatively you may pretend creating a new archiving profile for an existing archiving profile, by clicking on Schedule and then Copy CMD. Now open a text editor and paste the command line to see all parameter values. It is now safe to cancel the creation of a new scheduled task.

For the MAILSTORECMD variable, MailStoreCmdSilent.exe can be used instead of MailStoreCmd.exe. This prevents MailStore from displaying empty command line windows while archiving.

The bulk import script requires the encrypted version of the password. This corresponds to the value of the --pc= parameter.

Analog to the createUserFolders.py script, rootpath points to the folder containing the actual user folders. The filetype variable can have one of the following values corresponding to the file type to archive: pst, mbox or emlmsg.

In IDLE, pressing the F5 key executes the script.

Logging

While the archiving process runs, the progress can be monitored in the status window. The message exitcode: 0 means, that the file or folder has been archived successfully. A different output would show the error. The task logs of the procedures are store in the rootpath folder and are named as follows:

 Date-Time-User-File.log (PST,MBOX)

or

 Date-Time-User.log (EML/MSG)

The table Recent Results in MailStore Client gives you an overview of all executed archiving profiles. Failed runs can by easily identified by its start time, as the file names of the log files begin with the same value.