Show Contents / Index / Search

rxmigrate Command Line Utility - Migrate Settings

Use rxmigrate on Windows systems to migrate settings from legacy Reflection X versions (v. 13 or 14) or from Hummingbird Exceed products. As rxmigrate runs, it displays messages to the console. In addition a migration.log file is created in the logs folder (typically C:\Users\<user>\.attachmate\rx\logs\migration.log).

Note: Settings stored on your local system are migrated automatically the first time you run Reflection X Manager or Reflection X Manager for Domains. Even if you choose not to import the settings on first run, you can manually import the migrated settings later. Settings in a shared network location are not imported automatically. You can use rxmigrate to migrate these settings.

To convert legacy Reflection X settings:

rxmigrate [-a] [-c client1.rxc ...] [-s server1.rxs ...] [-k known_hosts ...] -o output.rxd

To convert Exceed settings:

rxmigrate -product Exceed [-a] [-c client1.xs ...] [-s ...] [-xc server1.xcfg...] -o output.rxd


The following command line shows the options used for a default migration of settings from Reflection X 14.0. It migrates all Reflection X client and server settings, and any known host keys used for Secure Shell connections. The output file is located in a migration folder in the Reflection X Advantage data folder.

rxmigrate -a -o "%userprofile%\.attachmate\rx\migration\Reflection X 14_0_1.rxd"

The following command converts all Reflection X client files (*.rxc) in the specified network share and saves them to the specified output file.

rxmigrate -c \\sharedsettings\attachmate\rx\*.rxc -o "c:\migrated settings\RXsettings.rxd"

The following command migrates all Exceed settings and saves them to the specified output file:

rxmigrate -product Exceed -a -o c:\migrate\Exceedsettings.rxd


Note: For options that specify filenames, wildcards are supported for file names but not for directory names.




(Optional) Specifies the product to be migrated. Valid values are Reflection and Exceed. If this option is omitted, the utility performs Reflection migration.


(Optional) Migrates all client and server settings found on the local machine. When no product is specified, this option converts all legacy Reflection X settings (including known hosts).


(Optional) Migrates the client settings from the specified client files (for example, client1.rxc client2.rxc).


(Optional) Migrates the server settings (Reflection X) or session settings (Exceed) from the specified server files (for example, server1.rxs server2.rxs).


(Optional) Migrates Exceed server settings from the specified server files.


(Optional) Migrates the hosts found in specified files (for example, known_hosts). This option applies to Reflection migration only.


(Required) Specifies the path and file name of the output file to create (for example, output.rxd). Use quotation marks if the path includes spaces.

Output files are Reflection X Advantage definition files (*.rxd).



Displays Reflection X Advantage version information.

-? or -help

Displays a summary of command line options.


Related Topics

Import a Definition

Upgrading from Reflection X version 13 or 14

Migrating Settings From Hummingbird Exceed

Feature Guide for Upgrading from Reflection X version 13 or 14