9.9 Quick Start Guide

9.9.1 Interface

The migrator is fairly straight-forward in presentation and function. In general, the migrator must be able to have access to the archives and the host mail system.

Once configured, the migrator will connect to the host system to gather information, the local archives to gather data, and the Retain Server to migrate the data into the Retain archive. Multiple archives may be migrated at the same time. Archive size is not an issue, as the migrator only loads a single message at a time. However, due to the operations required, migrating extensive archives may take some time.

The interface has a few features, all accessed through the right-click menu. Users must be selected in the interface in order to be migrated. ONLY selected users will be migrated.

  • Reset - right-click on a user to reset status and errors. This will allow re-migration of problem accounts.

  • Select All - right-click anywhere on the user panel of the migration tool to display the 'Select All' feature, to select all users listed.

9.9.2 Configure Migrator

Start the tool by running the executable file from the shortcut.

  • File | New Configuration Select

  • Select the Email System: Exchange or GroupWise

Exchange

GroupWise

  • Browse to the REST Configuration XML or Worker Bootstrap CFG file exported from Retain.

  • Point the migrator to the parent folder of the Data, Audit and Attachments folders.

  • Ignore Missing Attachments: Attachments that are not present will be skipped and the remaining messages will be processed, instead of erroring out.

  • Create Root Folder: Enabling this option will allow you to specify the name of the root folder for the destination of the migrated messages and folder structure in each user's Retain mailbox. If this option is not enabled, the messages and folder structure will be placed directly under the user's Retain mailbox.

  • Migrate Retention Periods: This option will migrate the expiration date of the migrated messages into Retain.

  • Override Expiry Dates: This option is dependant on "Migrate Retention Periods" and will override the existing expiration date with one of your choosing.

  • Only Process Messages: Enabling this option allows you to limit the migration by date in one of three ways:

    1. Falling between 2 dates (inclusive).

    2. Before a certain date (exclusive).

    3. After a certain date (exclusive).

      Inclusive means that messages on the dates will be included.

      Exclusive means that messages on that date will be excluded. For example, if you want all messages before 21 Oct 2015 (exclusive) it will only migrate message until midnight 20 Oct 2015.

  • Lookup User Emails/UUID in Sent Items: Enabling this option will cause the migration tool to lookup the user email or UUID that may exist in the user's M+ or Netmail Sent Items.

  • Select the # of Concurrent Migration threads to run:

    NOTE:The number of concurrent migrations may be as high as 10, or as low as 1. Performance will be determined by the processor of the local machine; a multi-core or multi-threaded processor will perform fine with multiple concurrent migrations, while machines with lower resources will be taxed by higher numbers of concurrent migrations.

  • Click Save to File and select a name and location for your configuration file. The next time you run the migrator you can load the configuration from file to save time.

  • Click Save to exit the Migration Context