Attachmate Worldwide  |   Contact Us  |   The Attachmate Group
Extend. Manage. Secure. More than 30 years in the business. Over 65,000 customers.

Technical Notes

Migrating Settings from Reflection for HP or Reflection for UNIX and OpenVMS to Reflection for the Web
Technical Note 1771
Last Reviewed 02-Jun-2011
Applies To
Reflection for the Web 2014 (All Editions)
Reflection for the Web 2011 (All Editions)
Reflection for the Web 2008 (All Editions)
Reflection for HP version 14.x
Reflection for UNIX and OpenVMS version 14.x
Summary

This technical note lists the steps to migrate settings to Reflection for the Web from Reflection for HP or Reflection for UNIX and OpenVMS.

Before You Begin

Before migrating settings to Reflection for the Web, consider the following limitations and options.

  • Reflection for HP and Reflection for UNIX and OpenVMS have many more settings than does Reflection for the Web. Because of this disparity, it is not possible to do a one-to-one migration.
  • Some features in Reflection for HP and Reflection for UNIX and OpenVMS are not supported in Reflection for the Web. Most notably, there are additional emulations supported in these products that are not supported in Reflection for the Web. There are also features such as VBA, toolbars, and menu mapping that have no equivalent feature in Reflection for the Web.
  • Due to variations in Java virtual machines (VMs), support for certain features may vary. For example, issues with mapping numeric keypad keys in Sun’s 1.3 VM have been eliminated in the Sun 1.4 VM.
  • Reflection for HP and Reflection for UNIX and OpenVMS migrate all possible settings, including default values, to Reflection for the Web settings. You also have the option to migrate only changed keyboard mapping settings to Reflection for the Web.

To migrate settings, you must first export settings from Reflection for HP or Reflection for UNIX and OpenVMS, and then import the settings into Reflection for the Web.

Exporting Settings from Reflection for HP or Reflection for UNIX and OpenVMS

There are several tasks to complete when exporting settings from Reflection for HP or Reflection for UNIX and OpenVMS to Reflection for the Web. The following sections list the steps for each task:

Task 1: Determine what is different in your settings file.

Task 2: Generate a report on the settings that can be exported to Reflection for the Web.

Task 3: Create the Reflection for Web configuration file.

Task 1: Determine what is different in your settings file.

Use the Export to XML feature to generate a report of what is changed in your settings file. The report will include information about every setting, including such items as toolbar changes, menu changes and registry settings that are not displayed in View Settings dialog box.

To generate an HTML report of your settings:

  1. On the File menu, click Import and Export > Export and Transform XML to open the Export and Transform XML dialog box.
  2. In the Source XML group box, select Changed Settings.
  3. Next to the Transform box, click Browse, select "Transform settings to HTML.xsl," and click Open.
  4. In the Results file box, type the name for this report. It is best not to include an extension in the name.
  5. If you would like to view this report when you create it, verify that the "Open results file" check box is selected.
  6. Click Transform. Your browser will now open with the information about what is changed in your settings file. Print the page for your future reference.

Task 2: Generate a report on the settings that can be exported to Reflection for the Web.

The Export to XML feature can also be used to generate a report of the Reflection for Windows settings that will be converted to Reflection for the Web configuration settings. The Reflection for Windows settings that can be converted to Reflection for the Web format include session/connection, terminal, properties, colors, and keyboard mappings. Reflection for the Web does not support hotspots in HP or VT emulation.

To generate this migration report:

  1. Open Reflection for HP or Reflection for UNIX and OpenVMS. On the File menu, click Import and Export > Export and Transform XML to open the Export and Transform XML dialog box.
  2. In the Source XML group box, select Current Settings.
  3. Next to the Transform box, click Browse, select the "Reflection for the Web Migration Report.xsl," and click Open.

Note: In the Japanese version, open the "Reflection for the Web Japanese Migration Report."

  1. In the Results file box, type the name for this report. It is best not to include an extension in the name.
  2. If you would like to view this report when you create it, verify that the "Open results file" check box is checked.
  3. Click Transform. Notepad will now open with the information about what settings will be migrated to Reflection for the Web.

Task 3: Create the Reflection for Web configuration file.

You can create a configuration file that migrates all possible settings to Reflection for the Web, or you can create a configuration file that migrates only keyboard mapping settings to Reflection for the Web. Once you decide, complete the steps in the appropriate section.

Migrate All Possible Settings

Follow the steps below to create a configuration file that migrates all possible settings. The location of this file and its extension are important for accessing it later in the Reflection for the Web Administrative WebStation.

  1. Open Reflection for HP or Reflection for UNIX and OpenVMS. On the File menu, click Import and Export > Export and Transform XML to open the Export and Transform XML dialog box.
  2. In the Source XML group box, select Current Settings.
  3. In the Transform group box, click Browse, select "Transform settings to Reflection for the Web.xsl," and click Open.
  4. In the Results files group box, enter the name for the exported file and use the extension *.config (for example, Ruo.config).
  5. Clear the check box to "Open results file."
  6. Click Transform. Note the file's location. If the Reflection management server (which includes Reflection for the Web Administrative WebStation) is installed on another machine, remember to manually copy the file to the machine where the Reflection management server is installed.

Migrate Only Keyboard Mapping Settings

Reflection for HP and Reflection for UNIX and OpenVMS also have the ability to generate a Reflection for the Web Keyboard Mapping Import file. This file enables you to migrate just the keyboard mapping values to Reflection for the Web. You can also migrate just the changed keyboard mapping values instead of all keyboard mapping values including default settings.

  1. On the File menu, click Export and Transform XML to open the Export and Transform XML dialog box.
  2. In the Source XML group box, select Current Settings if you want complete keyboard mapping including defaults, or select Changed Settings if you want just the changed from default keyboard mappings .
  3. In the Transform group box, click Browse, select the “Transform settings to Reflection for the Web.xsl,” and click Open.
  4. In the Results file group box, type the name to which you would like to save this XML file. Note the location so that you can browse to the location when you import the keyboard mapping into the Reflection for the Web Administrative WebStation.
  5. Clear the check box to "Open results file."
  6. In the Arguments box, type the following:
type=keymap
  1. Click Transform. Note the file’s location.
  2. Click Close.

Importing Settings into Reflection for the Web

The Session Manager in the Reflection for the Web Administrative WebStation enables you to create a Reflection session, launch it, and import a configuration file.

To create a Reflection for the Web session and import settings

  1. Log into the Reflection for the Web Administrative WebStation.
  2. In the left navigation bar, click Session Manager.
  3. Either add a new session or edit an existing one.

To add a new session: Click Add. On the Add New Session page, select the session type, and enter a name for the session. Click Continue.

To edit an existing session: Click the session name.

  1. On the Configure a Web-Based Reflection Session page, select a display option, and then click Launch.
    1. In the launched session, click Cancel to close the Connection Setup dialog box.
    2. To migrate all possible settings: Click Administration > Import Configuration.

To migrate only keyboard mapping settings: Click Administration > Import Keymap.

    1. Browse to the file you want to import and click Open.
    2. On the File menu, click Save and Exit. Click Save/Exit to save the changes and close the session.
  1. Open access Mapper and select the session you just added or edited, and click Save Settings.

You have completed the steps necessary to migrate your settings to Reflection for the Web.

Related Technical Notes
1782 Migrating Settings from Reflection for IBM to Reflection for the Web
9988 Reflection for the Web Technical Notes

horizontal line

Did this technical note answer your question?

           


Need further help? For technical support, please contact Support.