Previous Topic: VariablesNext Topic: Command Line Examples


Command Line Switches

The following list describes the command line switches, their syntax, and their rules for use:

/A[PPLY] <path and file name of the DNA File>

Defines the path and file name of the DNA file to be applied. The path and file name can include environment or DMM variables.

Required Switches: None.

Cannot Use with: /C or /D

/C[ONNECT] <computer name or IP address>

Connects the destination system to the source system for a real-time migration. Use the name or IP address of the source system to which you want to connect. /C can be used with the /S switch.

Required Switches: /T

Cannot Use with: /W, /A, or /D

/D[iskTo]D[isk] [OS Name][(OS Drive)] [Drive Map]

Specifies the operating system and drive map information for disk-to-disk migration.

OS Name

Represents the operating system installed on the slave disk. Supported OS Name constants are WIN7, WINVI, WINXP, WIN2K, or WIN2000.

OS Drive

Represents the mapped operating system drive of the slave disk when it (slave disk) is connected to the host computer. This mapped drive includes the same operating system that the user has passed as OS Name and intends to migrate. OS Drive must be used with supported OS Name constants

Drive Map

Represents the drive mapping information and is defined as "Host machine Drive":"Source machine Drive"; for example, P:C. You can also use a comma (,) to specify multiple drive maps; for example, P:C,Q:D,R:E.

Required Switches: /D (or /SE), /T

Cannot Use with: /A, /C, or /W

Examples

DesktopDNA /T C:\MyTemplate.dtf /D C:\MyDNA.dna /DD /M /X
DesktopDNA /T C:\MyTemplate.dtf /D C:\MyDNA.dna /DD WINXP /M /X
DesktopDNA /T C:\MyTemplate.dtf /D C:\MyDNA.dna /DD WINXP(P) /M /X
DesktopDNA /T C:\MyTemplate.dtf /D C:\MyDNA.dna /DD WINXP(P) P:C,Q:D,R:E /M /X
DesktopDNA /T C:\MyTemplate.dtf /D C:\MyDNA.dna /DD WINXP P:C,Q:D,R:E /M /X
/D[NA] <path and file name of the DNA file>

Defines the path and file name of the DNA file you want to create. The path and file name can include environment or DMM variables.

Optional Switches: None.

Required Switches: /T

Cannot Use with: /C, /R, or /W

/Disable <UI Element Name>

You can supply multiple /Disable commands. See Customizing the Wizard from the Command Line.

Required Switches: None.

Cannot Use with: None.

/En[crypt]

Encrypts the data stored in a DNA file (or Self-Extracting file) for the current deferred migration or the data transferred over the network during the current real-time migration.

Note: [Password] supplied with /s will be used to encrypt the DNA file (or Self-Extracting file) during a deferred migration. [Password] is not mandatory for a real-time migration. For FIPS-compliant encryption, use the /FO switch along with /FK for specifying the encryption key path.

Required Switches: /D, /W, or /C

Cannot Use with: /A

Note: Current migration takes union of the data protection level set in the options file and the command line arguments (/s and /en) supplied.

/I[gnore]F[ips]M[ode]

Ignores the FIPS mode of CA ITCM. If you have installed CA DMM to operate in FIPS-preferred mode, the FIPS mode of CA ITCM decides the FIPS mode of CA DMM. For example, if the FIPS mode of CA ITCM is FIPS-only, CA DMM will also operate in FIPS-only mode even if you have selected FIPS-preferred mode during CA DMM installation. Use this switch to ignore the FIPS mode of CA ITCM and operate CA DMM in FIPS-preferred mode. If you have installed CA DMM to operate in FIPS-only mode, it always operates in FIPS-only mode.

Cannot use with: /FO

/F[ips]O[nly]

Encrypts all the data using FIPS-compliant cryptography.

Required Switches: /EN

Optional Switches: /D, /W, /C

Cannot Use with: /S

/F[ips]K[ey] <key path>

Specifies the path where you want to store encryption key used for FIPS-compliant encryption.

Required Switches: /FO

Cannot use with: /S

/H[ELP] or /?

Displays the help text for the command line switches.

