Establishing the location of the index

The first step in configuring Solr is to establish the location of the Lucene index.
The following variables are used in path names in this topic:
CLEARQUEST_HOME
Directory where Rational ClearQuest is installed
RATIONAL_COMMON
Directory where Rational common files are installed
WAS_BIN
IBM WebSphere Application Server bin directory:
On Windows:
%RATIONAL_COMMON%\eWAS\bin
On the UNIX system and Linux:
$RATIONAL_COMMON/eWAS/bin
yourDBName
Logical name of your ClearQuest user database
By default, when Solr is installed, a Lucene index is copied to the following location:
On Windows:
drive:\%CLEARQUEST_HOME%\CQ.Solr\
On the UNIX system and Linux:
$CLEARQUEST_HOME/CQ.Solr/

To establish the location of the index for your ClearQuest user database, copy and rename the index by performing the following steps:

  1. Copy the directory CQ.Solr to a location outside the ClearQuest installation directory on the same computer on which the ClearQuest full-text search feature is installed. Consider copying the CQ.Solr directory to a fast secondary hard drive that is dedicated to full-text search.
  2. Rename the directory CQ.Solr\SAMPL to correspond to the logical name of your ClearQuest user database. For example, if your user database name is DFECT, rename CQ.Solr\SAMPL to CQ.Solr\DFECT.
  3. Set the Java Virtual Machine (JVM) system property solr.solr.home to the new location of the Lucene index by running the wsadmin command-line utility:
    • On Windows:
      %WAS_BIN%\wsadmin.bat -conntype NONE -lang jython -profileName cqsearchprofile -f %WAS_BIN%\setSolrHome.py -interactive:yes drive:/CQ.Solr/yourDBName/Solr/solr
    • On the UNIX system and Linux:
      $WAS_BIN/wsadmin.sh -conntype NONE -lang jython -profileName cqsearchprofile -f $WAS_BIN/setSolrHome.py -interactive:yes /CQ.Solr/yourDBName/Solr/solr

    When prompted to modify the command-line argument values that you just specified, type n to indicate no. The configuration changes are saved.

    At startup, Solr reads the value of solr.solr.home to locate its configuration files.

  4. Start Solr by starting cqsearchprofile, the WebSphere Application Server profile in which Solr resides.
    • On Windows, by using the Control Panel:
      1. Click Start > Control Panel > Administrative Tools > Services.
      2. In the Services pane, right-click IBM WebSphere Application Server v6.1 - cmprofile and select Stop.
      3. After the service stops, restart it by right-clicking and selecting Start.
    • On Windows, by using the command prompt window:
      > net stop "IBM WebSphere Application Server V6.1 - cqsearchprofile"
      > net start "IBM WebSphere Application Server V6.1 - cqsearchprofile"
    • On the UNIX system and Linux:

      Based on your version of the UNIX system or Linux, add one of the following lines to the file init.d:

      $WAS_BIN/startServer.sh WebSphere-host -profileName cqsearchprofile

      or

      $WAS_BIN/startServer.csh WebSphere-host -profileName cqsearchprofile

      This ensures that cqsearchprofile starts automatically whenever WebSphere Application Server restarts.

    Attention: Anytime you change the value of solr.solr.home, you must restart cqsearchprofile.
Related concepts
Full-text search maintenance
Configuration for localized character sets
Related reference
cqtssetup.pl
cqtsdbcrawler.pl
setmasterpropertyfromfile
scruboplog

Feedback