Command line options
The following table describes the command options available through the BMC Remedy Migrator CLI. Many commands provide a choice of two formats: abbreviated (a dash and a single letter), or detailed (two dashes and a descriptive string).
Migration commands and options
Abbreviated | Detailed | Function |
-s | --source | The server or file serving as the source. |
-d | --destination | The server or file serving as the destination. |
-e | --sourceForm | For data migrations, the start of a data block that determines the data to be compared or migrated. |
-q | --qualification | A string that represents the qualification used to obtain the data. |
| --count | The maximum number of items retrieved in a migration. When this count is reached, no further comparisons or migrations take place. A count of zero is the same as having no limit. |
| --list | Specifies use of the List port on the source, if the source is a server. The port number is the List port. |
| --fast | Specifies the use of the Fast port on the destination, if the destination is a server. |
| --fieldid | The integer value that uniquely identifies a field. By default, the ID is 1 for the entry ID, but can be changed to some other unique value, which is usually associated with a unique index on the same field for the form being migrated. |
| --disable | Specifies whether related workflow should be disabled in the target form during a migration. |
| --fieldmap | The name of the file (.arm or .armx ) that contains field mappings, if field mapping is enabled for this data migration. |
-x | --package | If a package XML file is included in this migration, the name of the file. |
-u | --user | The user name required to log in to the server. The default user name is Demo for both source and destination. |
| --dst_user | The user name required, if any, for logging into the destination. If a user name is not specified with this command, BMC Remedy Migrator defaults to the -u or the --user command. |
-p | --password | The password required, if any, for logging into the server. The default is " " (no password) for both source and destination. If a password is not specified, the command is ignored. |
| --dst_password | The password required, if any, for logging into a destination server. BMC Remedy Migrator defaults to the -p or --password command if no password is specified for this command. |
-a | --authentication | The authentication, if any, used to log in to the server. The default is "" (no authentication). If no authentication is required, this command is not required. |
-t | --tccport | The TCP port number, if any, for connection to the AR System server. |
-r | --rcpport | The RCP port number, if any, used for connection to the AR System server. |
| --dst_tcpport | The TCP port number, if any, for connection to the destination server. |
| --dst_rcpport | The RCP port number, if any, used for connection to the destination server. |
| --layout | The format used for the generated log files. The options are:
|
| --level | The level of detail to be provided in generated log files. The options are:
|
| --logfile | The name of the log file generated if the specified layout is HTML or XML. Ignored for Simple layout type. |
-m | --migrate | Migrate all specified instructions from source to destination. |
-c | --compare | Compare all instructions specified between source and destination. With this command, you can specify what is to be compared with the following flags: -- different: items that are different -- same: items that are the same -- missing: items that are missing |
-g | --configure | The name of the configuration XML file used in the command. |
| --instruction | The name of the instruction XML file used in the command. |
| --xslt | The name of the XSLT transformer file used to transform Difference reports from .xml format to any format you specify (such as HTML). |
| --xsltx | The file extension to be applied to the transformed file. Defaults to '.html' if an extension is not specified. |
| --form --activelink --filter --escalation --activelinkguide --filterguide --association --application --packinglist --webservice --menu --dsomap --dsopool --flashboard --alarm --variable --image* --pluginmodeule --plugindefinition --metadata | The type of object to be migrated. To migrate objects of a specific type, enter the object type in the command line, followed by either two empty quotes ("") to migrate all objects of that type, or the act |