Migration of Workstations and Member Servers

  • Article

Applies To: Windows Server 2003, Windows Server 2003 R2, Windows Server 2003 with SP1, Windows Server 2003 with SP2

Migrate remaining workstations that you did not migrate during the user account migration process, along with member servers, in small batches of up to 100 computers. Workstation account and member server migration is a straightforward process. Workstations and member servers have their own SAM account database. When you move workstations and member servers between domains, the database moves along with them. Accounts located in the local SAM database (such as local groups) that are used to enable access to resources always move with the computer, and therefore do not need to be migrated. Because the migration requires that workstations and member servers restart, it is important to schedule the migration for a time when the server is not servicing requests.

Note

  • Use a low value in the ADMT computer restart option, to restart member servers immediately after joining them to the target domain, or as soon as possible thereafter. Resources that are not restarted following migration are in an indeterminate state.

You can migrate member servers by using the ADMT console, by using the ADMT command-line option, or by using a script.

To migrate workstations and member servers by using the ADMT console

  1. On the domain controller in the target domain on which you installed ADMT, log on by using the ADMT resource migration account.

  2. Open the Active Directory Migration Tool, and then select Computer Account Migration Wizard.

  3. Complete the Computer Account Migration Wizard by using the information in Table 11.32.

    Table 11.32   Using the Computer Account Migration Wizard to Migrate Workstations and Member Servers

    Wizard Page Action

    Test or Make Changes

    Click Migrate Now?

    Domain Selection

    In the Source domain box, type or select the name of the source domain.

    In the Target domain box, type or select the name of the target domain.

    Computer Selection

    Click Add.

    In the Select Computers dialog box, select the names of all of the workstations and member servers in the source domain that you want to migrate, click Add, and then click OK.

    Organizational Unit Selection

    Click Browse.

    In the Browsefor Container dialog box, locate the target domain Computers container, or the appropriate OU, and then click OK.

    Security Translation Options

    Click the Local groups check box.

    Click the User rights check box.

    Translate Objects

    Click Add.

    Computer Options

    In the Minutes before computer restart after wizard completion box, type 1.

    Naming Conflicts

    Click Ignore conflicting accounts and don’t migrate.

  4. When the wizard has finished running on all computers, click View Log and review the migration log and dispatch log for any errors.

  5. If errors are reported, run the Retry Wizard to dispatch agents to workstations and member servers for which the migration process failed.

  6. Open Active Directory Users and Computers and verify that the workstations and member servers exist in the appropriate OU in the target domain.

To migrate workstations and member servers by using the ADMT command-line option

  1. On the domain controller in the target domain on which ADMT installed, log on by using the ADMT resource migration account.

  2. At the command line, type:

    ADMT COMPUTER /N "computer_name1" "computer_name2" /SD:"source_domain" /TD:"target_domain" /TO:"target_OU" [parameters]

    You can append parameters to the command as follows:

    ADMT COMPUTER /N "computer_name1" "computer_name2" /SD:"source_domain" /TD:"target_domain" /TO:"target_OU" /RDL:1

    Alternatively, you can include parameters in an option file that is specified at the command line as follows:

    ADMT COMPUTER /N "computer_name1" "computer_name2" /O "option_file.txt"

    Table 11.33 lists the common parameters used for workstation and member server migration, along with the command-line parameter and option file equivalents.

    Table 11.33   Common Parameters Used for Workstation and Member Server Migrations

    Parameters Command-Line Syntax Option File Syntax

    Source domain

    /SD:"source_domain"

    SourceDomain="source_domain"

    Target domain

    /TD:"target_domain"

    TargetDomain="target_domain"

    Target OU location

    /TO:"target_OU"

    TargetOU="target_OU"
    • Restart computer one minute after wizard completes

    /RDL:1

    RestartDelay=1
    • Do not rename accounts

    /RO:DONT(default)

    RenameOption=DONT
    • Ignore conflicting accounts and do not migrate them

    /CO:IGNORE(default)

    ConflictOptions=IGNORE
    • Translate Option

    /TOT:ADD

    TranslateOption=YES
    • Translate User Rights

    /TUR:YES

    TranslateUserRights=YES
    • Translate Local Groups

    /TLG:YES

    TranslateLocalGroups=YES

  3. Review the results that are displayed on the screen for any errors.

  4. Open Active Directory Users and Computers and locate the target OU. Verify that the workstations and member servers exist in the target OU.

To migrate workstations and member servers by using a script

  • Prepare a script that incorporates ADMT commands and options for migrating workstations and member servers by using the sample script shown in Listing 11.14.

    Listing 11.14   Migrating Workstations or Member Servers Between Forests

    <Job id=" MigratingWorkstationsMemberServersBetweenForests" >
<Script language=" VBScript"  src=" AdmtConstants.vbs" />
<Script language=" VBScript" >
   Option Explicit

   Dim objMigration
   Dim objComputerMigration

   '
   'Create instance of ADMT migration objects.
   '

   Set objMigration = CreateObject(" ADMT.Migration" )
   Set objComputerMigration = objMigration.CreateComputerMigration

   '
   'Specify general migration options.
   '

   objMigration.SourceDomain = " source domain"
   objMigration.SourceOu = " Computers"
   objMigration.TargetDomain = " target domain"
   objMigration.TargetOu = " Computers"

   '
   'Specify computer migration specific options.
   '
   objComputerMigration.TranslationOption = admtTranslateAdd
   objComputerMigration.TranslateLocalGroups = True
   objComputerMigration.TranslateUserRights = True
   objComputerMigration.RestartDelay = 1

   '
   'Migrate computer objects on specified computer objects.
   '

   objComputerMigration.Migrate admtData, _
  Array(" computer name1" ," computer name2" )

   Set objComputerMigration = Nothing
   Set objMigration = Nothing
</Script>
</Job>

    For a script file to assist you in creating a script to migrate member servers, see "Migrating Workstations or Member Servers Between Forests" (DSSREER_14.wsf) on the Windows Server 2003 Deployment Kit companion CD (or see "Migrating Workstations or Member Servers Between Forests" on the Web at https://www.microsoft.com/reskit).