Chat now with support
Chat with Support

Migration Manager for AD 8.15 - User Guide

Configuring User and Group Renaming

You have the option of renaming users and groups as part of the migration. This includes merging multiple source users or groups into a single target user or group.

Renaming of objects is performed using a specially formatted plain-text file, which should be imported on the Select Objects in Source Domain step of the Migration Wizard (see the Creating a Migration Session procedure).

All entries in the file should be tab-separated. The header is mandatory and should contain at least these two entries (note that the white space is a tab character):

SAMAccountName SAMAccountName

One object per line should be specified. Here is a sample import file:

SAMAccountName SAMAccountName

sourceuser01 targetuser1

sourceuser02 targetuser2

sourceuser03 targetuser3

sourceuser04 targetuser4


  • If you are using this file to create a new user account and there is already a target domain user with the same name as the source user, the file above will not work. It is absolutely necessary to add at least the name attribute; then the file should look like this:

SAMAccountName SAMAccountName name

sourceuser01 targetuser01 targetuser1

  • If object names contain spaces, there is no need to use quotation marks (spaces are not treated as delimiters). For example, to rename the Executive Users group to Target Executive Users, use this syntax:

SAMAccountName SAMAccountName name

Executive Users Target Executive Users Target Executive Users

The same file format can be used to populate other target attributes; here is a syntax sample:

SAMAccountName SAMAccountName name displayname userprincipalname

sourceuser1 targetuser1 targetuser1 Target User1

sourceuser2 targetuser2 targetuser2 Target User2

sourceuser3 targetuser3 targetuser3 Target User3

The same import file can be used for merging with existing objects. When using such a file, you can merge two completely different accounts, for example Peter M. from the source domain can be merged with James T. from the target domain. The same applies to groups. In rare cases, the same approach is used to merge a built-in group with another (regular) group. When merging users or groups using sAMAccountName<tab>sAMAccountName, make sure that matching by sAMAccountName is enabled in the domain pair properties; otherwise DSA will attempt to create a new user with the same sAMAccountName and post a conflict instead of doing a merge.

Caution: The CN attribute cannot be changed using the CN as syntax. In order to modify the CN value, the Name attribute must be used. This will change the CN name on target.

Finally, note the following specifics:

  • The maximum user or group name in the file is 64 characters. If this number is exceeded, you will receive an error message during the migration. Here is a sample log entry of the error:

