Skip Ribbon Commands
Skip to main content

What are the archive extractor CSV log files for in-flight stub rehydration?

Last Update: 7/21/2017 11:33 AM
This article has been moved to our new Help Center. Please update your bookmarks.

​What are the archive extractor CSV log files for in-flight stub rehydration​?

Answer:

The archive extractor for in-flight stub rehydration generates two CSV log files when you verify credentials for the mailbox migration project in MigrationWiz.

  1. <ConnectorId>-users.csv
    This “users” CSV log file contains a list of the archived mailboxes that were successfully identified between Enterprise Vault and Active Directory.
  2. <ConnectorId>-failed_users.csv
    This “failed users” CSV log file contains a list of the archived mailboxes that failed to identify between Enterprise Vault and Active Directory.

    Note: Failures are typically because the archive extractor could not find an entry in Active Directory that matches the archived mailbox’s X.400 address in Enterprise Vault, or the archive extractor found an entry in Active Directory but the entry’s primary email address attribute is blank.

Share both CSV log files with your customer and discuss the available options. The customer can choose to provide the required information to take corrective action, or ignore the failed users, in which case those archived mailboxes are not migrated and their X.400 addresses are not mapped to SMTP.

Note: Read the In-Flight Stub Rehydration Overview article to learn more about how the extractor agent and MigrationWiz work in tandem. Also read the How do I migrate archived email using in-flight stub rehydration? article for full instructions on how to migrate a mailbox using in-flight stub rehydration and deploy the archive extractor.

 

Open the archive extractor CSV log files and take corrective action

     

Important: Complete these steps before starting the mailbox migration. Failure to complete these steps will cause the mailbox migration to fail if it is in progress.

  1. In MigrationWiz, run Verify Credentials for the mailbox migration project with in-flight stub rehydration.
  2. Once the Verify Credentials completes, shut down the archive extractor application that is running on the Source environment.
  3. Browse to this directory on the machine running the archive extractor:
    • C:\Users\<user>\AppData\Local\BitTitan
      Note: <user> is the signed-in Windows user account under which the archive extractor is running.
  4. The folder contains the following CSV log files:
    • <ConnectorId>-users.csv
    • <ConnectorId>-failed_users.csv
  5. Important: Share both CSV log files with your customer to confirm which archived mailboxes are migrating and which need corrective action. The customer can choose to provide the required information so that you can correct the issues using the steps outlined below. Or the customer can choose to ignore the failed users, in which case you can skip the steps below and start the migration. The archived mailboxes in the “failed users” CSV log file are not migrated and their X.400 addresses are not mapped to SMTP.
  6. To take corrective action, open both CSV log files. Each line item in the CSV log files is an archived mailbox or journal, and each column is data that the archive extractor queried for each mailbox from either the EV or Active Directory. In the “failed users” CSV log file, each blank column is data that the archive extractor was unable to query.

    ifsrlogfile1.png
  7. From the “failed users” CSV log file, copy the entire line item (archived mailbox) that you wish to correct
  8. Paste the line item to bottom of the “users” CSV log file.
  9. In the “users” CSV log file, for the line item that you just inserted, fill in the blank columns to ensure the archived mailbox is migrated correctly:
    • Email Address
      Enter the mailbox’s email address.
    • Alternate Email Addresses
      Enter the mailbox’s alias, if any. If there are multiple aliases, separate each email address with a vertical bar symbol (shift+\).
    • LegacyExchangeDN
      Enter the mailbox’s LegacyExchangeDN.
    • Display Name
      Enter the mailbox’s display name.
  10. Save and close both CSV log files.

    Note: When saving the CSV file, you may be notified that some features in the workbook might be lost if you save it as a CSV file. Click Yes to save the file.
  11. Restart the archive extractor. It will refresh with the new “users” CSV log file and will migrate the archived mailboxes accordingly.

 

​