This page documents the use of admin tools to rebuild the Lucene index.  Indexes are created based on the hibernate-search annotations on model objects such as @Indexed, @IndexedEmbedded, @Field, @ContainedIn, etc.



This tool is used to rebuild Lucene indexes for objects indexed by the system.

Indexes are written into the directory specified by the hibernate.search.default.indexBase property in the properties file specified by "run.config".

Following are some details about the implementation of this tool:

Mojo: LuceneReindexMojo.java (in admin/mojo/src/main/resources/java/org/ihtsdo/otf/mapping/mojo)

Project: admin/lucene

Configuration Parameters


Sample command line call of the admin tool to rebuild all indexes:

% cd ~/code/admin/lucene
% mvn install -PReindex -Drun.config=/home/ihtsdo/config/config-load.properties

Sample command line call of the admin tool to reindex only certain data types:

# Re-indexes only map records and tracking records
% cd ~/code/admin/lucene
% mvn install -PReindex -Drun.config=/home/ihtsdo/config/config-load.properties -Dindexed.objects=MapRecordJpa,TrackingRecordJpa 

Sample eclipse run configuration to rebuild all indexes:


Sometimes issues arise with the indexes (in particular when running admin tools while the Tomcat server is also running). Occasionally it is necessary to completely reindex all objects from scratch. When this is needed, the recommended approach is to remove the index files from the index and then run this mojo. For example, to guarantee a clean index rebuild for map records, you could do the following.

# stop the server
% service tomcat7 stop

# remove the index
% /bin/rm -rf /var/lib/tomcat7/indexes/lucene/indexes/*MapRecordJpa

# rebuild the index
% cd ~/code/admin/lucene
% mvn install -PReindex  -Drun.config=/home/ihtsdo/config/config-load.properties -Dindexed.objects=MapRecordJpa
# start the server
% service tomcat7 start