LDAP error 0x13. Constraint Violation (00002082: AtrErr: DSID-03050B04, #1:0: 00002082: DSID-03050B04, problem 1005 (CONSTRAINT_ATT_TYPE, data 0, Att 3 (cn):len 130).

  • Import files work only for migration and are not applicable to synchronization.
  • If synchronization is turned on and the attributes being changed during migration are not excluded, synchronization will overwrite the changes.
  • When you migrate accounts using an import file, they will always be migrated as a flat list to the location you specify during the migration session no matter what is specified by the migration session settings. If you want to retain the OU structure of source domain for the listed objects, one possible option is to migrate the objects normally first, then rename them later using the import file and a merging migration session. When performing this, make sure the Merge and leave the account where it was before the migration option is selected.

Delegating Account Migration

If you want to re-assign the directory migration task to some other person without revealing key credentials (like administrative accounts and passwords to access source and target domains), you can delegate migration to that person and even limit the scope of the delegated migration to certain organizational units (OUs) belonging to the source and target domains.

The results and status information on the delegated migrations will be added to the project, so no matter how many delegated administrators are involved, you can keep track of the overall project.

Since the delegated administrators get access to only the tasks to which you grant them access, you can be sure that they do not interfere with other tasks.

A person to whom the migration task is delegated is called a Migration Admin. This person will be able to create migration sessions using the Migration Wizard. However, the objects available for migration will be limited to the scope you specified when you delegated the task. The Migration Admin to whom the task was delegated will not be able to select the agent to perform migration or the custom add-in to process the objects being migrated.

To delegate a migration task, right-click the domain pair node and select New Delegated Migration from the shortcut menu. The New Delegated Migration Wizard will help you delegate a part of migration to another person.

Step 1. New Delegated Migration

Specify a name for the delegated migration and enter comments.

Step 2. Restrict Source Migration Scope

This step allows you to select the OUs from which the objects can be migrated within the delegated migration scope.

Step 3. Restrict Target Migration Scope

This step allows you to select the OUs to which the objects can be migrated within the delegated migration scope.

Step 4. Select Migration Agent

A person to whom the migration task is delegated will be able neither to install the Directory Synchronization Agent nor to select the agent’s instance for performing migration. Therefore, in this step you should select the instance of the Directory Synchronization Agent which will perform the delegated migration.

NOTE: If you have only one agent installed in your environment, you will not be presented with this step.

Step 5. Specify the Object Processing Custom Add-in File

A person to whom the migration task is delegated will not be able to select a custom add-in file for processing objects being migrated. Therefore, on this step you should select the custom add-in file if the migrated objects should be processed with the script before copying to the target server. Select the Use custom add-in checkbox and browse for the .xml custom add-in file.

Step 6. Delegate the Migration

This step allows you to assign the Migration Admin role to the account you select. The Migration Admin will be able to create migration sessions and make migration settings within the scope you just selected.

Step 7. Complete the Wizard

The wizard displays the delegation settings you made.

Undo Account Migration

You can roll back the changes made to the target directory by each migration session independently.

All the changes made to the target domain by the session will be rolled back exactly to the state before the session started. The following example illustrates this behavior:

  1. Suppose that during migration session 1, you migrated a number of objects from the source domain and specified to merge them with the existing target objects and move them to organizational unit A on the target.
  2. Then during migration session 2, you re-migrated the same set of objects and specified to merge them with the existing objects in the target and move them to target organizational unit B.
  3. If you undo migration session 2, the target objects that were merged with the source objects will be moved back to organizational unit A, not to their original location as it was before migration session 1.

In other words, when you undo a session, only changes made by that session are rolled back. Another example of such behavior is the following:

  1. Assume a user object was migrated to the target three times in three different sessions. In the last session the Reconnect Exchange mailbox option was selected to reconnect the Exchange mailbox from the source to the target user account.
  2. If you undo the first or second session for the migrated user, the mailbox will not be reconnected back to the source account.


  • Account passwords changed during a migration session cannot be rolled back.
  • If you migrated an object to the target domain during a migration session and after that deleted the object along with the container where that object was stored in the source domain, then the object will not be restored in the source domain if you undo the migration session.

To undo the results of a migration session, select the Migration node in the migration project tree, right-click the session displayed in the right-hand pane and select Undo from the shortcut menu. The Undo Wizard will start.

Step 1. Select Objects to Revert the Changes for

This step allows you to select the objects for which the migration should be undone.

To select the objects, you can either click Select all or select particular objects by selecting the check boxes next to those objects. Click Set filter to specify the object classes for which you want to undo changes. All object classes are selected by default.

Step 2. Reverting Migration Changes

The wizard now removes the migrated objects you selected from the target domain and reverts changes made during the migration session. Wait while the wizard completes.

NOTE: If the source object was merged with the existing target object during migration, the target object will not be deleted from the target directory during the undo. All changes made to the target object during the merge operation (including moving to another organizational unit and changing attribute values) will be rolled back to the state the object had before the migration and merge.

If errors occurred during the rollback process, you can view more detailed information by clicking View log and inspecting the log file for the failed objects.

Directory Synchronization

Before you start your migration, you should create the domain pairs that will be involved in the migration or synchronization process. Refer to the Creating a Domain Pair topic for more details.

If only Active Directory objects are being migrated from one forest to another, then directory synchronization is recommended but not required. If inter-org Exchange messaging system migration is performed, then directory synchronization is mandatory.

Since large migration projects can last for a long time, there is a period when the source and target environments have to coexist and be kept in sync. Migration Manager not only allows you to migrate accounts, but also to continuously synchronize these accounts and groups.

Considerations for Directory Synchronization

  • If your migration scenario includes Microsoft Exchange messaging system migration, it is recommended that you set the directory synchronization to create and synchronize objects for which no match can be found in the target directory. This allows you to maintain a unified global address list (GAL) for source and target Exchange organizations, which is important for Exchange migration. See the Migration Manager for Exchange User Guide for more details.
  • If you want to use Migration Manager to implement Exchange Resource Forest, configure the Directory Synchronization Agent to create disabled and mailbox-enabled accounts in the target domain. In this case, the Directory Synchronization Agent will automatically add the Associated External Account (msExchMasterAccountSID) attribute to the target accounts. This will let users who still log on to the source domain access mailboxes in the target domain.
  • Ongoing synchronization brings over the changes detected in the directory after its last run.

Full re-synchronization deletes the last state information and resynchronizes the directories. It overwrites single-valued attributes and merges multi-valued attributes. For example, if a group has member User1 on the source and the corresponding group has User2 on the target, after you re-sync from source to target the target group will have both User1 and User2.

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating