Repository tools command to regenerate indexes

Use the reindex command to regenerate query triple store and Lucene text store indexes.

Purpose

The reindex command is used against an offline server and affects all resources in the storage services. By default, the query triple store and the Lucene text store are regenerated, but the "scope" parameter can be used to rebuild either the query or the text indexes or both.
Important: You must shut down the server before you run the command.

Parameters

Attribute Description Required Default
teamserver.properties Path to the teamserver.properties file. No conf/application/teamserver.properties

where application is jts, ccm, rm, or qm
scope The scope of re-indexing. Values are
  • all: to rebuild all indexes
  • query: to rebuild query triple store indexes
  • search: to rebuild Lucene text store indexes
 No all
noPrompt Do not prompt before re-indexing a cluster. No N/A
baselines A comma separated list of baselines URI, without spaces. Providing this argument will only reindex the provided baselines. No none
all Reindex both live and history indices. No N/A

Example

The following example is for Jazz Team Server. To use this command for the Change and Configuration Management application run repotools-ccm, for the Requirements Management application run repotools-rm, and for the Quality Management application run repotools-qm from the server directory.

For Windows operating systemOpen a command prompt and enter this command:

cd C:\Program Files\IBM\JazzTeamServer\server\
repotools-jts.bat -reindex teamserver.properties=conf\jts\teamserver.properties scope=all

For Unix operating systemsOpen a command line and enter this command:

cd opt/IBM/JazzTeamServer/server/
./repotools-jts.sh -reindex teamserver.properties=conf/jts/teamserver.properties scope=all
If you encounter out of memory error while running the reindex command, it might be because of the heap size value that is set in the repotools command. The default value of the Xmx in repotools is 1500M. To use a higher value than 1.5 GB, you can define the following system environment variable before running the repotools command. For example:
  • Variable name: REPOTOOLS_MX_SIZE
  • Variable value: 2500M

For IBM i operating systemWhen you run the Rational® Team Concert™ repotools -reindex all command and you have DB2® for IBM® i installed, you might experience a java.sql.SQLException: Limit on number of statements exceeded. The cause and resolution for the error are documented in the technote titled RTC Attempts to run repotools may result in java.sql.SQLException: Limit on number of statements exceeded.

video icon Watch videos

CLM playlist
Jazz.net channel
User Education channel

learn icon Learn more

CLM learning circle
Agile learning circle
Learning circles

ask icon Ask questions

Jazz.net forum
developerWorks forums

support icon Get support

Support Portal
Deployment wiki
Support blog