Technical Notes

This technical note describes recommendations to consider when upgrading to Reflection 12.0.

New Release Available Now

Reflection 14.0 is available beginning in June 2006.

• For a list of what's new in Reflection 14.0, see Technical Note 1896. For information about upgrading to Reflection 14.0, see Technical Note 1952.
• For information about purchasing Reflection, please e-mail us: SalesRecept@attachmate.com or visit http://www.attachmate.com/How+To+Buy/.

This technical note addresses the following topics:

Before You Upgrade to Reflection 12.0

Carefully review the warnings in this section before upgrading your current version of Reflection to version 12.0.

Warning: Before installing Reflection 12.0, note the following:

• Reflection version 12.0 utilizes the Microsoft Windows Installer (MSI) technology, which detects and automatically upgrades earlier versions of Reflection (listed in the Applies To section above) that were deployed using MSI. During an upgrade, MSI migrates the features and registry settings of the earlier version and removes all files installed by the earlier version of Reflection.
• You cannot retain an earlier version of Reflection when you install Reflection 12.0. The Reflection installer automatically detects and upgrades earlier versions (8.0.2-11.x) to 12.0, even if Reflection is installed in a different location. The earlier version will be removed by the upgrade.
• Removing Reflection 12.0 will not restore the previous version.
• Reflection version 11.0 or higher includes Reflection security features (called Reflection Security Components in versions earlier than 11.0) as part of the product. Reflection 11.0 or higher detects and upgrades earlier Reflection Security Components versions. Earlier versions of the Reflection Security Components will be removed from the Add/Remove programs list.
• If you plan to return to a custom installation of Reflection 8.0–11.x, you must save the Reflection 8.0–11.x settings and customizations prior to installing Reflection 12.0 or an evaluation copy of Reflection 12.0. This is especially important for Reflection X and FTP users. For information about saving customized settings before uninstalling Reflection, see Technical Note 1607.
• To return to Reflection 8.0–11.x, you must uninstall Reflection 12.0 from the workstation and then reinstall Reflection 8.0–11.x. Reflection 8.0–11.x settings and customizations can be reapplied only if they were saved prior to the Reflection 12.0 upgrade.
• If you choose the "Typical" installation type during the 12.0 upgrade, the default features for these installation types will be applied rather than those features originally selected for Reflection 8.0–11.x. (The Reflection 8.0–11.x features will not be migrated to Reflection 12.0.)

Product Upgrades

Reflection version 12.0 upgrades the following Reflection product versions:

• A single Reflection 12.0 product upgrades the equivalent Reflection product, version 8.0 or higher. (For example, Reflection for HP with NS/VT 12.0 upgrades Reflection for HP with NS/VT 11.0.)
• A Reflection 12.0 product suite upgrades a single Reflection product, version 8.0 or higher. (For example, Reflection for the Multi-Host Enterprise 12.0 will upgrade Reflection for UNIX and OpenVMS 11.0 because the single product is included in the suite.)
• Reflection 12.0 upgrades an evaluation copy of Reflection 8.0 or higher.
• An evaluation copy of Reflection 12.0 upgrades an installation of Reflection 8.0 or higher.

Warning: If you plan to reinstall a custom installation of Reflection 8.0 or higher, you must save the Reflection settings and customizations prior to installing an evaluation copy of Reflection 12.0. This is especially important for Reflection X and FTP users. For information about saving customized settings before uninstalling Reflection, see Technical Note 1607.

Install and Deployment Issues

Consider these issues when installing and deploying a Reflection upgrade.

Supported Operating Systems

Reflection Windows-based products version 12.0 support the following Microsoft operating systems:

Note: Beginning with Reflection version 11.0, the Microsoft Windows 98 and ME operating systems are no longer supported.

Required Privileges

You must have Administrative Rights to install Reflection or have the elevated privileges policy enabled by a system administrator.

If you are logged onto a domain, you can install Reflection under any of the following conditions:

