Embed Size (px)
Citation preview
4.5Notes Migrator forExchange
Quick-StartGuide
Notes Migrator for ExchangeNotes Migrator for Exchange Quick-Start GuideUpdated - October 2011 (Doc ID 273)Software Version - 4.5
© 2011 Quest Software, Inc.ALL RIGHTS RESERVED.
This guide contains proprietary information protected by copyright. The software described in this guide is furnished under a software license or nondisclosure agreement. This software may be used or copied only in accordance with the terms of the applicable agreement. No part of this guide may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying and recording for any purpose other than the purchaser’s personal use without the written permission of Quest Software, Inc.
If you have any questions regarding your potential use of this material, please contact:
Quest Software World HeadquartersLEGAL Dept5 Polaris WayAliso Viejo, CA 92656
www.quest.comemail: [email protected]
Refer to our Web site for regional and international office information.
DISCLAIMER
The information in this document is provided in connection with Quest products. No license, express or implied, by estoppel or otherwise, to any intellectual property right is granted by this document or in connection with the sale of Quest products. EXCEPT AS SET FORTH IN QUEST'S TERMS AND CONDITIONS AS SPECIFIED IN THE LICENSE AGREEMENT FOR THIS PRODUCT, QUEST ASSUMES NO LIABILITY WHATSOEVER AND DISCLAIMS ANY EXPRESS, IMPLIED OR STATUTORY WARRANTY RELATING TO ITS PRODUCTS INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT. IN NO EVENT SHALL QUEST BE LIABLE FOR ANY DIRECT, INDIRECT, CONSEQUENTIAL, PUNITIVE, SPECIAL OR INCIDENTAL DAMAGES (INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF PROFITS, BUSINESS INTERRUPTION OR LOSS OF INFORMATION) ARISING OUT OF THE USE OR INABILITY TO USE THIS DOCUMENT, EVEN IF QUEST HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. Quest makes no representations or warranties with respect to the accuracy or completeness of the contents of this document and reserves the right to make changes to specifications and product descriptions at any time without notice. Quest does not make any commitment to update the information contained in this document.
TRADEMARKS
Quest, Quest Software, and the Quest Software logo are trademarks and registered trademarks of Quest Software, Inc. in the United States of America and other countries. For a complete list of Quest Software’s trademarks, please see http://www.quest.com/legal/trademark-information.aspx. Other trademarks and registered trademarks are property of their respective owners.
Contents
About the NME Documentation . . . . . . . . . . . . . . . . . . . .4
About This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . .4How To Use the NME Product Documentation. . . . . . . .4
Product Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5
The Problems of Migration . . . . . . . . . . . . . . . . . . . . .5The Solution: Notes Migrator for Exchange . . . . . . . . .5Product Components. . . . . . . . . . . . . . . . . . . . . . . . .6
System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . .8
Necessary Permissions and Security Considerations . . .8How To Set the "Receive As" Privilege in Exchange. . . .9NME Requirement Specifications . . . . . . . . . . . . . . . .9
Getting Started. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Upgrade Considerations . . . . . . . . . . . . . . . . . . . . .12Installing Notes Migrator for Exchange . . . . . . . . . . .12Licensing Quest Notes Migrator for Exchange. . . . . . .13Running Quest Notes Migrator for Exchange . . . . . . .13Post-Installation Tasks . . . . . . . . . . . . . . . . . . . . . .14Uninstalling Notes Migrator for Exchange . . . . . . . . .14
Conceptual Walkthrough . . . . . . . . . . . . . . . . . . . . . . . 15
Migration Process Overview. . . . . . . . . . . . . . . . . . . . . 16
Necessary Pre-Migration Preparations . . . . . . . . . . . .17Migration Process (Per User Collection) . . . . . . . . . . .18Post-Migration Cleanup . . . . . . . . . . . . . . . . . . . . . .18
Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
About Quest Software . . . . . . . . . . . . . . . . . . . . . . . . . 23
Contacting Quest Software . . . . . . . . . . . . . . . . . . .23Quest Support . . . . . . . . . . . . . . . . . . . . . . . . . . . .23Visit Our ZeroIMPACT Migration Online Community . .23
Notes Migrator for Exchange
About the NME Documentation
About This Guide
This Quick-Start Guide has been prepared to get you started with Notes Migrator for Exchange (NME)—to orient you to its basic purposes and features, and then to help you install it. This Guide also presents a brief narrative case study to illustrate how NME components are most typically used within the broader context of an overall migration project. The Quick-Start Guide is written for network administrators, consultants, analysts, and any other IT professionals who will install the product, use its admin tools, or contribute to migration project planning.
How To Use the NME Product Documentation
This Quick-Start Guide is part of a suite of documentation that accompanies Quest Notes Migrator for Exchange (NME), consisting of the Release Notes (HTML), the on-line Help, and these printable PDF documents:
• Quick-Start Guide: The document you are now reading—your introduction and orientation to Notes Migrator for Exchange.
• NME Pre-Migration Planning Guide: Explanations of everything an admin should understand and consider before beginning a migration project, including critical planning factors, project planning checklists, how different scenarios affect the approach and preparations for a migration, known limitations of the process, and so forth.
• NME Administration Guide: Operating instructions and application notes for all of the administrator components of Notes Migrator for Exchange, and process instructions for various common scenarios.
• SSDM User Guide: Operating instructions and application notes for the Self-Service Desktop Migrator (SSDM) component of Notes Migrator for Exchange. The SSDM User Guide is provided as a separate document so that an administrator can distribute it to any end users who will run the per-desktop program.
• NME Program Parameters Reference: A comprehensive list of the program parameters ("INI file" parameters) that control the flow and functionality of various features in various NME components.
Generally speaking, the Pre-Migration Planning Guide presents a more conceptual, theoretical view of the product, while the Administration Guide provides the hands-on, screen-by-screen descriptions and field notes. All of these documents except the SSDM User Guide are intended for network administrators, consultants, analysts, and any other IT professionals who will install the product, use its admin tools, or contribute to migration project planning. The SSDM User Guide is intended for end users or administra-tors who will use the Self-Service Desktop Migrator component.
Quest recommends that all admins read all of this Quick-Start Guide and the Pre-Migration Planning Guide (in that order), and use that information to prepare a written Migration Plan before attempting the actual migration process.
The Pre-Migration Planning Guide provides a checklist of topics to include in a Migration Plan that will suit the needs of your network configuration, your users, any institutional imperatives of your organization, and of course your own preferences. When you are ready to begin the actual migration process, you may then refer as needed to the instructions and operational details in the NME Administration Guide.
4
Quick-Start Guide
Product Overview
The Problems of MigrationWhile the benefits of migrating from Lotus Notes to Microsoft Exchange are well understood, the migration of a large enterprise is typically a complex process that requires careful planning and project management. A high-level summary checklist of necessary tasks can be quite long, and will expose a good number of details that must be addressed for a successful migration. The "choreography" in the sequence, timing, and coordination of tasks is also important.
A few products and services are available to help organizations with various pieces of the migration puzzle, but the best solution would be a single coordinated toolkit to provide a comprehensive, project-scale approach to overall migration planning, management, and execution. The component tools and the package as a whole would be versatile enough to accomplish a wide range of migration strategies, all of which must accommodate these critical project elements:
• Preservation of valuable information stored on the Notes system, including mail, attachments, calendar appointments, tasks, and so forth stored on the server, and information such as address books and local stores. Ideally data on the Domino server should be moved to the Exchange server, while Notes local stores should be moved to desktops in Outlook personal storage (.pst) format. To minimize help desk calls, the migration should have high fidelity and all messages should be reply-able at all times during and after the migration project.
• Minimal user involvement in the migration project. Users will likely be getting a new mail client (Outlook) and therefore will need some training. But administrators should be able to perform the migration project with minimal end user involvement.
• Provisioning of user accounts and distribution lists into Active Directory. Quest's Coexistence Manager for Notes (CMN) Directory Connector can create mail-enabled security objects in Active Directory for all Notes users, but cannot create Exchange mailboxes, and cannot move Notes public distribution lists into Active Directory. It is also important that any Internet mail aliases (nicknames) that worked on the Notes system be supported on Exchange.
• Coexistence of the two systems during migration (for medium and large enterprises). Small companies may choose to migrate all users together as a single group to avoid having to support coexistence between the Domino and Exchange directories through the transition period. But most medium and large companies (more than 400 or so users) will need to provide for some level of coexistence. Users should be able to send mail and schedule meetings with one another without having to know the migration status of other users.
The Solution: Notes Migrator for ExchangeQuest Software's Notes Migrator for Exchange (NME) is a set of coordinated software applications designed to facilitate a variety of migration strategies for organizations moving from a Lotus Domino server, with Lotus Notes clients, to a Microsoft Exchange environment with Outlook clients. Supported Exchange destinations are: Exchange 2007 or 2010, Microsoft’s Office 365, and other "hosted" Exchange environments such as Microsoft’s Live@edu and BPOS-S.
The Quest tools are designed to complement other deployment and coexistence tools to deliver these comprehensive, integrated solutions to the challenges of a Notes-to-Exchange migration:
• Migration of server data: NME migrates mail, appointments, tasks and personal address books from the Notes environment, and lets you specify the destinations for different data types, either to the Exchange server or to Outlook personal folders (.pst) files.
• Migration of Notes archives: NME can migrate archives from either a central file server or user desktops, to either Outlook .pst files or the Exchange server.
5
Notes Migrator for Exchange
• User involvement: NME lets an administrator migrate most, or even all, user data with no user involvement whatsoever. In a typical migration scenario, all user data is migrated in batches by an administrator—dozens of users at a time, over a series of migration runs.
• Provisioning: NME extracts user data from the Domino server to mailbox-enable user accounts in Active Directory as users are migrated (creates mailboxes for the mail-enabled security objects created earlier by Quest’s CMN Directory Connector or some other method). The migration program also copies users' Notes addresses and any Notes aliases into AD, and provisions Notes personal distribution lists directly into Active Directory.
• Coexistence: NME offers dynamic mail forwarding features that automatically set, update and remove mail-forwarding rules in user mailboxes, on both servers, to assure correct mail routing throughout the transition period. And while other applications can synchronize the two directories, Quest's Directory Export Wizard can update the data files that Quest's migration programs use to migrate data and convert addresses.
Notes Migrator for Exchange, together with Outlook deployment tools and Quest Coexistence Manager for Notes, can perform or facilitate every administrative task associated with a Notes-to-Exchange migration. (Coexistence Manager for Notes is a separate Quest product—see the Coexistence topic in the NME Pre-Migration Planning Guide for more information.) All NME components support operational options that allow great flexibility in devising and implementing a suitable migration strategy to suit most any network configuration, circumstances and preferences. For example, NME supports all of these common migration scenarios:
• Migration to a local (on-premises) Exchange server.
• Migration from Notes to Microsoft’s Office 365 ("the Cloud") ...
• ... with provisioning directly from the Domino directory to Office 365.• ... with provisioning to Office 365 from an existing local Active Directory (already synchronized to
the local Domino directory).
• Migration from Notes to other hosted-Exchange services.
• Offline migration—where a copy of the Notes source data is migrated first to an intermediate storage medium, and then from the intermediate medium into Exchange.
(An offline migration is useful if, for example, your source and target servers are physically far apart, and limited bandwidth and a large volume of mail make live data transmissions impractical. In this case you could copy the Notes postoffice to a portable large-capacity storage medium, then physically trans-port the medium to another location where you have—or can create—a more favorable bandwidth con-nection to Exchange.)
Meanwhile, the accompanying Quest NME documentation provides a truly project-scale approach to migration planning and management, with a comprehensive, broad-context checklist of strategic planning topics, and broad-context process instructions that explain how the Quest tools fit into the overall flow of a variety of migration scenarios.
Product Components
All the features of Notes Migrator for Exchange are contained within these primary components:
• Notes Migration Manager: The central "console" application that coordinates most administrator-driven tasks and features. The Notes Migration Manager in turn contains an assortment of specialized subcomponent applications, called Wizards (listed separately below), that facilitate particular program features. In addition to its Wizards, the Notes Migration Manager helps you monitor and manage most of the information pertaining to a migration project: program defaults and server access credentials, the locations of Notes/Domino source data, exported data from the Domino directory, and ongoing migration statistics that track the status of a migration project.
6
Quick-Start Guide
• Self-Service Desktop Migrator: A separate application that end users can run (one user at a time) to migrate their own mail, PABs and archives. (An administrator may also run this Desktop Migrator on behalf of an end user, running under the user’s credentials.)
• Notes Migration Scheduling Application: A separate command-line application that executes scheduled tasks. The program checks the SQL Server database to see whether any tasks have been scheduled to run since the last check, and then executes any such tasks.
• SSDM Throttling Utility: A utility that lets an administrator regulate end users’ execution of the Self-Service Desktop Migrator (SSDM), to avoid processing bottlenecks that might otherwise occur if too many users tried to use the SSDM simultaneously.
• Log File Viewer: Simplifies the viewing and interpretation of Quest program log files, which are generated by most NME components to document process errors and warnings.
The Wizards that can be launched from Notes Migration Manager:
• NABs Discovery Wizard: Searches the Notes/Domino server to locate all Notes NABs (Name and Address Books). The Directory Export Wizard and Internet Domains Discovery Wizard will then extract critical directory information from the NABs, which in turn will be read by Quest’s provisioning, object-merging, and migration Wizards so they can perform their tasks.
• Internet Domains Discovery Wizard: Extracts all Internet domains it can find within the Notes' NABs (Name and Address Books) found by the NABs Discovery Wizard. These domains will then be used to generate address aliases for all users, so that Exchange can recognize and correctly route mail sent to users' old addresses.
• Directory Export Wizard: Gathers user information from the Domino server(s) to create SQL Server data tables that will provide critical input data to the Quest provisioning, object-merging, and migration Wizards. You may tell the Wizard to perform the actual export task immediately following its configuration, or the Wizard will let you schedule the task to run at a later time.
• Collection Wizard: Lets you define the members of user and group collections. The provisioning, migration, and other features are applied to collections of users and groups, and the Collection Wizard is what defines these collections. You can add members to a collection by selecting objects from the SQL Server database, or by importing the contents of a .tsv (tab-separated-values format) file, or both.
• AD Groups Provisioning Wizard: Defines a task that will provision distribution groups (create group objects) within Active Directory from a designated group collection, and schedules the task to run at a particular time, or at a series of recurring times.
• Notes Data Locator Wizard: Defines a task that will locate data files in the Notes source for a particular user collection, or gather statistics from previously located data stores, and schedule the task to run at a particular time or at a series of recurring times.
• AD Object Merging Wizard: Consolidates duplicate objects in Active Directory by merging information from Exchange Contacts (generated by a provisioning tool) into corresponding users’ AD accounts, and then deleting the Contacts, to create a single mail-enabled security object per user in AD. (Quest’s CMN Directory Connector generates Exchange Contacts when updating directories, as part of a typical coexistence strategy.)
• Send PAB Replicator Wizard: Sends a special email form to users within a particular user collection, that lets them copy all of their PABs (personal address books) to a centralized Notes server directory, where the Data Migration Wizard will be able to find them and migrate them.
• Data Migration Wizard: Defines a task that can, for all users within a particular user collection:
• Mailbox-enable Exchange accounts.• Migrate user data.• Update mail-forwarding rules.• Perform other related Notes and Exchange administrative functions.
7
Notes Migrator for Exchange
NME copies data from Notes as Unicode and inserts it into Exchange as Unicode. Any data that has a specific character set (MIME data) in the Notes source will retain that character set after migration; the migration features do not convert MIME data into Unicode.
• Self-Service Desktop Migration Statistics Collection Wizard: Gathers migration statistics written by the NME Self-Service Desktop Migrator, and loads the data into the SQL Server database, to help you track the progress of the migration project. The Wizard can perform the data-gathering task immediately following its configuration, or you can schedule the task to run at a later time.
System Requirements
Necessary Permissions and Security ConsiderationsDifferent organizations have different network security standards that determine the number and configuration of user accounts necessary to perform a migration. It is possible to configure a single migration admin account in Active Directory with all the necessary rights in both AD and Exchange to run a full migration. But many organizations prefer not to concentrate so much administrative authority in a single account. The alternative is to configure two separate accounts, each with more restrictive access rights, to perform different portions of the overall migration process—as we document in our NME Requirement Specifications below.
If you prefer the single-account approach:
• In Active Directory, this account must be added to the Domain Admins group. On each Exchange Mailbox Store to which the users are migrating, the account must be added to the security access control list with at least Receive As rights. This single account must then be used to login to the migration workstation, and provide the Exchange Server credentials and the Active Directory credentials as needed.
Some admins prefer yet another approach, equally valid, which calls for a domain user account granted membership in Exchange View-Only Administrators and delegated full control to the target OU. If the contacts will be merged with existing Active Directory user objects as part of the migration process, the account must have full control of the OUs/containers where the AD user objects currently reside. This ensures NME has sufficient access to properly join to the merged user objects and prevents the creation of duplicate contacts.
If migrating to Exchange 2010:
• You can use PowerShell to assign necessary permissions to the AD and Enterprise admins, by this cmdlet:
Add-RoleGroupMember 'Organization Management' -member <UserAcct>
... where <UserAcct> is the admin’s SecurityPrincipalIdParameter.
If migrating to Exchange 2007:
• You can use the Exchange Management Shell to assign necessary permissions to the AD and Enterprise admins:
Add-ExchangeAdministrator -Role OrgAdmin -Identity <UserAcct>
... where <UserAcct> is the admin’s SecurityPrincipalIdParameter.
8
Quick-Start Guide
How To Set the "Receive As" Privilege in ExchangeWhen migrating to Exchange, the admin account that will be used to provide Exchange server credentials and AD credentials from the Quest programs must be configured with Receive As rights to each mailbox store, as noted in the NME Requirement Specifications below.
To set the Receive As privilege in Exchange 2010 (for all mail stores):
Receive As rights are part of the permissions set for the Organization Management role, which you can assign by the PowerShell cmdlet shown above.
To set the Receive As privilege in Exchange 2007 (for all mail stores):
1. Launch an Exchange Management Shell.
2. Type: get-mailboxdatabase | add-adpermission -user <migadmin> -extendedrights Receive-As
NME Requirement Specifications
Lotus Domino Server(s)
Microsoft Exchange Server(s)
Active Directory Server
VersionsSupported
8.5.0–8.5.28.0.0–8.0.27.x 6.x 5.x
Required: An account must be defined with admin rights to the Domino server. You can use the admin account created by Notes/Domino upon installation, or create a new account and add it to the LocalDomainAdmins group.
VersionsSupported
• Exchange 2010: SP0 or SP1• Exchange 2007: SP0, SP1, SP2 or SP3• Microsoft’s Office 365, Live@Edu or BPOS-S
• Required: An account with access rights to Exchange, as described below for Active Directory.• If migrating to Exchange 2010: Remote management must be enabled on the Exchange server. (See in the
NME Administration Guide, Appendix A: How Do I Enable Remote Management on an Exchange 2010 Server?)
Required accounts:• A domain user account in Active Directory, with Read/Write delegate access on all OUs where users and groups
will be provisioned. On the Exchange server, this account will need Exchange Administration delegate access to the Administrative Group where the users’ mailboxes will be created. This account must then be used to login to the migration workstation. See Necessary Permissions and Security Considerations above for information about account configuration options.Note: LDAP policy can be configured to accommodate more than 1000 OUs in Active Directory, by adjusting the max items returned by ADSI interface. See these Microsoft links for LDAP Policies and How to view and set LDAP policy....
• A user object in Active Directory, added to the Domain Users group. On every Exchange Mailbox Store, this account must be added to the security access control list with at least Receive As rights.If migrating to Exchange 2010: The AD admin account must be configured with remote PowerShell enabled, by this Exchange Shell command:
Set-User <alias> -remotepowershellenabled$true... where <alias> is the AD account to which you're granting access.
If your AD is configured for a resource forest and a user forest:In the resource forest, you will need the standard set of permissions cited above. In the user forest, you will need an account that simply has read permissions to the AD, such as a domain user. The software doesn't make any changes to the user forest; it only performs searches.
9
Notes Migrator for Exchange
SQL Server Access Required
On End-User Desktops (if running the SSDM)
Admin Workstation(s) Requirements (workstations running NME admin components)
• Access to a Microsoft SQL Server is required, installed either on the admin's migration workstation or on a separate server.
• You may use an existing (installed) Microsoft SQL Server version 2000, 2005 or 2005 Express, or 2008 or 2008 Express, or you can download and install a free copy from Microsoft, from the link provided in the NME AutoRun installer.
• Note that NME running with SQL Server 2008 requires the SQL 2005 Native Client on the admin's workstation to communicate with SQL. The SQL 2008 Native Client is not supported at this time.
• The SQL bulk insert directory (specified in the SQL Server Configuration screen of Notes Migration Manager) must be accessible to all migration workstations, and to the user that the SQL Server will run as.
Note: The account that the SQL server is running as and the account used to run NME (logged onto the NME workstation) both must have read and write access to the bulk insert shared directory (\\example\bulk), and the NME account must be able to perform a bulk insert operation. While a SQL Authentication account can be configured to run bulk insert, it makes more sense to use only a Windows domain account, which will require bulk insert rights anyway.
OperatingSystemsSupported
32- or 64-bit edition of:• Windows 7• Windows Vista (Business, Enterprise
or Ultimate Edition)• Windows 2003• Windows 2000
32-bit edition (only) of:• Windows XP SP2 or SP3
Professional Edition
RequiredOutlookClient
Must be running 32-bit edition (only) of any of:• Outlook 2010 • Outlook 2002• Outlook 2007 • Outlook 2000 SP3• Outlook 2003For migration to Exchange 2010, Outlook 2010 or 2007 is required.
RequiredLotus NotesClient
Unicode support requires one of these versions:• 8.5.0–8.5.2 (inclusive) • 5.0.11–7.0.3 (inclusive)• 8.0.0–8.0.2 (inclusive)
Other end-user desktop requirements:• End-user desktop may be a virtual matchine, but a dedicated "actual" machine will likely yield better migration
performance.• The MAPI DLLs required to perform a migration must be those that are part of Outlook, not the downloadable
Exchange "server" MAPI.• Prior to running the SSDM: Any antivirus software must be configured to not scan the Quest program files
directory or %temp% directory, or may simply be turned off, but may be restored after the program runs. If an antivirus scan misinterprets an NME temporary file as a threat, it will try to "clean" the file, which will generate an error when the SSDM program call fails.
SupportedOS for migration to:
Win XPx86SP3
Windows Server 2003x86 or x64
Windows Vistax86 or x64
Win Server 2008x86 or x64
Win 7x86 orx64RTM SP1 SP2 R2 RTM SP1 SP2 2008 R2
Exchg 2010 • • • • • • • •Exchg 2007 • • • • • • • • •
Important: NME requires the English-language edition OS/PowerShell on the admin workstation.
Locale Note: Upon migration, standard mail folders assume the names of their corresponding Outlook folders in the language associated with the Windows Locale setting of the admin’s migration workstation.
Parallel Workstations: To accelerate large-scale migrations, NME may be run on multiple migration workstations running in parallel.
Continued ...
10
Quick-Start Guide
On the server hosting the SSDM Scheduling Utility Web Service• ASP.net version 2.0 must be installed.
Admin Workstation Requirements (continued):
Order of Installation: A migration requires an unusual combination of tools, developed by different vendors, all installed on this single admin workstation, and the combination can cause compatibility problems on some machines. To minimize these conflicts, Quest recommends that you install the applications (per the specifications noted below) in this order:
1. Notes client2. Outlook client3. Windows Management Framework or Microsoft PowerShell4. Exchange Admin tools (if migrating to Exchange 2007)
Workstation Hardware:• Must be a separate machine from the Exchange server, but a member of the same domain as AD and Exchange.• May be a virtual machine, but a dedicated "actual" machine will likely yield better migration performance.• Minimum hardware requirements:
• 1+ GHz processor, 1GB memory, 20GB free disk space.• Recommended for improved performance, esp. for high-volume migrations:
• 3+ GHz processor, 2GB memory.• 1 Gbps NIC, and 1 Gbps or faster network connections among all migration workstations and the Exchange
and Domino servers.
Requirements for ALL destination Exchange versions:• Must have a directory with write/execute permissions for the Administrator components of the Quest software,
and must have a directory with read/execute permissions for the user components of the software.• Lotus Notes must be installed in single-user mode and configured. The Notes client version must be in the
range 8.5.0– 8.5.2 or 8.0.0–8.0.2 or 5.0.11–7.0.3 (all ranges inclusive), and must be able to open all the NSF files you want to migrate. The client version should therefore match or be higher than the Domino server version.
• The MAPI DLLs required to perform a migration must be those that are part of Outlook, not the downloadable Exchange "server" MAPI.
• Prior to running any Quest admin application: Any antivirus software must be configured to not scan the Quest program files directory or %temp% directory, or may be simply turned off, but may be restored after the program runs. If an antivirus scan misinterprets an NME temporary file as a threat, it will try to "clean" the file, which will generate an error when the NME program call fails.
Required for migration to Exchange 2010, Office 365 or Live@edu:• Outlook 2010 or 2007, which must be set as the default mail client.• Windows PowerShell 2.0, which is installed by default with Windows 7 or Windows Server 2008 R2. For other
Windows versions, PowerShell 2.0 is downloadable as part of Windows Management Framework at this Microsoft link. Also: Depending on your environment, you may need to run this command to enable the PowerShell layer using remote PowerShell:
get-executionpolicy | set-executionpolicy $unrestricted
Required for migration to Exchange 2007 (only): • Outlook 2010, 2007, 2003 or 2002 (2003–2010 recommended), which must be set as the default mail client.
Outlook 2003–2010 is required to migrate multi-byte items or items from multiple character sets, or to migrate to pst files > 2 GB.
Exchange 2007 or E2007 SP1 Management Tools (32-bit version), which in turn requires: .Net Framework 2.0, Microsoft Management Console (MMC), and Windows PowerShell. The 32-bit version of Exchange 2007 Management Tools is available (at this writing) at this Microsoft link, and see also Microsoft's installation instructions.
11
Notes Migrator for Exchange
Other Required Directories
All machines:• Must have network access.
Getting Started
Upgrade Considerations
There is no need to uninstall a previous version before installing a new version. The upgrade installation and setup are fully automated, and will preserve any data already migrated by an earlier version, so that you may simply resume the migration process from wherever you left off with the previous version.
Installing Notes Migrator for ExchangeTo install Notes Migrator for Exchange:
1. Download the Notes Migrator for Exchange zip folder from the Quest.com website, and extract all files into an installation folder. Then run Autorun.exe from the installation folder.
Windows then launches the Autorun utility, where you can browse product information including the Prerequisites and all NME Documentation before installing the product.
2. Verify that your environment conforms to the System Requirements specified in the NME Quick-Start Guide. Several of the required third-party components may be downloaded from links on the Autorun Prerequisites tab.
3. When you are ready to install, select the Autorun Install tab.
4. Select the Notes Migrator for Exchange product name, and click Next.
5. Read and accept the license agreement.
6. Follow the instructions in the NME Installation Wizard. Note:
• Common application directory: The Quest applications and Wizards need a directory that is accessible (read and write) to the admin accounts that will run the admin components and access source and target data and accounts, and that is shared (read only) to all users who will run the SSDM.
• Shared log directory: The admin components need a shared log directory that is accessible (read and write) to the admin applications and Wizards.
• Shared desktop log directory: Optionally, a shared log directory for the log files generated by the Self-Service Desktop Migrator is required with write access for all users who will run the SSDM.
Note: The upgrade process will back up your existing pabreplicator.nsf, attrs.tsv, wte.htm and ybm.htm files by appending date stamps to the filenames, so the upgrade can then create new files under the same original names.
Note: You could instead simply insert an NME product CD, which runs the Autorun utility automatically.
If your setup includes the Microsoft redistributables, you may install them on your migration workstation. You must have a Microsoft SQL Server installed in your migration environment in order to use Quest Notes Migrator for Exchange. If you want to install the Microsoft SQL Server 2005 Express, you must have .NET Framework 2.0 installed on that machine.
If you are installing on Windows Server 2003 and are installing one of the Microsoft redistributables, a dialog box may interrupt the process, telling you to close the InstallShield Wizard to complete the setup. But closing the InstallShield Wizard is not necessary, and you may click the Ignore button to dismiss the dialog box and safely resume the setup.
12
Quick-Start Guide
7. Follow the remaining instructions and prompts in the NME Installer, and click Finish from the last screen to complete the installation.
The NME Installer then exits, returning you to the Autorun utility, on the Install tab.
8. If you like, you may browse the other Autorun tabs.
9. When you are finished browsing other Autorun tabs, click the Close box ([X] in the top-right corner of the window) to close the Autorun utility.
Be sure to see Licensing Quest Notes Migrator for Exchange below before trying to configure or run any NME component.
Licensing Quest Notes Migrator for ExchangeQuest Notes Migrator for Exchange is a metered-use product that will run only with the application of a valid license key. Quest sells NME license keys by numbers of users migrated. You can obtain your first or a subsequent license key from your Quest Sales representative, or by email at [email protected]. When you obtain a license key, you must install it for it to take effect and enable the product. An NME license key is installed in NME’s Notes Migration Manager.
If you have not previously activated NME with a license key, Notes Migration Manager will prompt you for the license information when you first start the program.
If you already have an NME license but have purchased another license to extend it, you can install the license update in Notes Migration Manager, in the Help | About screen (Help menu option About). To install the update, click the Update License button in the Help | About screen, and follow the prompts.
Running Quest Notes Migrator for Exchange
When you launch the Notes Migration Manager, Quest Notes Migrator for Exchange checks to see if an NME database connection exists on your migration workstation. If a connection does not exist, you must establish the database connection.
To start Quest Notes Migrator for Exchange:
1. Launch the Notes Migration Manager from the Start menu: All Programs | Quest Software | Quest Notes Migrator for Exchange | Migration Manager.
2. Enter your SQL credentials as prompted, and click the Apply button.
If the Notes Migrator for Exchange database is not found on the SQL Server that you have specified, you will be prompted to install the database tables required on your SQL Server. If you have selected the correct SQL Server, you should click OK to populate your SQL Server with the required database tables.
Quest Notes Migrator for Exchange requires access to the SQL Native Client. If you have a Microsoft SQL Server installed on your migration workstation then you already have the Native Client installed. If you do not have the Native Client installed, then you should choose the option in the Installation Wizard to install the Microsoft SQL Server Native Client at the end of the Quest Notes Migrator for Exchange installation.
Locale-specific configuration: If you are migrating from a non-English Lotus Notes environment, you must also configure both the Data Migration Wizard and the SSDM with the appropriate non-English values for certain display elements. See Appendix A of the Admin Guide for instructions, under How Do I Configure Notes Migrator for Exchange for My Non-English Notes Locales?
13
Notes Migrator for Exchange
Post-Installation Tasks
Quest Notes Migrator for Exchange uses some directories that must have certain permissions assigned to them. Prior to running discovery, provisioning and migration tasks, you must create the required directories. These directories must be shared with permissions as described below:
• Bulk Import directory: A directory from which the SQL Server can read and write .
• Administrator log directory: A directory from which the administrator tools (Migration Manager and wizards) can read and write.
• Common application directory: A directory where components and data common to the admin tools and SSDM are stored. The migration admin must be able to write and read to this directory, while access for all non-admin SSDM users should be set to read only.
• Desktop migration logs directory (optional): A directory for collecting logs from desktop migration runs, when users run the Self-Service Desktop Migrator to migrate local datastores and encrypted data. Users running the SSDM will need write access to the directory in order to post the results of their migrations.
Uninstalling Notes Migrator for ExchangeTo uninstall Notes Migrator for Exchange:
1. From your Windows Start button, select Settings | Control Panel.
2. Double-click Add/Remove Programs.
3. Select Quest Notes Migrator for Exchange and click Remove.
14
Quick-Start Guide
Conceptual WalkthroughA directory update by Quest’s CMN Directory Connector (or some other method) extracts data from the Domino directory to create mail-enabled user accounts (contacts) in Active Directory— although Exchange user mailboxes are not yet created. User records in AD contain users’ current Notes addresses,so ...
... Exchange can route Internet mail to users’ Notes mailboxes when you change the MX record to direct inbound mail to the new Exchange server — before the first users are migrated.
NME’s Data Migration Wizard mailbox-enables the AD accounts of migrating users, and sets mail-forwarding rules in Notes so mail addressed to already-migrated users at Notes will be forwarded to their now-active Exchange mailboxes.
15
Notes Migrator for Exchange
Migration Process Overview
This section briefly describes a typical migration scenario using Quest Notes Migrator for Exchange. Details of this process appear in the Migration Process Instructions in chapter 4 of the NME Pre-Migration Planning Guide. In this scenario, an administrator performs the migrations for a series of user groups with no user input or interaction, and we do not use the Self-Service Desktop Migrator at all.
Please Note: The brief narrative here is not meant to be a substitute for the detailed step-by-step process instructions in chapter 4 of the NME Pre-Migration Planning Guide. Rather, the material here is intended only to familiarize you with Quest Notes Migrator for Exchange, and the contexts in which its components are typically used. Be sure to see chapter 4 of your Pre-Migration Planning Guide for complete, step-by-step migration process instructions.
This process repeats as each user group migrates to the new server.
When the last group is migrated to Exchange ...
... the old Domino server can be decommissioned.
16
Quick-Start Guide
This scenario assumes an Exchange 2007 or 2010 destination environment, using Quest’s Coexistence Manager for Notes (CMN) to facilitate directory updates, mail routing and mail remediation, and calendar and free/busy coexistence. CMN is a separate Quest product; see your Quest sales representative for more information.
The approach described here is appropriate for many migrations, but the configuration, circumstances and institutional priorities of any given site will likely dictate variations to this process. Notes Migrator for Exchange offers many operational options that permit much flexibility in devising and implementing a suitable migration strategy. See chapters 2, 3 and 5 of the NME Pre-Migration Planning Guide for detailed information about how Quest tools accommodate various migration scenarios. For information and help with other scenarios, contact your Quest sales representative.
Necessary Pre-Migration PreparationsThe process begins with existing user accounts and mailboxes on a Lotus Domino server. The destination Exchange server is set up on another machine and the migration process will require administrator accounts on both servers. Microsoft Outlook must be installed on users' desktops, and Quest Notes Migrator for Exchange is installed on the administrator's migration machine.
We also install Quest’s Coexistence Manager for Notes (CMN), and run its Directory Connector to perform a directory update between the source and target servers. This process creates mail-enabled accounts (contacts) for all Notes users in Active Directory. The CMN Directory Connector does not create mailboxes, but its directory update provisions new mail-enabled contacts in Active Directory, which associate users' existing Notes addresses with their corresponding new AD objects. The new objects within AD are said to be "mail-enabled" because Exchange can now receive inbound (Internet) mail addressed to these users and immediately route it to the corresponding mailboxes on the Domino server.
Users in this scenario will migrate in a series of collections (user groups), over a period of several weeks, so we will require an email coexistence strategy that permits mail-forwarding throughout the transition period—when some users have already been migrated to Exchange while others wait their turn back on the Domino server. We have chosen to use the SMTP method of mail-routing, and we prefer the simpler single-domain approach, so we configure a smart host for each environment to facilitate that method. (All of these coexistence methods and their alternatives are explained in the NME Pre-Migration Planning Guide.) Then, when our SMTP mail-routing is configured, we modify the MX (Mail eXchange) record to direct external (Internet) mail to the Exchange environment. Since no users have yet been migrated, but all users have been provisioned and mail-enabled in AD, all of the inbound Internet mail is, for the time being, immediately routed back to the corresponding Notes mailboxes.
Next, we run Quest’s Notes Migration Manager to capture information about the Notes environment. From the Notes Migration Manager, we launch the Name & Address Book Discovery Wizard to find the Notes NAB files that describe the Notes directory. Next we run the Internet Domains Discovery Wizard to assemble a list of all Notes and Internet domains in use in the Notes system. The Directory Export Wizard then finds all of the users, contacts, resources, and distribution lists (groups) in the Notes environment. These discovery and export Wizards generate and save the data sets required by the migration process and other Wizards and features.
NME provisioning, migration, and other features are applied to collections of users and distribution groups. A collection is simply a defined subset of the universe of users or groups that the Directory Export Wizard has found in the Notes/Domino environment. These collections are created and characterized in the Collection Wizard, so we run that Wizard now to define our user and group collections.
In this scenario, our Active Directory was already up and running with user accounts before we ran CMN’s Directory Connector, so the new Exchange contacts it created now coexist with existing AD user accounts for the same users. Notes Migrator for Exchange offers an AD Object Merging Wizard that can consolidate
17
Notes Migrator for Exchange
such duplicates before any data is migrated. The merge process requires data that has been exported from the Notes directory, so we can now run the AD Object Merging Wizard to perform the merges for all of the exported Noted users.
Before we migrate any data, we also run the AD Groups Provisioning Wizard program to provision Notes public distribution lists in Exchange as Active Directory distribution groups.
Our users' archives and PABs are stored on their local hard drives in this scenario, so before migration the users copy them to centralized, accessible locations, where the Data Migration Wizard will be able to find them. After the files are copied, the Locate Data Stores Wizard is run to identify all of the Notes mail files, archives, and PABs before migration. The administrator can then review and assess the volume of data to be migrated from the captured data within Notes Migration Manager.
Migration Process (Per User Collection)All of the tasks and conditions noted in the preceding section are prerequisites to the migration of the first user collection.
If our organization has experienced any staff additions or changes since the last run of the Directory Export Wizard, we perform two updating tasks before the next run of the Data Migration Wizard:
• Re-run the Directory Export Wizard, to update the database.
• Re-run CMN’s Directory Connector to re-update the Notes and Exchange directories.
When the collection is ready, we run the Data Migration Wizard to perform these tasks for the users defined in the current collection:
• Mailbox-enable the previously mail-enabled Exchange accounts (effectively creating the users' Exchange mailboxes).
• Set mail-forwarding rules for the migrating users, from their old Notes mailboxes to their new mailboxes on the Exchange server.
• Migrate user data from Notes to the Exchange environment.
Notes Migrator for Exchange copies data from Notes as Unicode and inserts it into Exchange as Unicode. Any data that has a specific character set (MIME data) in the Notes source will retain that character set after migration; the migration features do not convert MIME data into Unicode.
If the Data Migration Wizard migrates any data to Outlook Personal Folder (.pst) files, then when the migration is complete we must either:
• Notify users of the locations of their new.pst files (so each user can specify the location within his or her own desktop copy of Outlook).
– OR –• Distribute the newly created .pst files to users' desktops.
This process, beginning with the re-run of CMN’s Directory Connector (if necessary), is repeated for each collection of migrating users.
Post-Migration CleanupAfter the last user has migrated to the new Exchange server, we verify that the old Domino server is no longer processing any mail traffic, and then delete the temporary migrate.domain.com domain and decommission the Domino server.
18
Quick-Start Guide
GlossaryAccess Control List (ACL)
A list that identifies the owner(s) of a particular file, and that defines which users have which privileges (viewing, editing, deleting) for the file.
ACLSee Access Control List.
ArchivesFiles that contain users’ personal mail and calendar data, stored in per-user files. A user can conserve server space and remain within his/her quota for server storage by transferring data from the server to personal archives, typically stored on each user’s own local workstation. (Compare to Server-based data.)
Batch migrationA process of migrating data from one server/client environment to another, for multiple users (a "batch") in a single program run. (Compare to Per-desktop migration.) Notes Migrator for Exchange contains a Data Migration Wizard that lets an administrator perform batch migrations.
CNSee Common name.
CoexistenceThe state of two independent mail or directory servers when both are serving the same organization at the same time. This is a common temporary condition during the transition period of a migration, when some users have already been migrated to a new server while other users remain on the old server, awaiting migration.
CollectionA defined group of users or groups—a subset of All Users or All Groups. The provisioning, migration, and other features of Notes Migrator for Exchange are applied to collections of users and groups, whose members are defined by the Collection Wizard.
Common name (CN)The identifying name assigned to a directory object. A common name must be unique within a context. (Compare to Distinguished name.)
ContactAn Active Directory object that represents a user outside the Exchange organization. For example, a contact may represent a not-yet-migrated user who still receives and sends email via the source server, or someone in another company with whom an Exchange user corresponds—a customer or a vendor, for example. A contact is associated only with an address, and has no Active Directory account.
DestinationThe server or environment to which data is migrated. In Notes Migrator for Exchange, Microsoft Exchange and Active Directory are the destinations of the migration process. (Synonymous with Target in this context.)
Distinguished name (DN)A name that uniquely identifies a directory object by defining the entire path between the object and the directory root. The DN includes the relative distinguished name for the object, plus the names of container objects and domains that contain the object, to specify both the object and its location in a tree. (Compare to Common name.)
19
Notes Migrator for Exchange
Distribution group, Distribution listA set of directory objects—users and/or resources—collectively defined as a group of message recipients. A single message can be "broadcast" to all members of a distribution group by specifying the single group as the recipient.
DNSee Distinguished Name.
DNSSee Domain Name System.
Domain Name System (DNS)A hierarchical, distributed database that maps domain names to various types of data, including IP addresses. Every node on the Internet is identified by a unique, numerical IP address of the form 255.255.255.255, and every IP address is associated with a single domain name. The DNS defines the associations of domain names to their corresponding IP addresses.
LabelA device for classifying and sorting collections, by alphanumeric strings that can be assigned to collections in the Collection Wizard that creates them. Typically labels are defined to characterize and group subsets of collections—for example, to sort collections by an organization’s administrative divisions, you could define labels for Engineering, IS, Marketing, R&D, Sales, and so forth. Or define labels for Atlanta, Chicago, Denver, Houston, Minneapolis, and so forth, to sort collections by the locations of an organization's satellite offices. Then throughout Notes Migration Manager you can sort lists and tables of collections by label, or can specify a particular label to filter a list or table of collections, to show only the collections that have been assigned that label.
Mail-enabledTrait of an Active Directory object whereby the object’s mail-address attributes (for an address outside the Exchange domain) reside in AD, so AD can forward the object’s mail to its other address. Note that no Exchange mailbox is associated with a merely mail-enabled object. (Compare to Mailbox-enabled.)
Mailbox-enabledTrait of an Active Directory object whereby an Exchange mailbox exists for the object, and the object’s incoming mail is routed to its Exchange mailbox. (Compare to Mail-enabled.)
Migration machineThe computer that will run the Quest migration software applications.
MX recordShort for Mail eXchange record, an entry in a domain name database that identifies the mail server responsible for handling emails for that domain name. More than one MX record can be entered for a single domain name using more than one mail server, so the MX records can be prioritized with numbers to indicate the order in which the mail servers should be used. This makes possible the designation of primary and backup mail servers.
Notes Migration ManagerThe main "hub" program of Quest Notes Migrator for Exchange, from which almost all of the product's features are configured, scheduled and run. The primary program features—directory data export, source data discovery and locating, object provisioning in AD, data migration, and so forth—are accomplished by separate subcomponent applications called Wizards, launched from various screens within the Notes Migration Manager. The Notes Migration Manager also provides other features to help in the planning, monitoring, and administration of a migration project.
20
Quick-Start Guide
OwnerFor any particular file, a user who has the most complete authority to view, modify and delete the file.
Per-desktop migrationA process of migrating data, from one server/client environment to another, for a single user per program run. (Compare to Batch migration.) Notes Migrator for Exchange contains a Self-Service Desktop Migrator component that performs per-desktop migrations.
Phased migrationA migration strategy in which date filters are used to migrate all but the most recent data first, while users continue to receive and send email from the source server, so that all users can then be migrated together, quickly, with the comparatively small volume of data that remains to be migrated.
Pilot migrationA partial migration with a portion of real data, in the real, live production environment, to assess the suitability of a Migration Plan before the first full production migration run.
ProvisioningPopulating a directory with objects (users, resources, and so forth), and the information that characterizes objects.
pst filesThe files in Microsoft Outlook, with a .pst extension, that contain users’ personal storage data — typically the form to which Notes archives are migrated.
Server-based dataEmail and calendar data that is stored on a central server. (Compare to Archives.)
Simple Mail Transfer Protocol (SMTP)The standard TCP/IP protocol that governs message transmission over the Internet, by addresses in the form [email protected]. SMTP is the default transport protocol for Microsoft Exchange.
SMTPSee Simple Mail Transfer Protocol.
SourceThe server or environment from which data is migrated. In Notes Migrator for Exchange, Lotus Notes and the Domino Directory are the sources of the migration process.
SynchronizationProcess of updating the contents of one directory to match the contents of another, comparable directory. If, for example, the source and target server directories of a migration will coexist for more than a day or two, most organizations will want to regularly synchronize the two.
TargetThe server or environment to which data is migrated. In Notes Migrator for Exchange, Microsoft Exchange and the Active Directory are the targets of the migration process. (Synonymous with Destination in this context.)
TaskA defined element of work to be performed (with respect to the migration process), or a specific combination of related work elements or functions, together with any pertinent parameters that dictate how certain functions should be performed or applied. For example, the Notes Migration Manager includes a Data Migration Wizard that can migrate data for the users in a particular user collection, and can also perform related administrative functions in Notes and
21
Notes Migrator for Exchange
Exchange. The Wizard can be told to mailbox-enable existing AD accounts, set and remove mail forwarding, and so forth. The complete set of "marching orders" for this Wizard, as they will be applied to a particular collection, is one task.
Test migrationA partial migration—either with a copy of real data in a separate test environment, or with dummy data in the real, live production environment—to assess the suitability of a Migration Plan before the first full production migration run.
tsv filesUnicode text data files, stored in a structured tab-separated-values (tsv) format that uses tab characters as field delimeters for data tables.
UNC PathA notation (UNC=Universal Naming Convention) to specify the absolute location of a resource (such as a directory or file), in this syntax: \\server\volume\dir\dir\...\directory.
WizardA specialized component application of Notes Migration Manager—specialized to perform a particular task such as exporting directory data or provisioning groups in AD, or to define and characterize a specialized task that can be run at another time. The Notes Migration Manager contains ten Wizards designed to perform or facilitate various steps or aspects of an overall migration process. All Notes Migration Manager Wizards define tasks, and all Wizards can also be told to perform their tasks right away, as soon as they are defined. Some Wizards can be told to schedule their tasks to run at a later time or date, or to run at a recurring series of dates and times.
22
Quick-Start Guide
About Quest SoftwareNow more than ever, organizations need to work smart and improve efficiency. Quest Software creates and supports smart systems management products—helping our customers solve everyday IT challenges faster and easier. Visit www.quest.com for more information.
Contacting Quest SoftwareMail Quest Software, Inc. Email [email protected]
5 Polaris WayAliso Viejo, CA 92656 Web site www.quest.comUSA
Please refer to our Web site for regional and international office information.
Quest Support
Quest Support is available to customers who have a trial version of a Quest product or who have purchased a Quest product and have a valid maintenance contract. Quest Support provides unlimited 24x7 access to SupportLink, our self-service portal. Visit SupportLink at http://support.quest.com.
From SupportLink, you can do the following:
• Retrieve thousands of solutions from our online Knowledgebase
• Download the latest releases and service packs
• Create, update and review Support cases
View the Global Support Guide for a detailed explanation of support programs, online services, contact information, policies and procedures. The guide is available at: http://support.quest.com.
Visit Our ZeroIMPACT Migration Online Community
The Quest ZeroIMPACT Migration Community is an interactive community dedicated to issues relating to:
• Migration of email, identity and applications to the Windows Exchange platform, either on-premises or hosted Exchange platforms like Office 365—including migrations from Exchange, GroupWise, and Notes.
• Active Directory migrations.
• Migrations from Notes application and Exchange public folders to Sharepoint.
• Coexistence strategies and tools.
The community is designed to foster collaboration between Quest Migration experts and users. This community is a place where you can:
• Learn about product releases and betas before anyone else.
• Get access to Quest product leaders and subject matter experts on migration and coexistence.
• Participate in discussion forums, share insights and ideas, and get common questions answered.
23
Notes Migrator for Exchange
You can browse around the forums and the library, but to take full advantage of the community, post new threads, respond to messages from others, rate our documents and downloads, you must become a registered member. If you already have a Quest account or are a member of another Quest community, simply log in. The Login and Register features are both available from links in the top-left corner of the page at Quest ZeroIMPACT Migration Community.
Other Quest CommunitiesQuest.com has a large and growing number of communities dedicated to specific products and technologies.
Visit these communities to get access to the expertise at Quest Software and take part in product development through discussion forums, polls, and product betas. Also find the latest product news and announcements, and browse a KnowledgeBase of general documentation, tips and tricks, product videos and tutorials.
24
