The first step in configuring Solr is to establish the
location of the Lucene index.
Before you begin
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, the Lucene
index is copied to the following location:
- On Windows:
%CLEARQUEST_HOME%\CQ.Solr\
- On the UNIX system and Linux:
$CLEARQUEST_HOME/CQ.Solr/
Procedure
- 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.
- 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.
- 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.
- Start Solr by starting cqsearchprofile,
the WebSphere Application Server profile in which Solr resides.
- On Windows, by using the Control Panel:
- Click .
- In the Services pane, right-click IBM WebSphere Application
Server v6.1 - cqsearchprofile and select Stop.
- 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 the system restarts.
Attention: Anytime you change the value of solr.solr.home,
you must restart cqsearchprofile.