IBM Support

How to regenerate a search index in Rational Change

Technote (troubleshooting)


How do you regenerate a search index in IBM Rational Change when a search results in only some Change Requests being found?


When you search for a Change Request (CR) and the results returned do not include some CRs you know should be there, you may have to regenerate or rebuild the search index.



Diagnosing the problem

Troubleshooting tips:

  • Ensure that Access Control Lists (ACL) do not prevent access to these CRs.
  • Ensure that the attribute searched is searchable.

    Check under Search > Results Format which attributes are listed under Chosen Attributes.

Resolving the problem


The following steps will help resolve the issue.

Caution! This action creates an index across all databases for the installation. This can take time to process, and search results may be incomplete while the index is rebuilding. Contact Rational Client support if you want to verify the index before you attempt a rebuild.

  1. For Rational Change 5.2, remove the files below from wsconfig/system and index directories:

    rm create.tmr enabled.tmr searchInformation.dat search.lock

    rm -Rf index

    Any .redo or .idx files in the system directory exist due to a failed recreate and would not exist if an index generation had succeeded.

    For Rational Change 5.3 and 5.3.1, remove the same files from the wsconfig/search and index directories.

  2. Log into Rational Change as the admin user

  3. Navigate to the Administration > Search > Status tab

  4. Click on Regenerate Index

    If the Regenerate Index and Update Index buttons are missing, then rename or delete following file in Rational Change 5.2:


    In Rational Change 5.3 and 5.3.1 rename or delete following file instead:


NOTE: It is possible to create the index from the command line using a Perl Script. For example: Consider the following debug script to create the search index:


All source code and/or binaries included in this document are referred to here as "the Program". IBM is not providing program services of any kind for the Program. IBM is providing the Program on an "AS IS" basis without warranty of any kind. IBM WILL NOT BE LIABLE FOR ANY ACTUAL, DIRECT, SPECIAL, INCIDENTAL, OR INDIRECT DAMAGES OR FOR ANY ECONOMIC CONSEQUENTIAL DAMAGES (INCLUDING LOST PROFITS OR SAVINGS), EVEN IF IBM, OR ITS RESELLER, HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

    # This script creates the sort index form scratch.

    # This must be run as the admin user.

    # The Change Server must be active but users should not be on the

    # database at the time you run this.

    use ChangeSynergy::csapi;

    my $csapi = new ChangeSynergy::csapi();
    my $aUser = $csapi->Login("admin", "myPassword", "Admin",

     my $database= $aUser->getUserDatabase() ;
     print "db: ".$database."!";
     my $tmpstr = $csapi->

Related information

Searching for CR text yields unexpected results
Index error 'Failed to optimize search index'

Document information

More support for: Rational Change
General Information

Software version: 5.2, 5.3, 5.3.1

Operating system(s): AIX, Linux, Solaris

Reference #: 1505216

Modified date: 10 June 2014