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 session1.ses ...] [-xc server1.xcfg...] -o output.rxd

Examples

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

Options

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

Option

Description

-product

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

-a

(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).

-c

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

-s

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

-xc

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

-k

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

-o

(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).

 

-version

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