Technical Notes

Removing Reflection software packages results in the loss of end-user settings for those components that store this information in the registry. This technical note describes how to save customized settings in Reflection before you uninstall, and how to restore your settings once you install Reflection 14.x.

For information about saving customized settings before installing Reflection evaluation software, see Technical Note 1601.

In this technical note:

Before You Uninstall Reflection

Reflection uses the Microsoft Windows Installer (MSI) technology. When you uninstall Reflection, any customized settings stored in the registry are removed. If you want to restore your customized settings, you must save them prior to uninstalling the product.

Backing Up the Windows Registry

Warning: Before you work with the Windows registry, you should back up the registry on your PC.

Use the Windows Registry Editor (Regedit.exe) or another full backup program to back up your Windows registry. For information about the Windows registry, see the Microsoft Knowledge Base Article 256986 at:

http://support.microsoft.com/default.aspx?scid=KB;en-us;256986

Saving and Restoring Your Customized Settings

The process of saving and restoring your customized settings is specific to each Reflection product.

Reflection for HP, UNIX, OpenVMS, and ReGIS Graphics

Most Reflection settings are stored in a settings file; however, some settings are stored in the registry. In addition to saving your Reflection settings files, you must manually save the registry-only settings to restore customized settings.

Saving Registry Settings

Follow the steps below to manually save the registry-only settings. These settings are needed to restore your Reflection installation

If upgrading from Reflection 14.x:

1. In Reflection, on the Setup menu, click View Settings.
2. Click the Advanced… button.
3. Click Registry settings.
4. View and write down the settings information in the Reflection Settings section of the dialog box.

If upgrading from an earlier version of Reflection:

1. In Reflection, on the Setup menu, click View Settings.
2. With the cursor in the Search text box, press [Alt]+[W].
3. In the Enter Password dialog box, type registry in lower case. Click OK.
4. In the Display Settings section of the dialog box, select the "Changed from factory defaults" option.
5. View the settings in the Reflection Settings section of the dialog box. These are the settings that you need to save. Write down the settings information; you will use this information to restore your Reflection installation.

Restoring Registry Settings

After you reinstall Reflection, you must manually restore the settings information in the registry. Use the View Settings dialog box to restore the settings values.

1. To open the View Settings dialog box, click View Settings on the Setup menu.
2. Type the values that you recorded in the preceding section to restore your Reflection settings.

Saving Reflection Secure Shell Settings

Reflection Secure Shell settings are stored in a file named config. A config file is created when a user changes a setting to a non-default value in the Reflection Secure Shell Settings dialog box and clicks OK. (To open Secure Shell Settings, click Connection > Connection Setup, enter a host name, and click the Security button.)

If you are upgrading from Reflection version 12.0 or earlier and using Reflection Secure Shell (SSH), make a copy of the config file before upgrading. (Typically, this file was located at C:\Documents and Settings\<username>\My Documents\Reflection\.ssh.)

Reflection for IBM

Reflection for IBM stores almost all settings files in the user's directory. These files will be accessible to the user after Reflection is reinstalled.

The only exception is SNA engine settings. If you have SNA settings, save the Windows\system32\Wrqsna.rlf file before you uninstall Reflection for IBM.

Reflection X

Be sure to review this entire Reflection X section before you uninstall and reinstall the product. Most Reflection X settings are stored in the registry. In addition to saving your Reflection X registry settings, you may also need to manually save some customized files to restore the customized settings.

Note: Before you begin, create a folder in which to save your customized Reflection X files, for example, C:\Rxcustom. You must save the files prior to uninstalling Reflection X.

Reflection X Folder Locations in Version 14.0 and Earlier

Beginning in Reflection version 14.0, certain folders are in different locations. If you are upgrading from an earlier version, Reflection continues to use the pre-14.0 folder locations. Use this list as a reference.

Installation Folder

Start Menu Folder

User Folder

Reflection X Template Folder

Saving Reflection X Registry Settings

Reflection X settings are stored in the registry. Use the Reflection X registry utility (Regconv.exe) to save Reflection X settings by converting them into an initialization (INI) file. You can also use the utility to convert INI files to registry entries.

Converting Reflection X Settings into an INI File

Follow these steps to convert Reflection X settings that are stored in the Windows registry into an INI file.

1. Run the Reflection X registry utility. Click Run on the Start menu, and type regconv. Click OK. You may need to enter the full path, C:\Program Files\ Attachmate\Reflection\Regconv.exe.
2. In the Reflection X Registry Utility window's left pane, navigate to the HKEY_CURRENT_USER\Software\WRQReflection\Rx\config folder.

3. In the Save to INI File dialog box, specify an initialization file and location in which to store the registry settings (for example, C:\Rxcustom\Reg_contents.ini). When you click Open, a confirmation dialog box opens:

Restoring Settings by Converting an INI File into Registry Keys

After you reinstall Reflection, you must manually restore the settings information in the registry by importing the INI file you created in the preceding section, for example, Reg_contents.ini. To import your settings, follow these steps:

