Configuring the fields for Solr to index

Update the Solr schema file, schema.xml, to specify the fields for Solr to 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
dbset_name
Name of the database set
dbname
Name of the database
yourSchemaName
Directory that you created when you established the location of the Lucene index
To specify the fields for Solr to index, perform the following steps:
  1. Edit the Solr schema file, schema.xml, which is located in the Solr directory that is created when you install the ClearQuest software:
    On Windows:
    drive:\%CLEARQUEST_HOME%\CQ.Solr\yourSchemaName\Solr\solr\conf
    On the UNIX system and Linux:
    $CLEARQUEST_HOME/CQ.Solr/yourSchemaName/Solr/solr/conf
  2. Replace certain sections of the file schema.xml with the corresponding sections of the Solr search file Solr-db_name-dbset_name.xml, which you created in a previous topic.
    1. Replace the <fields> section of schema.xml with the <fields> section of Solr-db_name-dbset_name.xml.
    2. Replace the <copyField> sections in the same manner. Note that there are multiple corresponding <copyField> sections to replace.
    3. Replace the <uniqueKey> section in the same manner. This section already exists if you started with the file schema.xml, which is specified in the previous step.
    4. Replace the <defaultSearchField> section in the same manner. This section already exists if you started with the file schema.xml, which is specified in the previous step.
  3. In the <schema> section, replace the value of the element name with the name of your schema. If you use ClearQuest MultiSite, also specify the name of your local site.
    For example, if your schema name is MySchema and your site name is SiteA, replace the following line:
    <schema name="SAMPL" version="1.1">
    with this line:
    <schema name="MySchema at SiteA" version="1.1">

    The Solr Administrative console page will reflect this change.

  4. Optional: By default, the file schema.xml is optimized for English. To configure the ClearQuest full-text search feature to support localized character sets, you must update the <fieldType> section of schema.xml to use the appropriate language analyzer. See the online help for Solr and Lucene for details.
  5. Optional: The remaining settings in schema.xml should work well for most ClearQuest schemas. For further customizations and optimizations, Solr offers additional settings that you can modify in the files schema.xml and solrconfig.xml. To learn more, visit http://lucene.apache.org/solr/.
  6. Restart cqsearchprofile, the WebSphere Application Server profile in which Solr resides. See the WebSphere Application Server Information Center for details.
    Attention: Anytime you change the values in schema.xml or solrconfig.xml, you must restart cqsearchprofile for the changes to take effect.
Related concepts
Full-text search maintenance
Configuration for localized character sets
Related reference
cqtssetup.pl
cqtsdbcrawler.pl
setmasterpropertyfromfile
scruboplog

Feedback