MTK User Migration
Contents |
User Migration
This is the first step to doing everything, even if you just want to migrate email only. The toolkit needs to know where the users are before it can do anything. It does that by downloading user data into the .CSV files.
The Migration of users from eDirectory to Active Directory is limited to users found in eDirectory. External GroupWise users with no entry in eDirectory cannot be migrated.
This is a toolkit, every migration is different because the variables in going from one system to another are too complex to be certain each time. You will have to experiment to find the settings that make the migration do what your organization needs. So if you value your job, do not start by migrating the CEO, start with a few regular users until you get the results that meet your organization's needs, then do the executives.
Before you can do anything else you need to export the user data from eDirectory and GroupWise. Even if you have already created the users in Exchange this data is needed for the MTK to know where to migrate the mail and other items.
Directory Service
If you have eDirectory installed, you must export the eDirectory users, before the GroupWise users.
Export eDirectory Users
Export eDirectory users, if they do not exist in GroupWise.
There are users in eDirectory that are not in GroupWise and they will need to be exported so they can be created in Active Directory.
Directory Service | Export eDirectory Users to CSV file
- Click on the Export eDirectory Users to CSV File icon to open the tool.
- Press the Load Users button to have this tool download the eDirectory User list.
- Press the Export All button to save the data to a CSV file. Give it a name that included eDirectory, eDir, or some other way to know that this is the eDirectory data.
- Verify that all users that are to be migrated are in this file. You may need to add users from GroupWise using the Export GroupWise Users to CSV File tool under the GroupWise tab.
GroupWise
If you have users in GroupWise that do not exist in eDirectory or are using GroupWise 2014 or later, which does not require eDirectory, you will need to export these users.
GroupWise | Export GroupWise users to CSV File
- Click on the Export GroupWise users to CSV File icon to open the tool.
- Press the Load Users button to have this tool download the GroupWise User list.
- Press the Export All button to save the data to a CSV file. Give it a name that included GroupWise, GW, or some other way to know that this is the GroupWise data and save it in the same location as the eDirectory step above.
- Verify that all users that are to be migrated are in this file. You may need to add users from GroupWise using the Export GroupWise Users to CSV File tool under the GroupWise tab.
Merge eDirectory and GroupWise Users
If you have both eDirectory and GroupWise users they will need to be merged into a single CSV file. These will be all the users that will be created in Active Directory and Exchange.
GroupWise | Merge eDirectory and GroupWise Users
- Click on the Merge eDirectory and GroupWise Users icon to open the tool.
- Browse to the CSV files for eDirectory and GroupWise.
- Click on Merge to merge the two files together. Save the resulting file with a name that includes "merged" so you know this step is complete.
- Verify that all of the users are in this file that needs to be migrated.
Migrating Users
Now that the toolkit knows what users exist in eDirectory and GroupWise, the users can be created in Active Directory and Exchange, or Azure and Office365.
Prerequisites:
- Novell Configuration Settings
- Microsoft Configuration Settings
- Exported eDirectory, or Merged eDirectory and GroupWise user CSV file
Create Users in Active Directory
- Make a working copy of the CSV file.
- Verify that the eDirectory and GroupWise users.csv file contains the correct e-mail addresses, and GUIDs that will be migrated.
- The following columns must be filled in:
- cn Mandatory, User's Common Name in eDirectory or GroupWise
- firstName Mandatory, User's First Name
- lastName Mandatory, User's Last Name
- displayName Mandatory, User's Display Name
- destinationEmail Recommended, Destination email, set as UserPrincipleName in AD
- type Mandatory, This should be type User, not resource. Resources will be migrated in a later step, so remove them from this working copy of the CSV file.
Directory Service | Create Users in Active Directory from CSV File
- Click on the Create Users in Active Directory from CSV File icon to open the tool.
- Browse to the eDirectory, or Merged eDirectory and GroupWise user CSV file (The csv.data file will be filled in automatically.)
- Select one, some, or all users. If this is your first attempt at creating users, it is recommended to choose a single user to migrate to test if the results are what you anticipate. You can select a single user by clicking on the user's name.
- Press Start to begin the creation process.
Directory Services | Directory Users Matching
If you have a partially migrated system, use the Directory Users Matching toll first to match the names that are already created in Active Directory.
- Click on the Directory Users Matching icon to open the tool.
- Browse to the exported eDirectory CSV file, or merged GW eDirectory and users CSV file.
- Press Start Merging to merge previously migrated users into the CSV file.
- Press Done when complete.
The next step is depends on whether you are using On-Premise Exchange or Office365.
- If you are using On-Premise Exchange, you need to mail enable the users you migrated into Active Directory.
- If you are using Office365, you need to create the users and license them.
On-Premise Exchange
To complete the user migration process you will need mail enable the AD users so they have Exchange mailboxes, create distribution lists and migrate proxy rights for users that have rights to enter other users mailboxes.
Prerequisites:
- Microsoft .NET 4.6.1 or higher
- Windows Management Framework 3.0 or higher
- Remote Server Administration Tool (RSAT)
- Novell Configuration Settings
- Microsoft Configuration Settings
- Exported eDirectory, or Merged eDirectory and GroupWise user CSV file
Mail Enable Active Directory Users
- Make a working copy of the CSV file.
- Verify that the eDirectory and GroupWise users.csv file contains the correct e-mail addresses, and GUIDs that will be migrated.
- The following columns must be filled in:
- cn Mandatory, User's Common Name in eDirectory or GroupWise
- destinationEmail Mandatory, User's Destination Exchange email address in, set in ExternalEmailAddress in AD
- destinationDN Recommended, User's Destination Distinguished Name
- mailboxDB Recommended, User's mailbox database in Exchange. If not specified, Exchange will place in default location
- nicknames Optional, Nicknames/aliases/proxies of the user. This is the nicknames/aliases/proxy addresses of a user. The nickname values are separated with pipe character (|). For example: username|useralias|userproxy. Only username should be entered in CSV file (without @domain).
- destinationGUID Recommended, User's Object GUID in AD
- type Mandatory, This should be type User, not resource. Resources will be migrated in a later step, so remove them from this working copy of the CSV file.
Exchange | Mail Enable Active Directory Users
- Browse to the eDirectory, or Merged eDirectory and GroupWise user CSV file (The csv.data file will be filled in automatically.)
- Select one, some, or all users. If this is your first attempt at creating users, it is recommended to choose a single user to migrate to test if the results are what you anticipate. You can select a single user by clicking on the user's name.
- Press Start to begin the creation process. (If users are already Mail Enabled, the tool may throw a warning).
Office 365
Prerequisites:
- Microsoft .NET 4.6.1 or higher
- Windows Management Framework 3.0 or higher
- Microsoft Online Services Sign-In Assistant for IT Professionals
- Windows Azure AD Module for Windows PowerShell
- Novell Configuration Settings
- Microsoft Configuration Settings
- Exported eDirectory, or Merged eDirectory and GroupWise user CSV file
Create Users
- Make a working copy of the CSV file.
- Verify that the eDirectory and GroupWise users.csv file contains the correct e-mail addresses, and GUIDs that will be migrated.
- The following columns must be filled in:
- cn Mandatory, User's Common Name in eDirectory or GroupWise
- displayName Mandatory, User's Display Name
- destinationEmail Recommended, User's Destination email in O365
- usageLocation Mandatory, Two character country code (e.g. US, FR)
- type Mandatory, This should be type User, not resource. Resources will be migrated in a later step, so remove them from this working copy of the CSV file.
Office 365 | Create Users
- Browse to the eDirectory, or Merged eDirectory and GroupWise user CSV file (The csv.data file will be filled in automatically.)
- Select one, some, or all users. If this is your first attempt at creating users, it is recommended to choose a single user to migrate to test if the results are what you anticipate. You can select a single user by clicking on the user's name.
- Press Start to begin the creation process.
Office365 | License Users
You will need to enter the license for each user in the CSV file under the office365License column.
- Make a working copy of the CSV file.
- Verify that the eDirectory and GroupWise users.csv file contains the correct e-mail addresses, and GUIDs that will be migrated.
- The following columns must be filled in:
- cn Mandatory, User's Common Name in eDirectory or GroupWise
- office365License Mandatory, User's plan/license in O365
- type Mandatory, This should be type User, not resource. Resources will be migrated in a later step, so remove them from this working copy of the CSV file.
If you are unsure of what licenses are available to your users, press the License Information button to see what licenses O365 shows as available.
Once the license is entered for each user in the CSV you may continue.
- Browse to the eDirectory, or Merged eDirectory and GroupWise user CSV file (The csv.data file will be filled in automatically.)
- Select one, some, or all users. If this is your first attempt at creating users, it is recommended to choose a single user to migrate to test if the results are what you anticipate. You can select a single user by clicking on the user's name.
- Press Start to begin the creation process.
Return to Retain_Migration_Toolkit
