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

Technical Notes

Changing the Reflection X Advantage Data Folder Location
Technical Note 2561
Last Reviewed 25-Apr-2011
Applies To
Reflection X Advantage version 3.0 or higher
Summary

This technical note describes how to specify a non-default data folder for Reflection X Advantage. Instructions provided here are for standalone (default) Reflection X Advantage installations running on Windows platforms.

This note includes the following information:

Customize the Data Folder

By default, Reflection X stores configuration data and log files in a data folder located in the Windows user profile folder. Depending on your Windows operating system, the default location is one of the following:

C:\Users\<user>\.attachmate\rx\
C:\Documents and Settings\<user>\.attachmate\rx\

Subfolders within this folder include the “db” folder (which contains the Reflection X Advantage database) and the “logs” folder. Depending on your configuration, additional subfolders may also be present.

Use this procedure to configure a non-default data folder location. For this customization you will modify a file called rxmgr.alp.

  1. Close X Manager if it is running.
  2. Navigate to the Reflection X Advantage installation folder. (The default location for most installs is C:\Program Files\Attachmate\Reflection).
  3. Locate rxmgr.alp and remove the read-only attribute from this file. (Right-click, select Properties, clear the “Read-only” checkmark, then click OK.)
  4. Open rxmgr.alp in a text editor, such as Notepad.
  5. Modify the “alp.java.command.options=” entry by adding the following:
-Drx.rxmgr.db.home="drive:\path\datafolder"

For example:

alp.java.command.options=-server -XX:+UseConcMarkSweepGC -XX:+CMSIncrementalMode -XX:NewSize=64m -Xms256m -Xmx1024m -Dsun.java2d.d3d=false -Drx.rxmgr.db.home="C:\rxadatabase"
  1. Save and close the file.
  2. (Optional) Restore the read-only attribute.
  3. Based on whether or not you want to use default settings or your existing settings do one of the following:

To use default settings:

Start X Manager. Reflection X Advantage will create the new directory if it doesn’t already exist and create all required files.

To use your existing settings:

Locate the default data folder. Copy the subfolders and all of their contents to the new data folder. Then start X Manager.

Requirements for Installing Newer Versions After You Customize the Data Folder

If you install a newer version of Reflection X over a modified rxmgr.alp file, the Windows installer will not replace your modified file with a newer file. Each new version of Reflection X Advantage requires an updated rxmgr.alp file. If an older version is present, you will receive an “Unexpected error” message when you launch Reflection X Manager. To avoid this error, you must remove the modified file before you install any newer version. For details, see Technical Note 2530.

Related Technical Notes
2530 Installing Newer Versions of Reflection X Advantage If You Have Edited Rxmgr.alp

horizontal line

Did this technical note answer your question?

           


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