indexupgrade.py

Run the indexupgrade.py script post upgrade to convert existing search indices to Lucene 4.x format.

Overview

See Upgrade TeamForge search index to Lucene 4.x format.

Warning: You must back up the existing search index directory before running this script.

Usage

Command Description
sudo ./runtime/scripts/indexupgrade.py -h Displays the Help text for the script.
sudo ./runtime/scripts/indexupgrade.py Upgrades the existing search indices to Lucene 4.x format.
Important: If the upgrade fails with an out of memory error (OOME), increase the maximum heap size for JVM and run the script again.
sudo ./runtime/scripts/indexupgrade.py --max-heap-size=N
Note: Where N is the maximum heap size for JVM.
Upgrades the existing search indices to Lucene 4.x format. The maximum JVM heap size is passed as one of the parameters to provision additional memory for the JVM if the search index directory is considerably huge (typically the case with customers having huge amount of data in terms of several GB).

Logging

The indexupgrade.py script writes entries to: <SITE_DIR>/log/runtime/indexupgrade.log.