After upgrading Rational® ClearQuest®,
you might want to apply the same configuration settings to ClearQuest Web 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 8.0.1, ClearQuest Web
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 8.0.1 common.properties file.
By default, when you uninstall ClearQuest, 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 removing the product. If you are upgrading from a release earlier
than version 7.1.1 and 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. 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-8.0.1 deployment. For more information
about the uninstall tool, see Uninstall Rational products.
For more information about preserving properties files, see Preserve ClearQuest Web configuration files.
Attention: You must login to the Web client with Administrator
privileges to access the Site Configuration window. There are a number
of files that must be preserved such as crconfiguration.properties or cqserverconn.properties when
upgrading from version 7.1 to 8, or from 8.0 to 8.0.x.
To migrate previous configuration files:
- The properties from the DCT.properties file
must be converted to a new format for use with ClearQuest version
8.0. 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 earlier releases have been consolidated into a single common.properties file
in version 8.0. The properties and their values have not changed.
To maintain the earlier settings, migrate them to the version 8.0.1 common.properties file.
In version 8.0 and later, the location of the file common.properties is:
- Windows
- /install dir/IBM/RationalSDLC/ClearQuest/cqweb/cqwebprofile/installedApps/dfltCell/TeamEAR.ear/cqweb.war/WEB-INF/classes/common.properties
- Linux or UNIX
- install dir/opt/rational/ClearQuest/cqweb/cqwebprofile/installedApps/dfltCell/TeamEAR.ear/cqweb.war/WEB-INF/classes/common.properties
- 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 ClearQuest Web Server Options page
The properties from
rmmanager.properties can
be set in the ClearQuest Web
Server Options tab of the Site Configuration window.
Table 1. rmmanager.properties
migrationrmmanager.properties |
ClearQuest Web
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 ClearQuest Web
Server Options tab of the Site Configuration window.
Table 2. csm.properties
migrationcsm.properties |
ClearQuest Web
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.