1. Run the Reflection X registry utility. Click Run on the Start menu, and type regconv. Click OK. You may need to enter the full path, C:\Program Files\ Attachmate\Reflection\Regconv.exe.2. In the Reflection X Registry Utility window's left pane, navigate to the HKEY_CURRENT_USER\Software\WRQReflection\Rx\config folder.

3. Select the INI file you created in the previous section, for example, Reg_contents.ini, and click Open. Click Yes, and then click Yes again. Click OK.

Saving Custom Fonts

If extra fonts were added, save the fonts folders, including the Fonts.ali and Fonts.dir, to the RXCustom folder. After you reinstall Reflection move the fonts folders to Program Files\Reflection\X\Fonts.

Verify that the "Subdirectories and font servers" information is correct by clicking Fonts on the Settings menu in the Reflection X Manager.

Saving a Reflection X Profiled Version

If Reflection X was profiled, save the Rx.ini file to the Rxcustom folder. Once you reinstall Reflection 14.x, move the Rx.ini file to a folder of your choice. At run-time, Reflection X searches for the profile in the following order of precedence:

• Documents and Settings\All Users\Application Data\Attachmate\Reflection\X
• Documents and Settings\<user>\Application Data\Attachmate\Reflection\X
• <Reflection installation folder> (The default is C:\Program Files\Attachmate\Reflection)

Saving Additional Customized Reflection X Files

If any of the following files were customized, save them to the Rxcustom folder: Rwmrc<lang>.txt, Rgb.txt, Xhosts.txt, and Xrdb.txt.

After you reinstall Reflection X, move the files to the All Users\Templates\Attachmate \Reflection\X folder.

Saving Customized Keyboard Mapping Files

Save customized keyboard mapping files (*.kmp) to the Rxcustom folder. Once you reinstall Reflection, move the files to the All Users\Templates\Attachmate\Reflection\X folder..x). Saving Reflection Secure Shell Settings

Reflection Secure Shell settings are stored in a file named config. A config file is created when a user changes a setting to a non-default value in the Reflection Secure Shell Settings dialog box and clicks OK. (To open Secure Shell Settings, click Connection > Connection Setup, enter a host name, and click the Security button.)

Reflection FTP Client

The Reflection FTP Client automatically saves your custom FTP site and configuration settings in *.rfw settings files.

Note: Beginning in Reflection 13.0, FTP settings are saved in *.rfw settings files. ( In versions 12.0 and earlier, these settings are stored in the Windows registry.)

You can use the Saveftp utility to export the site and configuration information from your Windows registry. Save this information in a separate folder. Once you have installed Reflection, you can import the information to restore your custom settings.

Note: Reflection FTP client user names and passwords are exported along with the connection information. The passwords, however, are encoded in both the registry and the exported registry file.

Saving and Restoring the FTP Client 14.x Registry Settings

Follow these steps to save and restore your Reflection FTP 14.x settings.

Export the Settings

1. From the File menu, click Export FTP Settings.
2. Select the checkboxes for Application settings and User settings.

• Site Properties dialog box - User name and password
• Options dialog box, General tab - Anonymous password
• Custom rules created using the Directory Definition Wizard.

Import the Settings (after you install Reflection )

1. From the File menu click Import Settings...
2. Select the rftp.xml file created during the export operation and click Open.
3. Click Ok

Saving and Restoring Earlier Versions of Reflection FTP Client

Follow these steps for Reflection FTP Client versions prior to 14.x.

Export the FTP Client Registry Settings

Attachmate provides a utility named Saveftp.exe to export the registry settings for your Reflection FTP sessions. Follow the steps below to obtain and run the Saveftp utility. Note: You must have a zip utility to perform this process.

1. Download the file, Saveftp.zip, from the Attachmate Download Library to your PC.
2. Extract the file using your unzip utility.
3. Run Saveftp.exe. The Save Reflection FTP Settings dialog box opens.
4. In the Save As Version section, select the "9 and later" option. Select the Include User Settings check box, and then click Save.
5. In the Save As dialog box, select the folder in which you want to save the Ftpsettings.reg file. Ftpsettings.reg contains your FTP Client registry settings. Click Save, and then click OK.

Import the FTP Client Registry Settings

Follow the steps below to import the saved Ftpsettings.reg file to restore your installation.

Note: Before importing the settings, Reflection FTP Client must already be installed on the PC.

1. Close all open Reflection applications, and then open Windows Explorer. Navigate to the folder containing the Ftpsettings.reg file.

2. Double-click Ftpsettings.reg to import the registry settings.

Reflection for Secure IT Windows Client

In the Reflection for Secure IT Windows Client version 6.0 or higher, your Reflection and SSH settings are stored in the Reflection folder. These settings do not need to be saved separately before installing evaluation software.

For more information about these settings files, see the "New User Folder Location" section of Technical Note 2277. And for administrators who deploy system-wide settings, additional information about managing settings is available in Technical Note 1894.