Migration type

What type of migration do you want to perform?

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)

How do you want to name and save, identify and apply, the DNA files?

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

What source system IP address do you want to connect to when performing a real-time migration?

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

How do you want to access CA DMM during the migrations?

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

How do you want CA DMM to be installed on your 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

Do you want DMM Director to install CA DMM on the workstations before initiating the migration?

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

Do you want DMM Director to install CA DMM on the workstations before initiating the migration?

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

Do you want to install only Internet Explorer and the CA DMM 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

Lets you specify a location for the CA DMM 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

Do you want to install Internet Explorer on the workstation before the migration?

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

What command line do you want the IE installer to use?

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

What version of IE must be located on the local workstation?

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)

Which templates should be used for the migrations?

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

Do you want to prompt the user for any information in order to create an environment variable?

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

What do you want to name the variable created by the AskUserDialog option?

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

Do you want error messages to display on the workstation during a 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

Do you want the migration to abort if an error is encountered?

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

Do you want CA DMM to exit when the migration is complete?

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

Do you want CA DMM to exit when the migration is complete regardless of any errors returned?

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

Do you want the workstation to restart when the migration is complete?

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

Do you want to delay the automatic restart of the workstation after migration?

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

Do you want to prevent a reboot of the workstation after any required installation or completion of migration?

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

Do you want to prevent the automatic start of the migration after the computer restarts and the user logs in?

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

Do you want Autorun.exe to automatically start the migration when it is initiated on the workstation?

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

Do you want the migration to run without displaying any user interface on the workstation?

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

Do you want to disable portions of the user interface to control user interaction with the migration?

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

Do you want CA DMM to start on a specific page when initiated on the workstation?

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

When performing a real-time migration over the network, do you want to password protect the connection to 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

Do you want a specific DNAOptions.dox file used for this migration?

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

Do you want to save the temporary DMM Options file created by DMM Director to perform the automated migrations?

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

Where do you want to save the log files created by DMM Director?

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

How much detail must be contained in the DMM Director log file?

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

Do you want to prevent CA DMM running during a test scenario?

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

How long do you want the warning dialog to display before the 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

How many .dna files do you want to keep on disk in the DMM rotation schedule before the oldest file is deleted?

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

How many DMM revisions do you want to keep in a .dna 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

What should be the title of the schedule countdown dialog?

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

What comment do you want to be displayed in the Scheduled DMM Task dialog?

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

What description text do you want to be displayed for the countdown?

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

What text do you want for the 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

What text do you want for the 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

What is the path to the executable launched when the Schedule button is clicked?

Enter the path to the DNA Scheduler.exe.

A valid path.

None.

Text that appears in the Preparing Migration dialog

What text do you want to display on 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.