Migration type

Defines the migration type to be performed.

CreateDNAFile

CreateSEFile

OpenDNAFile

NetworkSource

NetworkDestination

Required.

Note: When the Director Setup wizard configures a real-time migration, the destination migration type is left blank, and is configured to launch the Connect to Source system page. This lets the user select the correct IP address for the source computer.

Path and name of the DNA File(s)

Defines the naming conventions for DNA files, any DMM Variable, or AskUser variable (defined by the AskUser option).

Valid path and file name.

Environment and DMM variables are supported in the path and file names.

Required when the Operation option is set to CreateDNAFile, CreateSEFile, or OpenDNAFile.

Source System IP Address

Specifies the IP address of the source system. Use this field when running as a network destination.

Valid IP address.

Must be performing a real-time migration.

Path to the Desktop Migration Manager executable

Set this option with the path set to DesktopDNA.exe, either on a server, or where you want the executable to be installed on the workstations before a migration.

Valid path and file name for DesktopDNA.exe.

Environment and DMM variables are supported.

None.

Install Desktop Migration Manager on workstations

Set this option if you want to control what version is installed. You may want to set this to Always if you have different script directories to install.

Always (CA DMM is always installed, even if a new version is already installed on the workstation.

IfMissing (CA DMM is not installed if another version is already installed on the system.

DDNAInstaller

Path to the Desktop Migration Manager installer

Set this option if deploying CA DMM on the workstations before starting the migration.

Valid path and file name for CA DMM's installer. Environment and DMM variables are supported.

Dependent on the DDNA Install Script option. Required if you are installing CA DMM or any of its components on the workstations.

Path to the Desktop Migration Manager install script

Set this option if deploying CA DMM to workstations before migration.

Valid path and file name for the CA DMM Install Script. Environment and DMM variables are supported.

Required when the DDNA Installer option is specified.

Install only Desktop Migration Manager libraries

You might want to install these items if you do not have at least Internet Explorer 5.0 installed. Installing these libraries cause the computer to restart.

The next time the user logs in, the migration automatically starts. To prevent an automatic restart, set the DontRestartAtReboot option.

1 = True

0 = False

DDNAInstaller.

Path to the Desktop Migration Manager libraries installer

If this option is not specified and the workstation does not have the necessary libraries installed, DMM Director uses the library installer included in the migration directory: ..ddnarun\LibraryUpdate\LibraryUpdate.exe

Valid path and file name for the CA DMM Library installer. Environment and DMM variables are supported.

None.

Path to the Internet Explorer installer

If the computers do not have IE 5.x or higher already installed, you must specify the path to the Internet Explorer install files. You can define the path to the installer on your network, or copy the IEInstaller\IE5Setup.exe into the migration directory to the following path: \DirectorMigration\IEInstaller\IE5Setup.exe.

Valid path and file name for the IE installer. Environment and DMM variables are supported.

None.

Command line to install Internet Explorer

The following command line is an example: "ie5wzd/M:O/Q:C/S:""#e""/R:n\". This is the default install for IE and installs IE without Active Desktop.

The IE installer command line is documented in Microsoft’s knowledge base.

IEInstaller.

Minimum version of Internet Explorer

If the version specified (or a newer version) is not installed, DMM Director checks the IEInstall option to install IE. Changing this option lets you control what version of IE is required to perform a migration.

5.0.2314.1003 or 4.72.3110.0

IEInstaller.

Path to the template file(s)

The templates identified are used for the migrations.

This option sets the /T command line parameter.

Valid path and file name for the template file. Environment and DMM variables are supported in the path and file names.

Multiple template paths can be listed if separated by a single space character.

Required.

Prompt the user to enter information

This option, if set, requests information from the end user before starting a migration, and the option uses this information to set an environmental variable.

Enter the information you want the user to enter (for example, Enter your name and phone extension). This value can be any string including spaces and punctuation.

AskUserVariable

Variable for user entered information

An environmental variable is created and can be used in paths and other strings specified. The variable is expanded to contain the text entered by the end user.

Enter the name you want to give to the environmental variable (for example, Name_Phone).

AskUserDialog

Display warning messages during migration

If true, and CA DMM or DMM Director returns an error, a message regarding the error displays on the workstation.

1 = True

0 = False

None

Abort migration when an error occurs

If true, and CA DMM or DMM Director returns an error, the migration aborts and no further migrations are performed on that workstation (if multiple migrations were configured).

1 = True

0 = False

None.

Exit Desktop Migration Manager when migration completes

If true, CA DMM exits after the completion of the migration.

This option sets the /X command line parameter.

1 = True

0 = False

Do not use with the Exit When Done Always or the Reboot When Done option.

Always exit Desktop Migration Manager

If true, CA DMM unconditionally exits after the migration is complete. This option sets the /UX command line parameter.

1 = True

0 = False

Do not use with Exit When Done or Reboot When Done option.

Reboot when migration completes

If true, the workstation restarts on completion of the migration.

This option sets the /R command line parameter.

1 = True

0 = False

Do not use with the Exit When Done or Exit When Done Always option.

Delay rebooting

If this option is set, a dialog warns the user of the impending restart and lets the user cancel the restart.

Integer defining the number of seconds to delay prior to rebooting the computer.

None.

Prevent rebooting

It might be necessary to set this option if you are performing a double pass migration.

1 = True

0 = False

None.

Do not restart after reboot

DMM Director restarts the system after IE or the libraries are installed. The next time the user logs in, the migration automatically starts. This option prevents the automatic restart of the migration.

1 = True

0 = False

None.

Automatically start the migration

If true, the migration automatically starts on the workstation.

This option sets the /M command line parameter.

1 = True

0 = False

Must be used with the Template option (/T).

Run the migration in the background

If true, no user interface displays during the migration.

This option sets the /Q command line parameter.

1 = True

0 = False

Must be used with the Exit When Done or Reboot When Done options.

Disable user interface elements

The user interface element you have defined does not display on the workstation.

This option sets the /Disable command line parameter.

If you want to disable multiple pages in the user interface, enter each disable parameter in a comma-delimited list.

Refer to the Disabling User Interface Elements section of the help file.

Do not use with the Quiet option.

Start Desktop Migration Manager on this page

This is the page of the user interface that is displayed to the user when CA DMM is initiated.

This option sets the /L command line parameter.

Enter the page name, refer to the Disabling User Interface Elements section of the help file.

None.

Password protect the source workstation

This password is set on the source workstation, and entered on the destination workstation when the migration is performed.

This option sets the /Password command line parameter.

Enter the password you want to be assigned to this migration.

Can be used only when performing a network migration, using the NetworkSource operation option.

Path to the DMM Options file

The migration uses the options set in the specified options file with the options set in the Migration Options file. This option sets the /O command line parameter.

Enter the path and file name of the DNAOptions.dox file to use for the migration.

If any option is set in both the Migration file and Options file, the option in the Migration file takes precedence over the one in the Options file.

Save the temporary options file

Setting this option may be valuable when testing your automated process. If this option is not specified, the options file created is placed in the local temp folder.

Valid path and file name to save the migration options file. Environment and DMM variables are supported.

None.

Path to save Director log file

The DMM Director log file contains details about the automated migrations, including CA DMM and DMM Director return codes.

One log file is written for each migration, so you may want to name them using variables to avoid overwriting files.

Valid path and file name to save the DMM Director log file. Environment and DMM variables are supported.

None.

Director log level

This option sets the level of detail that is written and saved in the DMM Director log for each migration.

0 = Errors only

1 = Warnings and errors

2 = Information, warnings, and errors.

3 = Very detailed

None.

Prevent Desktop Migration Manager running for testing

Set this option if you are testing your automated process and do not want to actually perform any migrations. The command line that would have executed CA DMM and performed the migration is written to the Director log file if the log is set at least to a level 2.

1 = True

0 = False

None.

Time in seconds to display warning before DMM task begins

If not zero, the tasks wait and give the user a chance to cancel or reschedule the tasks to another time.

Any positive integer or zero.

Defaults to zero.

None.

Maximum scheduled DNA files in rotation

If set to 1, the exactly one file name is used for all revisions. Otherwise, rotated files are renamed automatically.

Any positive integer.

Default is empty.

None.

Maximum scheduled DNA revisions per file

Specifying a revision limit tells the scheduler when to start a new baseline DNA file for greater efficiency and smaller file size.

Any positive integer or zero to indicate that there is no limit to the number of revisions.

Defaults to zero.

None.

Schedule Dialog Title

When the message displays to the user indicating a task is going to start in X seconds, this is the title of the dialog displayed.

Text

Defaults to Scheduled DMM Task

Time in seconds to display warning before a CA DMM task begins, must be set to a positive integer.

Schedule Dialog Description

If you choose to display a warning message, this is the text that is displayed in the Scheduled DMM Task dialog.

You can customize this to communicate instructions or information to users.

Text

Defaults to:

A DMM store task has been scheduled for this time. You may reschedule or cancel this task. Any other DMM tasks scheduled for this time will be deferred until this task completes.

Time in seconds to display warning before a CA DMM task begins, must be set to a positive integer.

Schedule Dialog Countdown Text

Enter the comment you want to be displayed to users in the Scheduled DMM Task dialog.

Text

Defaults to: Seconds until store task begins

Time in seconds to display warning before a CA DMM task begins, must be set to a positive integer.

Schedule Dialog Schedule Button

This is the text of the button allowing users to re-schedule a onetime task if they cancel the current task.

Text

Defaults to: Schedule a one-time store task

Time in seconds to display warning before a CA DMM task begins, must be set to a positive integer.

Schedule Dialog Cancel Button

This is the text of the button allowing users to cancel the currently scheduled task.

Text

Defaults to Cancel this scheduled store task

Time in seconds to display warning before a CA DMM task begins, must be set to a positive integer.

Scheduler Executable

Enter the path to the DNA Scheduler.exe.

A valid path.

None.

Text that appears in the Preparing Migration dialog

This is the text that is displayed to users when the scheduled task launches and prepares to store the computers DNA.

Text

Defaults to: Director is preparing your migration.

None.