View source for MTK EMail Migrator

==EMail Migration==
To migrate email, the EMail Migrator uses EWS to transfer the data. For best performance, the user CSV file created during User Migration should be split into 200 user segments. This allows you to also run the migration on multiple workstations. 

==Prerequisites==
* Exported eDirectory, or Merged eDirectory and GroupWise user CSV file, split into 200 user segments.
* Users migrated to Exchange/O365
* EWS configured

==Configure E-mail Migration==
The Email Migrator needs to be configured so it knows the source and destination for the items.

There are two modes for the migrator mail items and calendar items. 

===General settings===
* Under Configuration | General, set Migration Items to Mail
* Set "Source Server" to GroupWise
* Set "Target Server" to Exchange or Office365
* Set "# of Concurrent Migrations" to 5 (Max). To run more then five migrations in parallel, it is recommended to setup additional migration workstations.
* Set Duplicates to No Action, Replace slows the migration down, and Skip currently doesn’t work. 
* Leave "Default Sender" blank. To change where all messages are sent from, supply an email address.
* Auto Email Address Translation: Change address to current address in Exchange. 
* Time Zone: Changes time zone (not currently functional) 
* User List: Import eDirectory and GroupWise user.csv
* Save to File to save for the next session.
* Press Save to close the window for this session.

===GroupWise Settings===
Select the Source Server (GroupWise) and click on Settings.

Enter the data:
* SOAP Host IP Address or Hostname
* SOAP Port (7191 is the default)
* Enable SSL, if needed
* Trusted Application Name (Case Sensitive)
* Trusted Application Key (Case Sensitive)
* Click Test, to test the connection.

Save the setting to a file with the Save to File button and save the settings.

===Exchange Settings===
Select the Destination Server (Exchange) and click on Settings.

Enter the data:
* AD Domain Controller Hostname or IP Address
* AD Domain Controller Port (3268 is the default)
* Impersonation User Email Address
* Impersonation User Password
* Enable SSL, if needed
* Exchange Domain (Usually the email domain)
* Search Domain (In LDAP format. e.g. CN=Users,DC=company,DC=com)
* Default EWS URL
* SMTP Host IP Address or hostname
* SMTP Port (25 is default)
* Enable TLS, if needed.

===O365 Settings===
Select the Destination Server (Office365) and click on Settings.

Enter the data:
* Impersonation User Email Address
* Impersonation User Password
* Default EWS URL as found during System Preparation
* SMTP Host IP Address or hostname
* SMTP Port (25 is default)
* Enable TLS, if needed.

Note: The test only tests for SMTP connection.

===Migration Criteria Settings===
General limits on the email migration can be set on this panel. Generally, the defaults are sufficient. However, if your email system contains long term data you may want to consider entering a Start Date. Most organizations have a 10 year data retention policy, it makes little sense to migrate 20+ years of data in that case.

===Other Settings===
Personal Address Books are not migrated by default.

The MTK can send a Shared Folder Notification Email to the owners of the shared folder.

Once the setting are complete, save them to file for the next migration session and press Save to return to the migration tool.

===Email Migration===
Press "Load Users" to load the CSV file. 

* Select none to migrate all users or click on a user select one user, or use Shift-click to select continuous multiple users or Control-click for discontinuous multiple users.
* Press Start to being the migration process. 
* If some users failed during a pass you can use Edit | Select failed entries to select the failed users to see which ones failed and retry.

----
Return to [[Retain_Migration_Toolkit]]