Migrating the DCT.properties file

You must manually migrate the HCL Compass web settings in the DCT.properties file when you upgrade HCL Compass.

Before you begin

The tool to migrate the DCT.properties file runs on Windows™, Linux™, and UNIX™ systems. For Linux and UNIX systems, substitute /opt/ for C:\Program Files\ in the command examples.

Procedure

  1. PLAN: Before beginning the upgrade, back up your DCT.properties file to a temporary directory. By default, the DCT.properties file is located in: C:\Program Files\HCL\CCM\Compass\cqweb\cqwebprofile\installedApps\dfltCell\TeamEAR.ear\cqweb.war\WEB-INF\classes.
  2. INSTALL: Complete the HCL Compass installation.
  3. POST-INSTALL: Prepare to run the DCT.properties conversion tool by adding two jar files to the class path: cqwebapp.jar and json.jar. By default, the jar files are located in: C:\Program Files\HCL\CCM\Compass\cqweb\cqwebprofile\installedApps\dfltCell\TeamEAR.ear\cqweb.war\WEB-INF\lib.
  4. POST-INSTALL: Run the Java™ program, com.hcl.compass.cq.web.utils.CQSiteConfigConverter, to migrate the DCT.properties files to the new format. This program accepts two command line parameters: the full path name of the old DCT.properties file that you want to convert and the full path name of the new properties file you are creating. The new file can be saved in any directory, but should be called cqSiteConfig.pref.
    The following example takes the settings from the old DCT.properties file in the directory C:\temp directory and creates a file: C:\temp\cqSiteConfig.pref:
  5. POST-INSTALL: When you upgraded HCL Compass, a default version of the cqSiteConfig.pref file was created. Save a backup copy of this file and then overwrite it with the new cqSiteConfig.pref file that you created in the previous step.