Optional Switches: None.

Required Switches: None.

Cannot Use with: None.

/L[AUNCH] <UI Element Name>

Defines the initial page for CA DMM to display when launched. See Customizing the Wizard from the Command Line.

Required Switches: None.

Cannot Use with: None.

/M[IGRATE]

Automatically starts the migration.

Required Switches: /C and /T, or /A, or /D and /T

Cannot Use with: /Q

/NoUser <Source> [<Modifier> <value>]*

Excludes users from the migration. Use the following modifiers:

Before <date>
After <date>
Orphan <true | false>.
(<date> is the localized short-form of date.)

Note: The user command line arguments have precedence over all other forms of user selection. You can use them multiple times on the same command line.

Required Switches: /C, /A, or /D. Also, /NoUser must appear with at least one /User argument.

Cannot Use with: None.

/O[PTIONS] <path and name of the DMM Options File to use>

Path and file name to the DMM Options file you want to use for the migration. The file path and name can contain environmental or DMM variables.

Required Switches: None.

Cannot Use with: None.

/Q[UIET]

Runs CA DMM in a quiet mode (no windows displayed) and automatically starts the migration, like the /M parameter.

Required Switches: /X, /R, or /UX

Cannot Use with: /M or /W

/R[EBOOT]

Restarts the system when the migration is complete.

Required Switches: /M or /Q

Cannot Use with: /D, /SE, /X, or /UX

/R[EVISION]D[ATE] "<localized short date format> [localized time format including AM/PM if specified]"

Restores a specific revision of a DNA file.

Required Switches: /M

Cannot Use with: /C, /D, /SE, /W

/S <password> or /PASSWORD <password>

Defines the password protection for the DNA or Self-Extracting file. A password must contain between five to twenty characters.

Note: When /S is used to create a backup of a DNA file, you can specify that you want to password-protect your DNA file by clicking Set Password on the Define Task page of the DMM Always Current Scheduler wizard. Then when the Windows Scheduler runs the task, the password is encrypted and your data is secure.

Required Switches: /D, /A, /C or /W

Cannot Use with: Must not be used if the password is supplied with /C or /W.

/SE <path and file name to create a self-extracting DNA file>

Defines the path and file name of the self-extracting DNA file you will create. The path and file name can include environment or DMM variables.

Required Switches: /T

Cannot Use with: /A, /C, /R, or /W

/T[EMPLATE] <path and file name of the DMM Template file to use>

Defines the path and file name of the template file to use for the migration. The path and file name can include environment or DMM variables.

Note: Multiple /T arguments can be used. The last template in the command line takes precedence if any discrepancies occur.

Required Switches: /C, /D, /A, or /SE

Cannot Use with: /W

/USER <source>[:<Destination>] [<Modifier> <value>]*

Selects and/or redirects users for migration. Use the following modifiers:

Before<date>
After<date>
Orphan <true | false>
<date> is the localized short-form of the date.)

The domain or active directory and the user name can contain wildcards and environment or DMM variables. The user command line, if passed overrides any user selections in the DMM Template Editor or the DMM user interface. /USER can appear multiple times on the same command line. For more details see User Command Line Details.

<source>

Allows partial wildcards, for example: "x*y?\username)

<destination>

Allows full wildcards only, for example: "domain\*)

Required Switches: /A, /C, or /D

Cannot Use with: <destination> is not valid with /D.

/UNDO <path and file name of the undo file>

Defines the path and file name of the undo file to use. The path and file name can include environment or DMM variables.

Required Switches: None.

Cannot Use with: None.

/UX

Defines an unconditional exit of CA DMM even if an error occurs.

Required Switches: /A, /M, or /Q

Cannot Use with: /X, /R, /W

/W[AIT]

Automatically starts as a source for a real-time migration and waits for the destination system to connect. If /S was used, the password for connecting the systems must be provided. (The password is optional.)

Required Switches: None.

Cannot Use with: /M, /D, /A, /V, /C, /UX, or /Q

/X or /EXIT

Exits CA DMM when the migration is complete unless an error occurs.

Required Switches: /M or /Q

Cannot Use with: /R, or /UX