• You are a member of Domain Admins.
• The Group Policy, "Always install with elevated privileges," is enabled.
• The Reflection installer package has been "assigned" or "published" to you via Active Directory.

Microsoft Windows Installer (MSI) Version 2.0

Reflection 12.0 requires Microsoft Windows Installer version 2.0—the version that is included with Windows XP or Windows 2000 Service Pack 3. (Windows Installer version 2.0 includes several fixes to earlier versions of Windows Installer including the ability to apply a patch without requiring original source files.)

Before the product installation begins, Reflection 12.0 checks the version of Windows Installer on the machine. You will be prompted to update the service if it detects either of the following scenarios:

• Windows Installer is not installed on the machine.
• The current version of Windows Installer on the machine is not version 2.0 or higher.

If Reflection detects either of these scenarios, it displays the following prompt:

If you choose to continue, follow these steps:

1. Click Update. The Windows Installer installation package will update your system and you may be prompted to restart your system.
2. If prompted, restart your system.

3. After restarting the machine, you must also restart the Reflection installation process. You can restart the installation by double-clicking Install.exe on the product CD or the shortcut you originally used to start the installation. (Reflection 12.0 will not automatically restart the installation so that the installation of the Windows Installer can safely complete before the Reflection installer is run.)

Running Multiple Reflection Products

