Changing the User Data Location when Upgrading to Extra! X-treme 9.x

  • 7021889
  • 09-Nov-2006
  • 31-Oct-2019

Environment

Extra! X-treme version 8.0 through 9.x
myEXTRA! Enterprise version 7.1 through 7.11
EXTRA! Enterprise 2000

Situation

Normally, when upgrading an existing installation of a previous version, the User Data Location (for user configuration files) is preserved. If you plan to change the User Data Location during setup, follow the instructions in this note to manually upgrade to Extra! X-treme 9.x from Extra! X-treme 8.x-9.x, MyExtra! Enterprise 7.1, or Extra! Enterprise 2000.

Resolution

Note: For information about upgrading from Extra! Personal Client 6.x (which did not use the Microsoft Windows Installer), see KB 7021890.

Understanding the User Data Location

The User Data Location is the folder that is used to store your users' session, scheme, and macro files (and their respective subdirectories). Extra! X-treme 9.x Setup offers the following options:

  • My Documents: Store user data files in a personal My Documents folder, typically C:\Documents and Settings\<username>\My Documents\Attachmate\Extra! where <username> is the user logged into Windows at install time.
  • Application: Store user data files in the application installation folder, typically C:\Program Files\Attachmate\Extra! (or C:\Program Files\Attachmate\E!E2K). Note: If you select this option on Windows Vista, running Extra! requires elevated or special permissions due to User Account Control (UAC) security.
  • All Users\Documents: Store user data files in the All Users\Documents folder for sharing by multiple users, typically C:\Documents and Settings\All Users\Documents\Attachmate\Extra!.
  • User-Defined: Store user data files in a different folder (entered at setup). To store data files in different folders based on the logged-in Windows user at runtime, see also KB 7024219.

Note: Beginning with version 9.4, new installations of Extra! use MicroFocus instead of Attachmate.

Should I Do a Manual Upgrade?

Determine whether you will perform an automatic or manual upgrade:

  1. Identify the location that is currently being used by your existing installation of Extra! X-treme 8.0, myEXTRA! Enterprise 7.1, or Extra! Enterprise 2000.
  2. Decide which location is appropriate in your environment for use with Extra! X-treme 9.x.
  3. If you will continue using the same User Data Location, you can do an upgrade by over-installing Extra! X-treme 9.x. Setup will automatically detect and upgrade the earlier version. This process will un-install the previous version of Extra! and, create a new installation with the existing directory, registry settings, and user configuration files.

If you plan to change the User Data Location, we recommend you follow the instructions in this note, which include manually uninstalling the earlier version of Extra! before installing Extra! X-treme 9.x.

Preparing for the Manual Upgrade

Please review the following suggestions and collect the information described in the steps below before you begin the manual upgrade process.

  1. Review the readme files and documentation to become familiar with the new features and any new configuration options of Extra! X-treme 9.x. Make sure the operating system and hardware are compatible with the new version of Extra! before proceeding.
  1. Create a "test" system that is non-critical to your daily work that can be used for testing the new version of Extra! to verify that it works properly before performing wide-scale upgrades. This test system is also good to have available during the initial deployment of the new version of Extra! if problems arise during the upgrade process.
  2. Identify and create secure backups of critical Extra! configuration files to carry forward. These include any files found in the Macros, Schemes, and Sessions subdirectories under the C:\Program Files\Attachmate\E!E2K or C:\Program Files\Attachmate\Extra! directory. Included with these will be the APPN Node configuration file called DEFAULT.XCP and the Security file called DEFAULT.ESF.
  3. You may want to capture screen shots of critical configuration panels or screens in the Extra! configuration that can be used for later reference during the Extra! 9 installation. Important screens include the Host Connection information and Global Preferences.

Note: If using the HLLAPI interface of Extra!, open the Global Preferences and record the HLLAPI Transport Type, HLLAPI Shortname Associations, and the HLLAPI Shortname information.

  1. Take a "snapshot" of the Attachmate registry settings. This snapshot can be used to determine any special settings that may have been in use with the earlier version of Extra! after that product is uninstalled.

