Performing migrations by using the CLI

The command-line interface (CLI) is a standalone application that delivers  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  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  () and  () support.  support enables application developers to supply a class name from which  can determine the required data and  objects that make up that class name. The  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  product at installation.

The  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  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  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  GUI.

This section contains information about: