How do I set up the Lotus Notes Extractor?

How do I set up the Lotus Notes Extractor?


Lotus Notes is the only messaging system supported by MigrationWiz that requires installation of local client software to perform a migration. The Lotus Extractor is a small console application (available here) responsible for extracting data from the Domino server, and securely streaming this data to your MigrationWiz web portal.

Note: The Lotus Extractor requires that you have the .NET Framework version 4.6.1 or later installed on the computer on which you install and run the Extractor. To determine the .NET Framework version currently installed, follow instructions provided by Microsoft: How to: Determine Which .NET Framework Versions Are Installed.



  • Before setting up the Lotus Extractor, review the requirements for installation in KB004286.
  • The Lotus Extractor will require ports 80 and 443 to be open.
  • Also, review the best practices for setting up the Extractor environment: KB005634.



Follow these steps on each machine that will run a Lotus Extractor:

  1. Install the Lotus Notes client on the machine (or virtual machine).
  2. Open the Lotus Notes client and log in with the same administrative account that was set up for migration.
  3. Retrieve the ID file for the administrative account being used for migration and copy it to the machine (or virtual machine).
  4. Ensure that the Internet proxy settings are correct on the machine (or virtual machine). These can be checked by opening Internet Explorer and navigating to Tools -> Internet Options -> Connections and disabling the Automatically Detect Settings option.  If you are unable to connect to the internet with this option disabled, contact the network administrator to allow the Lotus Extractor.
  5. Close the Lotus Notes client. This will release the lock taken by the Lotus Notes client on the notes.ini file.
  6. Install the Lotus Extractor. It is available for download here.
  7. Once installed, start the Lotus Extractor.
  8. Each Lotus Extractor displays a unique identifier called Lotus Extractor Identifier (see the example on the screen shot below, line 2). Copy this identifier, because it will be needed later, during the migration configuration.
  9. Enter your BitTitan account username and password.
  10. Enter the password of the Lotus Notes administrative account that was created for migration.



  • Each Lotus Extractor can simultaneously migrate up to 15 mailboxes. Therefore, once you have set up your MigrationWiz mailbox migration projects, you should go into Advanced Options and set the number of concurrent migrations to 15. KB004627
  • Deploy each Lotus Extractor within the same Local Area Network where its target Lotus Domino server is located.
  • Do not deploy a Lotus Extractor on a machine on which the Lotus Domino server is deployed.
  • In the case of clustered Domino servers set up with replication enabled, a single Domino server has to be selected as a source of data for all migration activities using MigrationWiz.
  • Do not deploy more than one Lotus Extractor on the same machine.
  • Do not stop a running Lotus Extractor. Leave the console window open; the migration will start automatically after the last step of the configuration.
  • After authenticating, the Lotus Extractor will generate a CSV file named "LotusExtractor.csv". This can be used to bulk add users within your MigrationWiz project. KB004290
Was this article helpful?
2 out of 4 found this helpful