Microsoft KB Archive/835991

= How to use a SID mapping file with the ADMT tool to perform a resource domain migration to Windows Server 2003 =

Article ID: 835991

Article Last Modified on 11/2/2007

-

APPLIES TO


 * Microsoft Windows Server 2003, 64-Bit Datacenter Edition
 * Microsoft Windows Server 2003, Enterprise Edition (32-bit x86)
 * Microsoft Windows Server 2003, Standard Edition (32-bit x86)

-





INTRODUCTION
This article describes how to use a security identifier (SID) mapping file to perform a resource domain migration to Microsoft Windows Server 2003. Specifically, it describes how to generate a SID mapping file for security translations when the following conditions are true:
 * You have completed an account domain migration from a migration workstation where you have installed the Active Directory Migration Tool (ADMT).

Note The migration workstation in this scenario is a master workstation.
 * Your resource domain is across a wide area network (WAN) link, and you want to migrate this domain by using other workstations that are local to the resource domain.

When you perform a resource domain migration to Windows Server 2003, you must run the Security Translation Wizard to translate the security information about resources from the source domain to the target domain. If you must perform the migration from workstations other than the master workstation to correctly translate the security principals on various resources, you must either copy the Protar.mdb database from the master workstation to the alternative workstations or use a SID mapping file.



MORE INFORMATION
The Protar.mdb database resides in the installation folder of the ADMT tool. By default, this is the following folder:

C:\Program Files\Active Directory Migration Tool

This database contains a complete list of the migrated objects, including the source and the target SIDs of objects.

During the security translation process, the ADMT references the database to determine the security principals that must be modified. It is a best practice to perform the migration from a single workstation where the Active Directory Migration Tool (ADMT) is installed so that the program can access the Protar.mdb database.

However, if you must perform the migration from alternative workstations, make sure that you copy the Protar.mdb database from the master migration workstation to the alternative workstations. Additionally, if you copy the Protar.mdb database from the master workstation to the alternative workstations, make sure that you first follow these steps:
 * 1) Make sure that both the source and the target computers are running ADMT version 2.
 * 2) Back up the existing Protar.mdb database on the target workstations before you copy the master database.
 * 3) Copy the Protar.mdb database from the installation folder of the ADMT tool on the master workstation to the installation folder of the ADMT tool on the target workstations.

If WAN bandwidth limitations make it inconvenient to copy the database, you must generate a SID mapping file on the master migration workstation and then copy this to the alternative workstations. This SID mapping file is used by the Security Translation Wizard.

The SID mapping file is a comma separated values (CSV)-formatted file. In the SID mapping file, specify first the source SID and then the target SID, separating each SID value by a comma. If the account domains are accessible, you can specify the source and the target account names and then separate them by a comma instead of specifying the source and the target SIDs. To specify the account names, use the following format:

domain\account

For example, to generate a SID mapping file on the master migration workstation by using Microsoft Visual Basic Scripting Edition (VBScript), follow these steps:   Connect to the Protar.mdb database, and then retrieve the recordset: Set objConnection = CreateObject(&quot;ADODB.Connection&quot;) objConnection.Open &quot;Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\Program Files\Active Directory Migration Tool\Protar.mdb&quot; Set rs= CreateObject(&quot;ADODB.RecordSet&quot;) Set rs = objConnection.Execute (&quot;Select * FROM [MigratedObjects]&quot;) Note &quot;C:\Program Files\Active Directory Migration Tool\Protar.mdb&quot; represents the default path of the Protar database, and “rs” is the recordset. Also, the ADMT installation path can be determined by querying the HKEY_LOCAL_MACHINE\Software\Microsoft\ADMT\Directory registry subkey.   Create a new SID mapping file to write the contents of the recordset to: Set fso = CreateObject(&quot;Scripting.FileSystemObject&quot;) Set fo = fso.OpenTextFile(&quot;sidMapping.txt&quot;, 2, True) Note &quot;Sidmapping.txt&quot; is the file where the SID records will be written.   Move through the recordset, and then write the source SID and the target SID to the SID mapping file: Do while not rs.EOF fo.write rs(&quot;SourceDomainSid&quot;) & &quot;-&quot; & rs(&quot;SourceRid&quot;) & &quot;,&quot; & rs(&quot;TargetDomain&quot;) & &quot;\&quot; & rs(&quot;TargetSamName&quot;) & vbcrlf rs.MoveNext loop 

Now you can copy the SID mapping file, SidMapping.txt, to the alternative workstations and use it in the security translation process. 