Enabling full-text search for ClearQuest Web

Now you are ready to enable the ClearQuest full-text search feature.

Before you begin

The following variables are used in path names in this topic:
CM_SERVER_HOME
Directory where the Change Management Server (CM Server) is installed
RATIONAL_COMMON
Directory where Rational common files are installed
WAS_HOME
Directory where IBM WebSphere Application Server is installed:
On Windows:
%RATIONAL_COMMON%\eWAS
On the UNIX system and Linux:
$RATIONAL_COMMON/eWAS

Procedure

  1. On Windows, run the installutil setmasterpropertyfromfile subcommand, specifying the -user_db_name user_db_name argument and option and setting the master property to TEXT_SEARCH_PROPERTY. See the setmasterpropertyfromfile reference help for usage information. After running this command, the full-text search feature is enabled in the ClearQuest Web user interface. However, because you have not indexed any records yet, no records are returned if a user tries to use the feature.
    Attention: The installutil command is available only on the Windows platform. If you are configuring ClearQuest full-text search on the UNIX system or Linux, you must copy the ClearQuest search properties file, CQ-db_name-dbset_name.xml, to a Windows computer to run this command.
  2. Configure Solr to run automatically at system start up by using one of the following procedures:
    • On Windows, from the Control Panel:
      1. Open the Administrative Tools dialog box and double-click Services in the left pane.
      2. In the Services dialog box, right-click cqsearchprofile and select Properties.
      3. On the General tab of the Properties dialog box, change the value of Startup type to Automatic and click OK.
      4. In the Services dialog box, right-click cqsearchprofile and select Restart.
    • On the UNIX system or Linux, add one of the following lines to the file init.d based on the operating system version that you are running:
      $CM_SERVER_HOME/profiles/cqsearchprofile/bin/startServer.sh server-name >> $WAS_HOME/logs/ewas_start.log 2>&1

      or

      $CM_SERVER_HOME/profiles/cqsearchprofile/bin/startServer.csh server-name >> $WAS_HOME/logs/ewas_start.log 2>&1
    • On Windows, the UNIX system, or Linux, use the WebSphere Administrative Console. See the WebSphere Application Server Information Center for details.

Feedback