Technical Notes

Recommendations When Upgrading to Reflection 13.0
Technical Note 1855
Last Reviewed 31-May-2006
Applies To
Reflection for HP with NS/VT version 8.0 through 13.x
Reflection for UNIX and OpenVMS version 8.0 through 13.x
Reflection X version 8.0 through 13.x
Reflection for IBM version 8.0 through 13.x
Reflection for the Multi-Host Enterprise, Professional Edition version 9.0 Through 13.x
Reflection for the Multi-Host Enterprise, Standard Edition version 9.0 through 13.x
Summary

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

Note: For information about upgrading to NFS Client Version 13.x, see Technical Note 1846.

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 13.0

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

Warning: Before installing Reflection 13.0, note the following:

• Reflection version 13.0 uses 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 13.0. The Reflection installer automatically detects and upgrades earlier versions (8.0.2-12.x) to 13.0, even if Reflection is installed in a different location. The earlier version will be removed by the upgrade.
• Removing Reflection 13.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–12.x, you must save the Reflection 8.0–12.x settings and customizations prior to installing Reflection 13.0 or an evaluation copy of Reflection 13.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–12.x, you must uninstall Reflection 13.0 from the workstation and then reinstall Reflection 8.0–12.x. Reflection 8.0–12.x settings and customizations can be reapplied only if they were saved prior to the Reflection 13.0 upgrade.
• If you choose the "Typical" installation type during the 13.0 upgrade, the default features for these installation types will be applied rather than those features originally selected for Reflection 8.0–12.x. (The Reflection 8.0–12.x features will not be migrated to Reflection 13.0.)

Product Upgrades

Reflection version 13.0 upgrades the following Reflection product versions:

• A single Reflection 13.0 product upgrades the equivalent Reflection product, version 8.0 or higher. (For example, Reflection for HP with NS/VT 13.0 upgrades Reflection for HP with NS/VT 12.0.)
• A Reflection 13.0 product suite upgrades a single Reflection product, version 8.0 or higher. (For example, Reflection for the Multi-Host Enterprise 13.0 will upgrade Reflection for UNIX and OpenVMS 12.0 because the single product is included in the suite.)
• Reflection 13.0 upgrades an evaluation copy of Reflection 8.0 or higher.
• An evaluation copy of Reflection 13.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 13.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 13.0 support the following Microsoft operating systems:

Note: Reflection version 13.x no longer supports Windows NT, and 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 3.0

Beginning in Reflection 13.0, we recommend installing Microsoft Windows Installer (MSI) version 3.0.

Before the product installation begins, Reflection 13.0 will check the version of Windows Installer on the machine. If Reflection detects that MSI 2.0 is installed, you will be prompted to update Windows Installer. The update is an optional update; the default option is Skip.

If you choose to update to MSI 3.0, you may be prompted to restart your system to complete the MSI update. After rebooting, you must restart the Reflection installation process.

For more information about Reflection and MSI 3.x, see Technical Note 1851.

Note: Reflection 13.0 requires Windows Installer version 2.0 or higher and will install version 2.0 if an earlier version is found. This affects only installations on Windows 2000 Service Pack 2 or earlier operating systems.

Running Multiple Reflection Products

When installing multiple Reflection Windows-based products, utilities, or tools on the same machine you must:

• upgrade all Reflection products to the same version
• install each product to the same folder

Upgrade all Reflection products to the same version

When upgrading Reflection products, upgrade all of the products, utilities, and tools (including Reflection Administrator's Toolkit) to the same version.

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

If you do not upgrade all Reflection products on a single machine to version 13.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 12.0 and Reflection X version 12.0 are installed on a single machine and you upgrade only Reflection X to version 13.0, Reflection for HP will fail to run and the following error will be displayed:

The solution is to upgrade both products to version 13.0.

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

Install each product to the same folder

When installing multiple Reflection Windows-based products, install each product to the same folder. This ensures that shared files (such as DLLs and EXEs) will be registered to the same folder location in Windows registry.

Note: There are two exceptions to this rule, by default, Reflection for Secure IT and the Reflection Administrator's Toolkit are intentionally installed to different directories from the Reflection Windows-based products. Do not install either of these product to the same folder as the Reflection Windows-based products.

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 13.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 13.0, even if the user upgrades with a transform that specifies to not install the Reflection FTP feature in Reflection 13.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 or higher) 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

Starting in Reflection 11.0, Reflection security features are incorporated in the product. In Reflection 10.x, security features were provided as a separate component, Reflection Security Components, which is no longer available. If you require security features for Reflection 10.x, you must upgrade to a later version of Reflection.

Detecting Earlier Versions

Reflection 11.0 or higher detects 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 13.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) was 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 or higher is run after upgrading from Reflection X version 9.x, the installer may run briefly to complete the installation.

Obtaining HiT ODBC Drivers

Version 7.0 of the HiT drivers is available. These ODBC drivers were not included in Reflection for IBM version 13.0 but are available to customers licensed for version 13.0. If you would like to obtain HiT version 7.0 drivers, please contact Attachmate technical support, http://support.attachmate.com/contact/.

Start Menu Shortcut Folder Name

If you are upgrading to Reflection 12.0 or higher, 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 or higher 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.

Related Technical Notes

1554	Reflection LPR: Status and Alternatives
1607	Saving Customized Settings Before Uninstalling Reflection 9.0 or Higher
1692	How to Upgrade a Workstation Installation to Reflection 10.0 or Higher
1693	How to Upgrade an Administrative Installation to Reflection 10.0 through 14.x
1748	Reflection Virtual Desktop: Status and Alternatives
1846	Upgrading to NFS Client Version 13.0 or Higher
1849	Features Introduced in Reflection 13.0
1851	Reflection Support for Microsoft Windows Installer Version 3.x
1869	Reflection Patch 13.0.6: Fixes, Features, and File Download
1896	New Features in Reflection 14.0
1952	Recommendations When Upgrading to Reflection 14.0