If you are upgrading from an earlier version of Reflection X Advantage (or any product that includes Reflection X Advantage as a feature), note the following:
You can run the new installer with an installed version in place. The earlier version is uninstalled as part of the installation process. If you are upgrading from Reflection X Advantage 5.1 or later, your existing settings are retained and used automatically after the upgrade. Your database files are migrated to the current version the first time Reflection X Advantage is started. If upgrading from Reflection X Advantage 5.0 or earlier, your settings are not automatically migrated. (See Migrating version 4.2 and earlier to 17.0 and higher and Migrating version 5.0 to 16.2 and higher). Regardless of which version you are upgrading from, Start Menu shortcuts are moved to a new Micro Focus Reflection folder.
Reflection X Advantage stores user data (including database files for the standalone X Manager and user log files) in a different location than that used prior to version 5.1. The data location used for the domain database has not changed.
If you install without uninstalling your prior version, Reflection X Advantage continues to store its data in the prior version's user data location.
NOTE:If the prior version is 5.0 or earlier, Reflection X Advantage doesn't automatically migrate settings.
If you uninstall the prior version before installing, Reflection X Advantage uses the current version's default database location. If the prior version is 5.0 or earlier, Reflection X Advantage doesn't automatically migrate settings. You must copy your settings from the prior version as described in Migrating version 5.0 to 16.2 and higher.
For details see Reflection X Advantage Data Files.
If you use the Remote Session Services feature to configure distributed sessions with the standalone X Manager, you must upgrade all components at the same time. This feature does not support mixed versions.
If you distribute sessions with the Management and Security Server Administrative Console, review the information in Managing Upgrades for Management and Security Server Sessions.
Reflection X Advantage 17.0 does not support eXist database migration. If you are migrating from version 4.2 or earlier to version 17.0 or higher, export the database file before you uninstall the 4.2 version as shown below.
Upgrade version 4.2 and earlier to version 17.0 or higher
Before uninstalling Reflection X Advantage version 4.2, export a 4.2 .rxd file.
See Export a Definition for information about exporting.
Uninstall version 4.2.
Install version 17.0 (or higher).
Start X Manager.
Import the 4.2 .rxd file into version 17.0 (or higher).
See Import a Definition for information about importing.
If you are migrating from version 5.0 to version 16.2 or higher, export the database file before you uninstall the 5.0 version as shown below.
Upgrade version 5.0 to version 16.2 or higher
Uninstall version 5.0.
Install version 16.2 (or higher).
Copy the %userprofile%\.attachmate\rx\db\* directory to %userprofile%\Documents\Micro Focus\Reflection\db\.
Start X Manager to upgrade the database.
Reflection X Advantage 17.0 domain components are not backwards compatible with version 16.2 and earlier domain components and certificates. When you upgrade from version 16.2, you’ll need to remove old certificates and reinstall the domain components as follows.
To upgrade domains from version 16.2 and earlier
Use rxsconfig to remove all nodes from the domain as shown in Remove a Domain Node.
Stop the Micro Focus Reflection X Service on the domain controller and on any domain nodes as shown in Start and Stop the Reflection X Service.
Delete the digital certificates (*.cer files) and private keys (files without file extensions that have the same base file names as the certificates) that identify the domain controller and all nodes on the domain. These files are located within the Reflection X Service conf directory of each domain machine. (See Reflection X Service configuration files and Upgrade Digital Certificates used by Reflection X Advantage Domains.)
CAUTION:Do not delete any of the XML files in the conf folder.
Install Reflection X Advantage 17.0 on all machines in the domain.
Use rxsconfig to rejoin the nodes as shown in Set Up Domain Nodes.
For version information, go to Help > About X Manager. The information displayed always shows the currently installed version. If you are connected to an older domain controller, the display also shows the current running version. On Windows, Reflection X Advantage is installed as a feature in Reflection Desktop installers, and this information is also included.