If you are running more than one Reflection Windows-based product on a single machine, you must upgrade all Reflection products (including Reflection Administrator's Toolkit) to the same version.

Reflection 12.0 detects that you have installed multiple Reflection products and displays the following warning when you upgrade one of the Reflection products to version 12.0:

If you do not upgrade all Reflection products on a single machine to version 12.0 at the same time, you will likely receive errors when attempting to run Reflection products that were not upgraded. For example, if Reflection for HP version 11.0 and Reflection X version 11.0 are installed on a single machine and you upgrade only Reflection X to version 12.0, Reflection for HP will fail to run and the following error will be displayed:

The solution is to upgrade both products to version 12.0.

Note: Attempting to install mixed versions of Reflection to a different location is not recommended and may also result in problems.

Reflection Administrator's Toolkit

Beginning in Reflection 10.0, the Reflection Deployment Manager and product profilers were moved to a standalone installation package called the Reflection Administrator's Toolkit. This keeps the administrative tools off the user's desktop and in the control of the system administrator working with Reflection.

• If you are upgrading from 10.0, you must upgrade the Reflection Administrator's Toolkit to 12.0 after you upgrade your Reflection product.
• If you are upgrading from 8.0-9.x and you have Reflection Deployment Manager or a product Profiler installed, these features will be removed when you upgrade to Reflection 11.0 or higher. To reinstall these features, install the Reflection Administrator's Toolkit after you upgrade your Reflection product.

The installer for the Reflection Administrator's Toolkit checks to see which Reflection products are on your computer and installs appropriate tools for those products.

Upgrade Feature Migration Versus Set Installation Options

Reflection Customization Manager (called Reflection Deployment Manager in version 11.0 or earlier) enables you to select which features to install using Set Installation Options. These selections are saved in a transform and are applied during the installation process. It is important to note that upgrade feature migration overrides the installation options set in a transform.

For example, if the Reflection FTP feature was installed in an earlier version of Reflection, Reflection FTP would be upgraded to 12.0, even if the user upgrades with a transform that specifies to not install the Reflection FTP feature in Reflection 12.0.

New or Modified Features

This section describes new features or feature modifications to be aware of when upgrading Reflection.

Note: Beginning in Reflection 10.0, the Reflection Deployment Manager (called Reflection Customization Manager in version 12.0) and product profilers have been moved to a new standalone installation package called the Reflection Administrator's Toolkit. For more information, see the Reflection Administrator's Toolkit section above.

Reflection Security Components

Beginning in version 11.0, Reflection includes Reflection security features (called Reflection Security Components in versions earlier than 11.0) as part of the product.

Detecting Earlier Versions

Reflection 11.0 or 12.0 detect earlier Reflection Security Components versions and upgrades them. Earlier versions of the Reflection Security Components will be removed from the Add/Remove Programs list.

By default, all Reflection Security Components are installed. The Kerberos Manager is the only security feature that can be turned off on the feature tree when installing Reflection version 11.0 or higher. If the Kerberos Manager was not installed with earlier Reflection Security Components versions (9.x or 10.x), then it will not be installed when upgrading.

In contrast, even if SSL/TLS, OpenSSH, or XDM Authorization for Reflection X were not installed in earlier Reflection Security Components, the features will be installed by default when upgrading to Reflection 11.0 or higher.

To Prevent Reflection Security Features Installation

If you do not want to install Reflection security features, you can configure Reflection by following these steps:

1. Open Reflection Deployment Manager (installed with the Reflection Administrator's Toolkit).
2. In the left pane, click Customize.
3. Click Open Installation. Browse to the installation you wish to customize and open it.
4. Click Set Installation Options.
5. Click the Application properties button.
6. Select the "Do not install security components" check box. Click OK to close the dialog boxes.

LPD/LPR

Reflection 12.0 detects earlier versions of Reflection LPD/LPR and upgrades LPD. Beginning in Reflection 11.0, the Reflection LPR utility is not available. For more information about the status of Reflection LPR, see Technical Note 1554.

Note the following:

• In 11.0, LPD (not LPR) is available in the Reflection installer. (LPD/LPR were previously available in the Reflection installer in Reflection 10.0, in a standalone installer in Reflection 9.0, and were not included in Reflection 8.0.)
• If you are upgrading from Reflection 9.x and you previously had LPD/LPR installed, the LPD/LPR entry in Add/Remove Programs will be removed.

Virtual Desktop

The Reflection Virtual Desktop (RVD) utility continues to be available for Microsoft Windows 2000 and Windows NT operating systems; however, as of version 11.0, RVD is not available for Windows XP. For more information about the status of Reflection Virtual Desktop and alternatives to RVD in Windows XP, see Technical Note 1748.

Version- or Product-Specific Issues

This section describes issues related to specific Reflection versions or products.

Repair on First Run of Reflection X

The first time Reflection X version 12.0 is run after upgrading from Reflection X version 9.x, the installer may run briefly to complete the installation.

Name Changes

Beginning in 10.0, within the Reflection product, the name "Reflection" was changed to "WRQ Reflection." This change affects the Start Menu shortcut folder name, title bar, and the product listing in Add/Remove Programs.

Start Menu Shortcut Folder Name

If you are upgrading to Reflection 12.0, the Start Menu shortcut folder name will not be modified. If you previously selected "Reflection" as the Start Menu shortcut folder name, the shortcut folder name will be grayed during the Reflection 12.0 installation and you will be unable to change it.

New installations of Reflection 12.0 on machines where Reflection has not been installed default to "WRQ Reflection." You can change this folder name by choosing a Custom installation and changing the shortcut folder title.

Title Bar Name

In settings files created in Reflection versions prior to 10.0, the Window title displays "<filename> - Reflection <product>." New settings files created in Reflection 10.0 or higher will display the Window title "<filename> - WRQ Reflection <product>."

Note: After you upgrade to Reflection 10.0 or higher, settings files that were created in earlier versions of Reflection for Windows and Reflection for IBM will display the same title as in the earlier version.

Add/Remove Programs

Beginning in Reflection 10.0, the product is listed in Add/Remove Programs under "WRQ Reflection" instead of "Reflection."

Upgrading Localized Versions of Reflection 8.x

Beginning in version 9.0, localized versions of Reflection are no longer separate products. Every Reflection product, version 9.0 or higher, includes localized product support.

Reflection 9.0 or higher defaults to the language of the operating system locale or to the language you select from the Reflection CD Setup panel. This is true for both new installations and upgrades.

To change the language for Reflection version 9.0 or higher, select "Change install language" in the Reflection CD Setup panel.

Different or additional languages can be selected during installation. On the Select Features panel, add the language(s) you would like to install.