Preserve ClearQuest® Web configuration files

If you include Rational® ClearQuest® Web in your environment, preserve your Web server configuration files before upgrading to the latest version.

To preserve these files, copy them to a location that will not be affected by the upgrade process. Be sure to distinguish the two versions of the files common.properties and jtl.properties before copying them, as the specific settings in each file may differ from each other.
Note: If the user data preserved uninstall option was run when uninstalling Rational® ClearQuest®, IBM® Installation Manager preserves the properties files listed in the following tables, and automatically migrates some of the settings to the Site Configuration window. However, you should also consider making additional backup copies of the files before uninstalling.

If the clean uninstall option is run, you must manually migrate all 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-8.0 deployment.

For more information about the uninstall tool, see Uninstall.

After you install the upgrade, you can migrate the configuration settings from the properties files in the following tables to Rational® ClearQuest® Web server. For information about how to migrate these settings, see Migrating ClearQuest Web configuration settings.
Note: For preserving files on Linux™ or UNIX™ system platform deployments, navigate to /opt/rational/.../ instead of \Program Files\Rational\...\, as shown next.
Table 1. Configuration files to preserve for the 7.0.x Application Server
Location Files
\Program Files\Rational\Common\rwp\EmbeddedExpress\profiles\profile1\installedApps\DefaultNode\RationalClearQuestWeb.ear\CQWebModule.war\WEB-INF\classes\
  • jtl.properties
  • common.properties
\Program Files\Rational\Common\rwp\EmbeddedExpress\profiles\profile1\installedApps\DefaultNode\RationalClearQuestWeb.ear\CQWebModule.war\WEB-INF\classes\wpf\conf\
  • dct.properties
Table 2. Configuration files to preserve for the 7.0.x Request Manager
Location Files
\Program Files\Rational\ClearQuest\cqweb\cqserver\config
  • common.properties
  • jtl.properties
  • rmmanager.properties
  • saved.properties
Program Files\Rational\ClearQuest\cqweb\
  • csm.properties

If you are upgrading from version 7.1.x of Rational® ClearQuest®, consult technote 1384746 for information about preserving CM Server configuration files before upgrading to a newer release.

Preserving SSL protocol files

SSL configuration files admin.conf, httpd.conf, and ssl.conf are included in the Rational® ClearQuest® configuration files and backed up during the upgrade process. In Rational® ClearQuest® 8.0.0.1 and later, the SSL configuration is managed by the WebSphere® Application Server configuration. If you are upgrading from version 7.1.x to 8.0.0.1 or later, you must configure SSL in WebSphere® Application Server before upgrading the Rational® ClearQuest® server components.

For instructions, see Configuring a web plug-in for IBM HTTP Server.