2.5.1 Upgrading from Earlier Versions of Reflection X Advantage

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.

Migrating version 4.2 and earlier to 17.0 and higher

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

  1. Before uninstalling Reflection X Advantage version 4.2, export a 4.2 .rxd file.

  2. Uninstall version 4.2.

  3. Install version 17.0 (or higher).

  4. StartĀ X Manager.

  5. Import the 4.2 .rxd fileĀ into version 17.0 (or higher).

Migrating version 5.0 to 16.2 and higher

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

  1. Uninstall version 5.0.

  2. Install version 16.2 (or higher).

  3. Copy the %userprofile%\.attachmate\rx\db\* directory to %userprofile%\Documents\Micro Focus\Reflection\db\.

  4. Start X Manager to upgrade the database.

Upgrading Reflection X Advantage domains

If you are upgrading from version 5.0 or later, you can upgrade domain components in stages:

  1. Upgrade all systems running X Manager for Domains and the X Administrative Console before you upgrade the domain controller. These components are backward compatible, not forward compatible.

    These components will be able to connect to your (older) domain controller and will run using the version that is running on that domain controller. This means that features or bug fixes in the newer version will not yet be available.

  2. Upgrade your domain controller and any configured domain nodes after all other computers in the domain have been upgraded.

    After the domain controller is upgraded, all domain components will run using the newer version; at this time the latest features and bug fixes become available to the upgraded systems running X Manager for Domains and the X Administrative Console.

Which Reflection X Advantage version am I running?

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.