Troubleshooting
Problem
Attempts to run the "repotools-jts -reindex all" or "repotools-rm -reindex all" command results in error CRJZS5856E and warning CRJZS5181W reporting an error exception during text indexing IBM Rational DOORS Next Generation.
Symptom
Note: Starting with IBM Rational DOORS Next Generation (RDNG) version 5.0
, the Requirements Management (RM) database has been separated from the Jazz Team Server (JTS) database, therefore the repotools reindex command to be used is repotools-rm -reindex all
.
The following errors are reported when the reindex all
command is not completed:
- In the command window where the
repotools-jts -reindex all
orrepotools-rm -reindex all
for version5.x
command is being executed:
java/lang/OutOfMemoryError.
CRJAZ1065I Failed to execute preInvoke.
java.lang.RuntimeException: CRJZS5856E An unexpected error occurred during a write transaction in the index.
- In the repotools-jtsreindex.log or repotools-rmreindex.log (for version
5.x
):
CRJZS5181W Error reported during text indexing, exception:
CRJZS5585I Reindexing : Finished processing "text live" indices for /admin in 539058 ms
CRJZS5586I Reindexing : Finished processing "text live" indices for private applications in 539338 ms
CRJZS5585I Reindexing : Finished processing "text live" indices for Rational Requirements Server in 539369 ms
CRJZS5585I Reindexing : Finished processing "triple live" indices for /admin in 539636 ms
CRJZS5586I Reindexing : Finished processing "triple live" indices for private applications in 539783 ms
JVMDUMP039I Processing dump event "systhrow", detail "java/lang/OutOfMemoryError" at 2013/08/24 12:19:20 - please wait.
JVMDUMP039I Processing dump event "systhrow", detail "java/lang/OutOfMemoryError" at 2013/08/24 12:19:20 - please wait.
JVMDUMP039I Processing dump event "systhrow", detail "java/lang/OutOfMemoryError" at 2013/08/24 12:19:20 - please wait.
JVMDUMP039I Processing dump event "systhrow", detail "java/lang/OutOfMemoryError" at 2013/08/24 12:19:20 - please wait.
JVMDUMP039I Processing dump event "systhrow", detail "java/lang/OutOfMemoryError" at 2013/08/24 12:19:20 - please wait.
JVMDUMP039I Processing dump event "systhrow", detail "java/lang/OutOfMemoryError" at 2013/08/24 12:19:20 - please wait.
JVMDUMP039I Processing dump event "systhrow", detail "java/lang/OutOfMemoryError" at 2013/08/24 12:19:20 - please wait.
Cause
This could be due to JVM (Java Virtual Machine) heap lack of memory. Depending on the index size for a given deployment, the default JVM setting of -Xmx1500M
is not enough to run the repotools-jts -reindex all
or repotools-rm -reindex all
for version 5.x
command.
Resolving The Problem
To modify the JVM settings, follow these steps:
- Stop the server.
- In the [SERVER_INSTALL]/server/repotools-jts or /repotools-rm file locate the following properties:
VMARGS="$VMARGS -Xmx1500M"
#VMARGS="$VMARGS -Xgcpolicy:gencon"
- Modify as follows:
VMARGS="$VMARGS -Xmx8192M"
VMARGS="$VMARGS -Xms8192M"
VMARGS="$VMARGS -Xmn1024M"
VMARGS="$VMARGS -Xgcpolicy:gencon"
Note: The above values are just an example based on the JVM utilisation and index size for a given deployment. The values should vary depending on the type of deployment and should be more of a tuning exercise, verifying the changes are acceptable by running a complete reindex.
- Run the
repotools-jts -reindex all
orrepotools-rm -reindex all
command and verify it completes successfully.
- Restart the server.
Product Synonym
Rational DOORS Next Generation
Was this topic helpful?
Document Information
Modified date:
16 June 2018
UID
swg21666447