Default language.

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:

  • 0: XML
  • 1: HTML
  • 2: Simple
  • 3: Console

 

--level

The level of detail to be provided in generated log files. The options are:

  • 0: Off
  • 1: Fatal
  • 2: Error
  • 3: Warning
  • 4: Information (default)
  • 5: Debug

 

--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

 

 

 

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

Remedy Action Request System 20.02