Warning: These instructions should be carried out by a user with Administrative rights to the PC and who is familiar with registry manipulation tools. Proceed with extreme caution when editing the Windows Registry. Use Registry Editor at your own risk. For full details and warnings regarding editing the Windows Registry, see Microsoft Article 256986:

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

    1. Open Regedit.exe.
    2. In the left panel of the Registry Editor window, navigate to the following locations:
HKEY_LOCAL_MACHINE\SOFTWARE\Attachmate
HKEY_CURRENT_USER\SOFTWARE\Attachmate
    1. Export each selected branch to a Registry Hive file. Refer to the Microsoft Windows web site for detailed instructions about how to export a Registry Hive. This can be viewed as a text file if needed at a later date.

Performing the Manual Upgrade

After collecting the information in the Preparing for the Upgrade section above, follow these steps to manually upgrade to Extra X-treme 9.x:

  1. Uninstall the earlier version of Extra! using Add/Remove Programs in Control Panel. This will remove the Extra! program files from the C:\Program Files\Micro Focus\E!E2K or C:\Program Files\Attachmate\Extra! directory but will leave the customized user configuration files.
  2. Decide where the user configuration files will be located (refer to Understanding the User Data Location).
  3. Decide if you need to create an Administrative Install point with a customized Transform file (MST), or if the base product only can be installed. Review the product documentation and the Custom Installation Wizard documentation to determine what is appropriate for your environment.
  1. Install Extra! X-treme 9.x using the SETUP.EXE program or the MSI file and a Windows Installer msiexec command line.
  2. Copy existing user configuration files to the new user data location (as described in Understanding the User Data Location).

Examples (These examples assume the previous Extra! installation was to the Application directory.)

My Documents Directory Install:

Copy

C:\Program Files\Attachmate\E!E2K\Macros

to

C:\Documents and Settings\username\My Documents\Attachmate\Extra!\Macros

Copy

C:\Program Files\Attachmate\E!E2K\Schemes

to

C:\Documents and Settings\<username>\My Documents\Attachmate\Extra!\Schemes

Copy

C:\Program Files\Attachmate\E!E2K\Sessions

to

C:\Documents and Settings\<username>\My Documents\Attachmate\Extra!\Sessions

Application Directory Install:

Note: If you use this location on Windows Vista, running Extra! requires elevated or special permissions due to User Account Control (UAC) security.

Copy

C:\Program Files\Attachmate\E!E2K\Macros

to

C:\Program Files\Attachmate\Extra!\Macros

Copy

C:\Program Files\Attachmate\E!E2K\Schemes

to

C:\Program Files\Attachmate\Extra!\Schemes

Copy

C:\Program Files\Attachmate\E!E2K\Sessions

to

C:\Program Files\Attachmate\Extra!\Sessions

All Users Directory Install:

Copy

C:\Program Files\Attachmate\E!E2K\Macros

to

C:\Documents and Settings\All Users\Documents\Attachmate\Extra!\Macros

Copy

C:\Program Files\Attachmate\E!E2K\Schemes

to

C:\Documents and Settings\All Users\Documents\Attachmate\Extra!\Schemes

Copy

C:\Program Files\Attachmate\E!E2K\Sessions

to

C:\Documents and Settings\All Users\Documents\Attachmate\Extra!\Sessions

Completing the Upgrade

  1. After the installation of Extra! X-treme 9.x is complete, thoroughly test the features and functionality.
  2. Verify that the Windows PATH environment variable, if it was set to include the directory of the previous version of Extra!, is changed to the new installation directory for Extra! X-treme 9.x.
  3. Store a backup copy of critical user configuration files in a secure location. These files can be used to restore the old version of Extra! if necessary.
  4. When you are satisfied that the new version of Extra! is working, you can delete the old user configuration directory to avoid any confusion about which directory structure and set of configuration files is currently in use.

Additional Information

Legacy KB ID

This document was originally published as Attachmate Technical Note 2150.

Feedback service temporarily unavailable. For content questions or problems, please contact Support.