Skip Ribbon Commands
Skip to main content

How do I migrate archived email using in-flight stub rehydration?

Last Update: 1/20/2017 3:24 PM

​​​​​​​​​​​​How do I migrate archived email using in-flight stub rehydration?

Answer:

Complete each of the major steps listed below to perform a mailbox migration with in-flight stub rehydration:
  • Step 1: Create the mailbox migration project with in-flight stub rehydration
  • Step 2: Add items to the mailbox migration project in MigrationWiz
  • Step 3: Run the archive extractor
  • Step 4: Start the mailbox migration
The sections below provide detailed instructions for each of these major steps.

Note: Read the In-Flight Stub Rehydration Overview article to learn more about in-flight stub rehydration.


Step 1: Creat​e the mailbox migration project with in-flight stub rehydration

 

  1. Create a new mailbox migration project. Read the How do I create a new mailbox migration project? article for more information about how to create a project.
  2. Configure Exchange Server 2003+ or Hosted Exchange as the Source endpoint, and click Next Step. Read the How do I add endpoints to a customer in MSPComplete? article for more information about how to create an endpoint.
  3. Checkmark the box next to Migrate archive stubs to configure in-flight stub rehydration for the mailbox migration project.

    Note: Stub rehydration for hybrid Exchange configurations can only be performed using the BitTitan Archive Migration Service (AMS). Read the AMS Overview article for more information.

  4. Enter the connection string for the Enterprise Vault SQL server "Directory" database into the SQL Connection String field.

    Example: Initial Catalog=<Enterprise Vault directory>;Data Source=<data source>;User Id=sa;Password=<password>
  5. In the Archive Source Type drop-down menu, leave "Enterprise Vault" selected. Veritas Enterprise Vault (version 9 or later) is the only email archive system supported at this time.

  6. If the Source Exchange Server connects to an Active Directory that is not configured as a default, checkmark the box next to Specify Active Directory. Skip to step nine​ below if the Exchange Server connects to the default Active Directory.
  7. Enter the path for the Active Directory into the Active Directory Path field.

    Example: LDAP://ofmdcoly302.ofm.wa.lcl/ou=employees,dc=ofm,dc=wa
  8. Enter a username and password if credentials are required to connect to the Active Directory.


  9. Click Save Project.
  10. Configure the Destination endpoint, and click Next Step.

    Note: Read the How do I add endpoints to a customer in MSPComplete? article for more information about how to create an endpoint.
  11. On the project summary page, you can choose to use an access token or enter your own unique extractor code to associate the archive extractor that will run on the Source environment with the mailbox migration project in MigrationWiz.


    • The access token is a system-generated code that you enter into the archive extractor without having to share your username and password for MigrationWiz. This option is advantageous if you plan to delegate deployment of the archive extractor to your customer but don't want to share your MigrationWiz password.
    • The extractor code is a user-defined code that you enter into the archive extractor only after first authenticating to MigrationWiz. This option is advantageous if you are migrating from multiple Source servers to a single Destination server, or from a single Source server to multiple Destination servers and are able to share your MigrationWiz password.

      Write down (or copy/paste) the access token or extractor code, because you will need it when running the archive extractor setup file.
  12. Click Download the Extractor Agent to save a copy of the archive extractor setup file. You will run the setup file on the Source environment as directed in the "Step 3: Run the archive extractor" section below.
  13. Click Save Project.

 

Step 2: Add items to the mailbox migration project in MigrationWiz

 

Add items to the mailbox migration project in MigrationWiz. Read the How do I add items to my migration project? article for more information about how to add items to a project.

 

Step 3: Run ​​the archive extractor

 ​

Note: You must enable API access for your MigrationWiz account to connect the archive extractor to your account. Read the How do I enable BitTitan PowerShell on my account? article to learn how to enable API access for your account.

  1. Open the archive extractor setup file on a virtual or physical machine that is in the same local area network as the Enterprise Vault SQL server, file server, and the Active Directory. Read the What is the archive extractor for in-flight stub rehydration? article for more information about the archive extractor.
  2. Type one of the following options and press Enter to associate the archive extractor with the mailbox migration project in MigrationWiz.

    • Option 1 to enter your MigrationWiz credentials and the extractor code you defined when you created the mailbox migration project.
    • Option 2 to enter the system-generated access token that you wrote down when you created the mailbox migration project.
    • The following support options are also available:
      • Option 3 to test the connection between the archive extractor and the Enterprise Vault SQL server, file server, and the Active Directory.
      • Option 4 to view the help menu for the archive extractor.
  3. Once the archive extractor is associated with a mailbox migration project in MigrationWiz, it compares mailboxes in Active Directory and Enterprise Vault against the Source mailboxes defined in the mailbox migration project. The archive extractor then generates two CSV log files; one containing a list of mailboxes ready to migrate and the other containing a list of mailboxes that require corrective action before starting the migration. Read the What are the archive extractor CSV log files? article to learn more about the CSV log files and how to take corrective action.
  4. Once you've reviewed the CSV log files, you can run the mailbox migration project and the extract​or will begin extracting data from Enterprise Vault when an email stub is identified by MigrationWiz.

    Important: The archive extractor must be up and running for the entire duration of the mailbox migration because it does not run as a background process. Read the In-Flight Stub Rehydration Overview to learn how the archive extractor works in tandem with MigrationWiz to migrate archived email.

 

Step 4: Start t​​he mailbox migration

  • There are many migration strategies that you can employ, depending on the size of the mailbox migration. Read the What are the common migration strategies? article for more information about the different migration strategies.
  • Start the mailbox migration when you are ready to begin. Read the How do I start a migration? article for more information about starting the migration.
  • During the migration, the archive extractor generates "success" and "failed" CSV files that can be used to define the destination of orphaned archived email or correct email addresses that may be incorrect or could not be found. Read the What are the archive extractor CSV files? article to learn how to modify the CSV file for your mailbox migration project.