Performing migrations by using the CLI

The command-line interface (CLI) is a standalone application that delivers Migrator functionality without a graphical interface. You can use the command line to set migration options, migrate objects and data, compare information between migrations, and generate difference reports. In addition, you can use the CLI to compare information, including data and between migrations (which you cannot do with the graphic user interface).

The Migrator CLI can be useful when performance is critical for large migrations or when making a quick comparison of objects to determine what to include in a patch release. Because the CLI does not require a lengthy caching process, you can perform migrations or comparisons of large files more quickly.

The CLI also provides BMC Helix CMDB (CMDB) and BMC Helix ITSM support. CMDB support enables application developers to supply a class name from which Migrator can determine the required data and AR System objects that make up that class name. The BMC Helix ITSM mapping document includes support for mapping to an entry ID as a foreign key, and the ability to inject data during a migration.

The CLI application, migratorcli.exe, is stored in the same directory as the main Migrator product at installation.

The Migrator CLI currently supports a single-thread design, but you can supply multiple instructions within a single migration. The CLI provides full support for object reservation to ensure that Migrator either ignores newer or reserved objects on the destination, or blocks their update, depending on requirements.

Migrations using the CLI are executed in the same order as in the graphic user interface (GUI), using the same processes. Backups can be configured using the Configuration file. The Migrator CLI can generate both Differences and Results reports; however, Results reports are the only reports generated through the CLI that can be opened in the Migrator GUI.

Tip

Because the CLI does not use the Windows registry, any options you set through the GUI are ignored in the CLI.

The following topics describe the commands, files, and other options for performing migrations by using CLI:

Action

Reference














 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*