Chat now with support
Chat with Support

Migration Manager for AD 8.14 - Resource Kit User Guide

Remarks

Remarks

The following problem arises if an account is used for purposes such as running a Windows 2000 service or scheduled task.

Conditions

SRC\User is the old account.

TARGET\User is the new account.

On workstation WST there is a service running under the SRC\User account.

TARGET\User logs on to WST and ChangeProfile.exe is executed.

Results

TARGET \User gets logged off by the utility and is assigned a new profile instead of the old one, and the procedure is cycled out.

Explanation

When TARGET \User logs on, Windows decides to use the profile of SRC\User. The procedure is unsuccessful because the profile is already in use by the service (the same thing will happen if RegLoadHive fails for any other reason). Windows decides to create and assign a new profile to the user.

Solution

  1. Set the TryToLoadProfile option to 1 in the parameter file. The program will abort with the ‘Cannot load profile’ error (see error codes).
  2. The program creates the registry value MiniProfileMigration (REG_DWORD) under the following path:

HKLM\Software\Microsoft\Windows NT\CurrentVersion\ProfileList\TextSID

where TextSID is the textual SID of the currently logged on user. This prevents the program from cycling.

RegWalker

When you collapse multiple domains or consolidate servers, a mass update of clients should take place to reflect name changes. The Windows operating system and third-party applications tend to store domain and server names in multiple locations in the registry database.

The RegWalker is an advanced tool that significantly reduces the cost of client update through the automation of mass-registry analysis and reconfiguration. Whether you change a server’s name, move data to a different file or application server, or migrate to a different domain, RegWalker significantly decreases total reconfiguration costs by ensuring zero end-user downtime during the transition.

The RegWalker is a command-line tool used to perform most of the typical operations with the registry on computers running Windows 9x/NT/2000/XP/2003 operating systems. Such operations include search and replace of text data, copying, moving and deleting of the registry keys and values, and registry keys and values text data output to the external file.

In Windows NT/2000, the operations that change the registry require a local administrator’s level of access. In Windows 9x, the operations on the registry are performed regardless of the user’s privileges.

Using RegWalker

Using RegWalker

RegWalker can be started from a command prompt or from user logon scripts, and the command line syntax and file path interpretation differs accordingly. You can use the migrated users map file generated by Migration Manager to automatically find corresponding source and target users regardless of the start mode you choose for RegWalker.

Command Prompt Start Mode

In command prompt start mode, RegWalker interprets the paths to the parameter file and other necessary, files as either relative or UNC paths. In this mode RegWalker can process remotely a number of specified computers.

To start RegWalker from the command prompt, use the following command:

RegWalker.exe Filename.ini

where Filename.ini is the full path to and the name of the parameter file.

Logon Script Start Mode

In logon script start mode, RegWalker interprets the paths to the parameter file and other necessary files as either relative to the domain controller the user logs on to or UNC paths.

To start RegWalker from a logon script, use the following command:

RegWalker.exe “[\\server_name\]share_name\Filename.ini” –s

where:

  • \\server name is an optional parameter. If \\server name is not specified, it is replaced with the name of the DC that the user logs on to.
  • Filename.ini is the parameter file.

Format of the RegWalker Parameter File

Format of the RegWalker Parameter File

[RegWalker]
DomainName = CDTEST
MapFile = vmover.ini
TaskFile = task.xml
OutputPath = Results
ComputerListFile = computers.lst
DateFormat = "yy '-'MMMM'-'dd"
TimeFormat = "h':'mm':'ss tt"
{User defined variable name}=user defined variable value

Explanation:

Parameter Description
DomainName Default domain name, which is used for processing computers running Windows 9x and for resolving the computer names if the domain name is not specified in the ComputerListFile parameter.
MapFile Full path and the name of the migrated users map file.
TaskFile Full path and the name of the task description file. This file is described in further detail below.
OutputPath Path to the folder where output and log files will be created. If this parameter is not specified, files are created in the folder where RegWalker is located.
ComputerListFile Full path and the name of a file with a list of users and computers for which registries will be processed remotely.
DateFormat The way the date will look in the output and log files.
TimeFormat The way the time will look in the output and log files.
{User defined variable name} The name and value of a user-defined variable.

Parameter File Example

In command prompt start mode, the only required parameter is the path to the task file. For logon script start mode, a path to the share for output files is also required:

[RegWalker]
TaskFile = task.xml
OutputPath = netlogon\Results

Date and Time Display Formats

A DTP format string consists of a series of elements that represent a particular piece of information and define its display format. The elements will be displayed in the order they appear in the format string.

Date and time format elements will be replaced by the actual date and time. They are defined by the following groups of characters:

Elemen Description
“d” The one- or two-digit day.
“dd” The two-digit day. Single-digit day values are preceded by a zero.
“ddd” The three-character weekday abbreviation.
“dddd” The full weekday name.
“h” The one- or two-digit hour in 12-hour format.
“hh” The two-digit hour in 12-hour format. Single-digit values are preceded by a zero.
“H’ The one- or two-digit hour in 24-hour format.
“HH” The two-digit hour in 24-hour format. Single-digit values are preceded by a zero.
“m” The one- or two-digit minute.
“mm” The two-digit minute. Single-digit values are preceded by a zero.
“M” The one- or two-digit month number.
“MM” The two-digit month number. Single-digit values are preceded by a zero.
“MMM” The three-character month abbreviation.
“MMMM” The full month name.
“t” The one-letter AM/PM abbreviation (for example, AM is displayed as “A”).
“tt” The two-letter AM/PM abbreviation (for example, AM is displayed as “AM”).
‘yy” The last two digits of the year (for example, 1996 would be displayed as “96”).
“yyyy” The full year (for example, 1996 would be displayed as “1996”).

To make the information more readable, you can add body text to the format string by enclosing it in single quotes. Spaces and punctuation marks do not need to be quoted.

NOTE: Characters other than those listed in the table above that are not delimited by single quotes will result in unpredictable display by the DTP control.

For example, to display the current date with the following format:

Today is: 04:22:31 Tuesday Dec 12, 2002

the format string is

'Today is: 'hh':'m':'s dddd MMM dd', 'yyyy

To include a single quote in your body text, use two consecutive single quotes. For example, suppose you want output that looks like the following :

Don't forget Dec 12, 2002

You would use the following format string:

'Don''t forget' MMM dd',' yyyy

It is not necessary to use quotes with the comma, so the following string is also valid and produces the same output:

'Don''t forget' MMM dd, yyyy

Related Documents