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:
- 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
- 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.
- Replace the <fields> section of schema.xml with
the <fields> section of Solr-db_name-dbset_name.xml.
- Replace the <copyField> sections
in the same manner. Note that there are multiple corresponding <copyField> sections
to replace.
- 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.
- 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.
- 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.
- 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.
- 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/.
- 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.