CRJZS5627E error when configuring the Data Warehouse during RTC setup

Technote (troubleshooting)


Problem(Abstract)

Attempts to configure the Data Warehouse for use with IBM Rational Team Concert results in "CRJZS5627E Unable to read or write the properties file index path with the path" error.

Symptom

The following error may be seen when attempting to configure the Data Warehouse:

CRJZS5627E Unable to read or write the properties file index path with the path <PATH>
Check the file and directory permissions and restart the server


Cause

The errors are related to the following values in the teamserver.propeties file for the IBM Jazz Team Server application (JTS):


    com.ibm.team.fulltext.indexLocation= < directory path >
    com.ibm.team.jfs.index.root.directory= < directory path >

Generally, the above directory paths are automatically configured during setup. Occasionally there will be a problem and the paths need to be manually configured in the JTS teamserver.properties file.

Other problems with these directory paths include:

  • Using the non-short name with a directory that has spaces

  • Using backslashes in the path

  • Not escaping the colon in the path

Diagnosing the problem

Verify the values in the JTS teamserver.properties are set correctly

This file can be found in <JazzTeamServer Install Directory>\server\conf\jts


Resolving the problem

To resolve the CRJZS5627E error, verify the values in the JTS teamserver.properties (located in <JazzTeamServer Install Directory>\server\conf\jts directory) are set correctly.

EXAMPLE: The values should look similar to the following:


    com.ibm.team.fulltext.indexLocation=C\:/PROGRA~1/JAZZTE~1/server/conf/jts/indices/workitemindex
    com.ibm.team.jfs.index.root.directory=C\:/PROGRA~1/JAZZTE~1/server/conf/jts/indices

In the example above, these values are INCORRECT, and will cause the error:

    C:\Program Files\JazzTeamServer\server\conf\jts\indices\workitemindex
    C:\Program Files\JazzTeamServer\server\conf\jts\indices

Change the above values to resemble those below, which are CORRECT:
    C\:/PROGRA~1/JAZZTE~1/server/conf/jts/indices/workitemindex
    C\:/PROGRA~1/JAZZTE~1/server/conf/jts/indices

Note: Use dir /x to verify the short name of the Windows directories

Leverage the Jazz Community

The Jazz based products have an active community that can provide you with additional resources. Browse and contribute to the User forums, contribute to the Team Blog and review the Team wiki.
Refer to technote 1319600 for details and links.


Cross reference information
Segment Product Component Platform Version Edition
Software Development Rational Quality Manager Web App Server 4.0
Software Development Rational Requirements Composer Web App Server 4.0

Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

Rational Team Concert
Installation

Software version:

2.0, 3.0, 4.0, 4.0.0.1, 4.0.4

Operating system(s):

Windows

Reference #:

1652085

Modified date:

2013-10-07

Translate my page

Machine Translation

Content navigation