How to re-index Crucible review data
Purpose
Crucible's cache has become corrupt and the information displayed in the application is not consistent with the data in the database. The following procedure will recreate the Lucene index for Crucible reviews and comments. The Lucene index is used to populate review dashboards and is utilized to provide search functionality.
Solution
Re-index Crucible´s cache by doing the following:
- Go to
Administration >> Global Settings > Crucible - Click on "Re-Index".
There is no visual queue in the application that identifies the index progress but you can identify when it has commenced and completed by looking for the following lines in your application log:
Start
Starting review re-indexingFinish
Completed review re-indexingE.g.:
2012-11-15 13:19:58,682 INFO [pool-7-thread-1 ] fisheye.app DefaultReviewItemIndexer$3-run - Starting review re-indexing
2012-11-15 13:19:58,894 INFO [pool-7-thread-1 ] fisheye.app DefaultReviewItemIndexer$3-run - Completed review re-indexing of 2 documents, took 0 secondsIf the re-indexing doesn´t work manually remove Crucible´s cache to force a Crucible content re-index:
- Shut down the application.
- Remove the contents of the
<FISHEYE_INST>/cache/cruidxfolder. - Restart the application.
Although this process doesn't prevent access to the application, reviews will only be visible in the application after they have been indexed. This process may take a some time depending on review size and number so consider performing this operation after hours.