Migrating ClearQuest Web configuration settings

After upgrading Rational® ClearQuest®, you might want to apply the same configuration settings to Change Management Server (CM Server) that existed in your previous configuration of ClearQuest Web. Some settings are automatically propagated during the upgrade, while others must be set manually.

In ClearQuest Web version 7.1, CM Server configuration settings are set mostly in the Site Configuration dialog box of the Web client. The properties from the Application Server and Recycle Manager version of the common.properties file are set in the version 7.1 common.properties file.

By default, when you uninstall ClearQuest by using rationaluninstalltool.exe, the properties files listed in the following tables are preserved, and you can manually migrate the settings after you reinstall. However, you should also consider making additional backup copies of the files before uninstalling. If you use the "clean" option (-c) with rationaluninstalltool.exe, the properties files are not preserved, and you must manually migrate all of the settings from the copies of the properties files you preserved before uninstalling. If you must run the clean uninstall option for other reasons, it becomes increasingly important to preserve these properties files if you want to migrate the settings from your pre-7.1 deployment. For more information about the uninstall tool, see Uninstall Rational products. For more information about preserving properties files, see Preserving ClearQuest Web configuration files.

Attention: You must login to the Web client with Administrator privileges to access the Site Configuration window.

To migrate previous configuration files:

The properties from the DCT.properties file must be converted to a new format for use with ClearQuest version 7.1. For instructions on how to convert the file, see Migrating the DCT.properties file.
The Application Server and Recycle Manager versions of the common.properties file from pre-7.1 releases have been consolidated into a single common.properties file in version 7.1. The properties and their values have not changed. To maintain the settings in pre-7.1 deployments, migrate these to the version 7.1 common.properties file. In version 7.1, the location of the file common.properties is:
\\install dir\IBM\RationalSDLC\common\CM\profiles\cmprofile\installedApps\dfltCell\TeamEAR.ear\CQWebModule.war\WEB-INF\classes\common.properties.

For Linux® or UNIX® system platforms, replace \\install dir\IBM\RationalSDLC\ with /opt/rational/.
The properties from the files listed in the following tables are not automatically migrated during the upgrade process even if the user data preserved uninstall option was used. However, each properties file has corresponding configuration options in the Site Configuration window. See the tables below for these mappings. For information about the options in the Site Configuration window, see Modifying the CM Server options for ClearQuest Web

The properties from rmmanager.properties can be set in the CM Server Options tab of the Site Configuration window.

Table 1. rmmanager.properties migration
rmmanager.properties	CM Server Options
TIME_CRITERIA=DAILY\|1:00 AM	Recycle Server Lifetime Limit (seconds)
NUMBER_OF_REQUESTS_CRITERIA	Recycle Server ONC RPC Call Limit (number)

The properties from csm.properties can be set in the CM Server Options tab of the Site Configuration window.

Table 2. csm.properties migration.
csm.properties	CM Server Options
NUMBER_OF_REQUEST_MANAGERS	Maximum Active Servers

The properties from logging.xml can be set in the Application Options tab of the Site Configuration window.

Table 3.
logging.xml	Application Options
Enable Flagging	Enable Diagnostics

The properties from both the Application Server, and Recycle Manager versions of saved.properties and jtl.properties are deprecated in version 7.1. Preserve these files for reference purposes only.