ZCS Migration Wizard for Domino 5.0
Table of Contents Previous Next Index

Migrating from IBM Lotus Domino to Zimbra Collaboration Suite

Migrating from IBM Lotus Domino to Zimbra Collaboration Suite
The Zimbra Collaboration Suite (ZCS) Migration Wizard for Lotus Domino is used to migrate IBM® Lotus® Domino® server email accounts to the Zimbra Collaboration Suite server and to import the email, calendar, and address book information for the selected Lotus Domino users. The import process replicates the user’s Lotus Domino folder hierarchy, importing email messages, calendars, address books, and distribution lists from the Lotus Domino server. Any keywords are converted to tags in Zimbra Collaboration Suite.
Accounts from IBM Lotus Domino version 5.0.8 and later can be migrated.
During the migration, the ZCS Migration Wizard performs the following tasks:
Note: Only email messages, calendars, and address books (including distributions lists) are imported from the Lotus Domino server. Other Lotus Notes® types, including customized templates, delivery failure reports, meeting request and responses, Global Address List (GAL), to-do list, personal journal, and rules and alerts are not imported. Rich text in email messages is converted to plain text.
Lotus Domino Requirements
The ZCS Migration Wizard utilizes the Lotus Notes Script Libraries. Therefore, you must run the ZCS Migration Wizard from a Microsoft® Windows® computer that has Lotus Notes R6 or later installed.
In order for the ZCS Migration Wizard to conduct the migration, you must supply the ID file that has full administrative privileges on mailboxes to be migrated.
Planning the Migration from Lotus Domino to Zimbra
Before you attempt to migrate from the Lotus Domino server, create a communication plan to notify users about the new Zimbra email program and to provide users with the new mail access information (Zimbra URL, login name, and password to use).
Zimbra recommends that you plan to perform the migration during off-peak use times. The Lotus Domino server does not need to be stopped in order to migrate accounts. Any emails that are sent to or delivered from Lotus Domino after the account is migrated are not saved in the Zimbra mailbox.
The ZCS Migration Wizard asks you questions in a series of dialog boxes about how to set up the new accounts. Before you start, you should determine:
Considerations for retaining domain name when migrating
If your users use the Calendar application, and you are not migrating all users to ZCS at the same time, configure ZCS with the same domain name as used on the Lotus Domino server. When ZCS is configured with the same domain name, a user’s existing email address will be retained when the account migrates to ZCS.
Meeting requests and appointments contain recipient information in the form of email addresses. After migration, if the organizer of an appointment updates an existing appointment or if recipients reply to an invitation, the email address of the original message receives the notification. If the email address has been changed, the notification is not received.
Migration options to configure
After the accounts are created on the Zimbra server, the email messages, calendar entries, and contact information are imported. You configure the following rules for accounts being imported:
Import the content of Junk Mail folders, yes/no
Should the new email address replace the Lotus Domino email address in all meetings organized by the user? <check box>
By default, messages larger than 10 MB will not be imported. The message size includes the message and attachments. If the message is larger than 10 MB, a warning is logged to Migration Wizard log file, which can be reviewed from the Import Complete dialog when the migration is complete.
Note: You can modify the following registry key to change the default limit: HKCU\Software\Zimbra\MaxAttachSizeMB. The registry key should be specified in megabytes (MB). A value of 0 means no limit to the size of the message with attachments.You must also change the Maximum size of an uploaded file (kb), located in the Administration Console under Global Settings>MTA, to match the new registry key value.
The import process contains a few assumptions regarding naming:
Imports are by a single domain. For example, you might import users from marketing.domain.com on your Lotus Domino server to marketing.zimbra.domain.com on your Zimbra server.
The local part of the user’s SMTP address in Lotus Domino becomes the first portion of the email address on the Zimbra server. To continue the above example, a user who has an account for joe@marketing.domain.com on Lotus Domino would become joe@marketing.zimbra.domain.com on your Zimbra server.
Using the ZCS Migration Wizard
Even though the ZCS Migration Wizard can be run from start to finish without stopping, Zimbra recommends that after the accounts are migrated, you stop. Before proceeding, change the mail relay information to point to the Zimbra server instead of the Lotus Domino server. This will prevent any lost mail while the files are being imported.
Note: After the files have been imported to the Zimbra server, you should verify that the import was successful before deleting the Lotus Domino accounts.
How to Migrate Accounts and Import Email
The ZCS Migration Wizard can be downloaded from the Zimbra Administration Download page on the Zimbra administration console.
From the Zimbra Administration Download page click the Migration Wizard for Lotus Domino icon to download the ZCS Migration Wizard executable to your computer.
Double-click on the ZCS Migration Wizard executable. The Welcome dialog appears. Click Next to continue.
The Import Destination dialog is displayed.
Enter the following:
Host name. This is the host name of the Zimbra server.
Admin Port. The default admin services port is 7071.
Use Secure Connection (SSL) is checked to establish a secure connection to the server port.
Username and Password. This is the name and password of the administrator account on the Zimbra server.
Click Next.
In the Destination Domain dialog, select the Zimbra domain name where accounts will migrate.
Note: If you create the domain name after you started the ZCS Migration Wizard, click Refresh Domains to update the list from the Zimbra server.
Click Next.
Enter the following:
LDAP Server. The internal or external LDAP server name.
LDAP Port. The default is 389.
User DN and Password. Enter the DN (Distinguished Name). If the LDAP is external, the DN is the LDAP user name and password. If the LDAP is on the Domino server, use your user name and password.
The Import Source dialog is displayed. If the ZCS Migration Wizard can determine the Domino server name, administration ID file path, and Lotus Notes INI file path, this information is displayed in the dialog. If this information is missing, enter the information.
Migrate Private Folders is not checked. To migrate user’s Lotus Domino private folders, you must complete the following:
Specify the path to the directory containing ID files of all the Lotus Domino users to be migrated. The names of the ID files should follow the format <user shortname>.id.
Specify the path to the file containing passwords for these ID files. The users and passwords should be specified in format <user full name>:<password>. The user full name format is <username>/[<organization unit>/]<organization>. For example, if the user is Joe, the organization is Zimbra and the organization unit is marketing, then the user full name is joe/marketing/zimbra.
Click Next.
In the Source and Destination Mailboxes dialog, define the users to be migrated to the Zimbra server. Choose one of the following ways to select users:
Object Picker, to select specific users to migrate. Go to step a.
Query Builder, to select groups of users to migrate. Go to step b.
Click Object Picker to select specific accounts to migrate.
In the Internet address starts with box, enter a few starting characters of the SMTP address to be migrated. The wildcard characters, * and ?, can used.
Click Go. All users whose SMTP address starts with the entered characters are listed. Select the users to migrate from the list.
Click Add.
Click Query Builder, to select groups of accounts to migrate.
In the Query Builder dialog, enter the search base for the LDAP query and construct the filter to identify which mailboxes to import.
The Source & Destination Mailboxes dialog now displays the Zimbra account name, the Lotus Domain server DN information and the Lotus Domino user DN information for accounts to be migrated. Review the information.
If any accounts should not be migrated, select the account and click Remove, otherwise click Next to continue.
The ZCS Migration Wizard now checks to see if these accounts exist on the Zimbra server. After checking all the accounts, the Target Account Verification dialog displays the number of accounts that exist and the number of accounts that do not exist on the Zimbra server. The accounts with the status of No such account will be created. Click Next.
The Account Provisioning dialog is displayed. All accounts with the status of No such account are shown in the Unprovisioned Accounts list box. Before creating these accounts, select the Class of Service (COS) that these accounts will be assigned and enter the default password for the accounts.
The COS defines the features and preferences for these accounts. Classes of Service that have been configured on the Zimbra server are listed. If you recently created a COS and it is not listed, click Refresh COS. New COSs are added to the list.
Important: Included in this list are two COSs called default and None.The COS named default refers to the default COS that was automatically created when Zimbra Collaboration Suite is installed. The COS named None is used to represent a COS configured for the domain that is being migrated. Configuring a domain COS is optional. Select None to provision the accounts with the COS assigned to the domain. If None is selected and the domain has not been configured with a specific COS, the COS named default is automatically assigned.
In the Initial Password field, enter a default password. This is the password for every account that is created.
Note: If password is not specified at the time of provisioning, after the migration you can either:
Configure ZCS authentication to be external against the LDAP directory. Users can continue to use their existing password.
Click Next. The listed accounts are provisioned.
Note: If you do not want to create any of the accounts from this list, check Do not provision any users, and click Next. No accounts are created on the Zimbra server.
The provisioning of email accounts on the Zimbra server is complete. Before proceeding you should change the mail relay information for these users to point to the Zimbra server instead of the Lotus Domino server. Any new email messages are sent to the Zimbra mailboxes.
The Import Items dialog is used to select which parts of users accounts should be imported.
Import Mails. Select this item to import users’ mail.
Import Contacts. Select this item to import users’ contact folders.
Import Calendar. Select this item to import users’ calendars.
Calendar Options. If you chose to import users’ calendars, you can specify whether to convert meetings organized by users to their new addresses.
The Import Options dialog is used to set rules about what files should be imported.
The checkboxes for Import Junk-Mail Folder and Import Deleted Items Folder determine whether or not to import mail currently in those Junk Mail and Trash folders respectively.
The checkbox for Ignore previously imported items can be used in cases where an earlier import operation was interrupted. If checked, the import process picks up where it left off, rather than importing duplicates.
Check the Date Filter checkbox to import mail only after a certain date. This lets you discard old messages.
In the Concurrency field, set the number of accounts to import simultaneously. Since the import is likely to happen while both servers continue to service other mail accounts, you should use caution when increasing this number, because setting this number too high may affect server performance.
Click Next. A confirmation dialog appears. Click OK to begin importing.
Important: Users can continue to work in Lotus Notes while their mail is being imported, although any operation they do after that mailbox folder has been imported will not be picked up by the Zimbra server. To ensure that the imported mailbox is consistent with the old mailbox, we recommend informing users that their mailboxes will be unavailable over some scheduled downtime period.
The Import In Progress screen displays the import progress.
When the import is complete, the Import Completed dialog displays any errors. If errors or warnings appear, review the Description column and take appropriate action.
For more information, click Open Log File to view details. You can also view the log file in %temp%\<Application-Name>\m21.log.
Use Import More Users to re-run the import on a different batch of users. You might do this to import users from another domain, for example.
Click Finish to close the ZCS Migration Wizard.
Registry Keys for the ZCS Migration Wizard
Below is a list of all the registry keys for the ZCS Migration Wizard.
Important: Before you change any registry key values, be sure to create a backup of the original registry key values.
The following keys are located under HKCU\Software\Zimbra\DominoMigration
Default port on which the administrator and non-administrator services run.
By default, messages larger than 10 MB will not be imported. The limit can be changed by modifying the registry. The key value should be specified in megabytes (MB). A value is zero, there is no limit to the size of message attachments.
By default, after three consecutive errors the ZCS Migration Wizard will stop. The limit can be changed by modifying the registry. If the value is zero, the ZCS Migration Wizard will not stop.
Zimbra, Inc.
Copyright © Zimbra, Inc. 2005-2007. All rights reserved.
The Zimbra logo and logo type are trademarks of Zimbra, Inc. All other trademarks are the property of their respective owners.

ZCS Migration Wizard for Domino 5.0
Copyright © 2007 Zimbra Inc.