Difference between revisions of "MailStore Server to MailStore SPE Migration"

[unchecked revision][unchecked revision]
Line 2: Line 2:
 
This guide shows you, how to migrate a MailStore Server installation into the MailStore SPE.
 
This guide shows you, how to migrate a MailStore Server installation into the MailStore SPE.
  
This can be desired, if the customer has used MailStore Server before, but now he wants the archive to be stored in a service provider's datacenter.  
+
This can be desired, if the customer has been using MailStore Server before, but now he wants the archive to be stored in a service provider's datacenter.  
  
 
Also, when an on-premise mailserver or on-premise e-mail files, like PSTs, should be archived by an SPE instance, it might be a good decision to do the [http://en.help.mailstore.com/Archiving_Email initial archiving with MailStore Server] in the customer's infrastructure, and then migrating the resulting MailStore databases into the SPE. Since the MailStore databases usually are considerable smaller then the uncompressed e-mail volume, the amount of data to be transferred initially is significantly less. Usually a [https://my.mailstore.com/TrialLicense/RequestForm?lang=en MailStore Server Trial license] will do for that purpose.
 
Also, when an on-premise mailserver or on-premise e-mail files, like PSTs, should be archived by an SPE instance, it might be a good decision to do the [http://en.help.mailstore.com/Archiving_Email initial archiving with MailStore Server] in the customer's infrastructure, and then migrating the resulting MailStore databases into the SPE. Since the MailStore databases usually are considerable smaller then the uncompressed e-mail volume, the amount of data to be transferred initially is significantly less. Usually a [https://my.mailstore.com/TrialLicense/RequestForm?lang=en MailStore Server Trial license] will do for that purpose.
  
The two products use a slightly different format of the ''MasterDatabase'', which contains the configuration, therefore it is not possible just to move the entire ''MailArchive'' directory of MailStore Server into the SPE.
+
The two products use a slightly different format of the ''MasterDatabase'', which contains the configuration, therefore it is not possible to move the entire ''MailArchive'' directory of MailStore Server into the SPE.
 
However, it is possible to transfer all the ''archive stores'', which contain the actual messages.
 
However, it is possible to transfer all the ''archive stores'', which contain the actual messages.
  
 
* First you have to [[Instance_Management_-_General_Administration#Creating_Instances| create an instance]]. The instance does not have to be started yet.
 
* First you have to [[Instance_Management_-_General_Administration#Creating_Instances| create an instance]]. The instance does not have to be started yet.
 
* Stop all archiving profiles in MailStore Server, either by setting the execution mode to ''manual'' or by disabling all scheduled tasks.
 
* Stop all archiving profiles in MailStore Server, either by setting the execution mode to ''manual'' or by disabling all scheduled tasks.
* If you want to transfer users, you could use the provided [[Migrate_from_MailStore_Server_to_SPE#Scripts|script]].
+
* If you want to transfer users and their settings, you could use the provided [[Migrate_from_MailStore_Server_to_SPE#Scripts|readConfigFromServer script]] now.
 
* [http://en.help.mailstore.com/MailStore_Server_Service_Configuration Stop] the MailStore Server service.
 
* [http://en.help.mailstore.com/MailStore_Server_Service_Configuration Stop] the MailStore Server service.
 
<p class="msnote">'''Important Notice:''' Do not start any of the archiving jobs on MailStore Server again, or else you might risk that some mails will not be archived by the new instance in the SPE.</p>
 
<p class="msnote">'''Important Notice:''' Do not start any of the archiving jobs on MailStore Server again, or else you might risk that some mails will not be archived by the new instance in the SPE.</p>
* Copy the ''archive store'' directories from MailStore Server into the instance's ''Data'' directory. You do not need to transfer the ''MailStoreMaster.fdb'' and ''MailStore.xml''. Make sure, there is no remaining ''.lock'' file in one of the ''archive store'' directories. If there is any, the service is not stopped yet completely. When there are identical folder names, do not merge them, rename them before, instead.
+
* Copy the ''archive store'' directories from MailStore Server into the instance's ''Data'' directory. Do not transfer the ''MailStoreMaster.fdb'' and ''MailStore.xml'' files. Make sure, there is no remaining ''.lock'' file in one of the ''archive store'' directories. If there is any, the service is not stopped yet completely. When there are identical folder names, do not merge them, give them unique names before, instead.
 
* Start the SPE instance.
 
* Start the SPE instance.
 
* [[Instance_Management_-_Instance_Administration#Attach_Existing_Archive_Store|Attach]] the transferred ''archive stores'' to the newly created instance. If there are lots of ''archive stores'' to be attached, you can use a Python script to attach them automatically.
 
* [[Instance_Management_-_Instance_Administration#Attach_Existing_Archive_Store|Attach]] the transferred ''archive stores'' to the newly created instance. If there are lots of ''archive stores'' to be attached, you can use a Python script to attach them automatically.

Revision as of 11:51, 5 December 2014

This guide shows you, how to migrate a MailStore Server installation into the MailStore SPE.

This can be desired, if the customer has been using MailStore Server before, but now he wants the archive to be stored in a service provider's datacenter.

Also, when an on-premise mailserver or on-premise e-mail files, like PSTs, should be archived by an SPE instance, it might be a good decision to do the initial archiving with MailStore Server in the customer's infrastructure, and then migrating the resulting MailStore databases into the SPE. Since the MailStore databases usually are considerable smaller then the uncompressed e-mail volume, the amount of data to be transferred initially is significantly less. Usually a MailStore Server Trial license will do for that purpose.

The two products use a slightly different format of the MasterDatabase, which contains the configuration, therefore it is not possible to move the entire MailArchive directory of MailStore Server into the SPE. However, it is possible to transfer all the archive stores, which contain the actual messages.

  • First you have to create an instance. The instance does not have to be started yet.
  • Stop all archiving profiles in MailStore Server, either by setting the execution mode to manual or by disabling all scheduled tasks.
  • If you want to transfer users and their settings, you could use the provided readConfigFromServer script now.
  • Stop the MailStore Server service.

Important Notice: Do not start any of the archiving jobs on MailStore Server again, or else you might risk that some mails will not be archived by the new instance in the SPE.

  • Copy the archive store directories from MailStore Server into the instance's Data directory. Do not transfer the MailStoreMaster.fdb and MailStore.xml files. Make sure, there is no remaining .lock file in one of the archive store directories. If there is any, the service is not stopped yet completely. When there are identical folder names, do not merge them, give them unique names before, instead.
  • Start the SPE instance.
  • Attach the transferred archive stores to the newly created instance. If there are lots of archive stores to be attached, you can use a Python script to attach them automatically.
  • Depending on your setup:
    • Create users or synchronize the instance with a directory service. Use the writeConfigToSPE script to transfer your MailStore Server users. When the directory service, or the usernames have changed, you might want to use the updateUserNames script.
    • Set compliance options.
    • Check the rest of the configuration.
    • Set up archiving profiles.

Scripts

The scripts can be found in the Python scripting package. You have to open them in IDLE (or your preferred IDE) and adjust the values in the header of the script according to you installation. The scripts are well documented. Python and the Python SPE API Wrapper have to be installed on the computer, where you want to run the scripts that connect to the SPE. This is not necessarily a server, where the SPE is installed on. In the infrastructure where MailStore Server is running, you need the Python Server API Wrapper working.

bulkAttachStores.py

If there are lots of archive stores, you might want to use this script. It attaches all stores in the instance's Data directory, that are not already attached. The name of the store will be the folder name. Since the original name was stored in the MasterDataBase, this name is lost. In most cases, the name was equal to the folder name.

readConfigFromServer.py

This scripts reads some of you configurationa and writes it into a file, that can be transferred to your SPE. Then you are able to use the script's counterpart on the SPE to write the configuration into the SPE instance. This script should be used, when the archiving profiles have been stopped, but the MailStore Server service is still running.

writeConfigToSPE.py

This script writes the configuration of a MailStore Server into an SPE instance. The configuration is read from a file, that has been created with the previous script.