Use rxmigrate on Windows systems to migrate settings from legacy Reflection X versions 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>\Documents\Micro Focus\Reflection\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
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%\Documents\Micro Focus\Reflection\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\rxa\*.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.
|
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 Definition files (*.rxd) contain Reflection X Advantage configuration information in XML format. This file format is used to export and import settings to and from Reflection X Advantage. (*.rxd). |
|
-version |
Displays Reflection X Advantage version information. |
|
-? or -help |
Displays a summary of command line options. |