Lucene indexes creation

From BioUML platform
Revision as of 12:58, 18 November 2014 by Tagir Valeev (Talk | contribs)

Jump to: navigation, search

Lucene indexes are necessary for Lucene search to work. Indexes are created for each database separately in databases collection and stored inside luceneIndexes subfolder of database folder on the disk.


Indexes in BioUML workbench

In BioUML workbench indexes are created automatically when you try to search the corresponding database:

Lucene indexes creation workbench.png

An indexes creation window will appear prompting you on which indexes you want to create. Upon pressing Ok button indexes recreation procedure will start. It may time a lot of time depending on the database:

Lucene indexes creation workbench process.png

After it finishes you may use the search.

Indexes in BioUML server

To create indexes in BioUML server you have to use separate helper application which can be launched using (on Unix) or rebuild_indexes.bat (on Windows) script. Place this script into $SERVER_PATH folder (see BioUML server installation).

This application reads the configuration from file, so you have to create one. It contains several rows in key=value manner. The following keys are defined:

user name (e-mail of the user to log in to BioUML server during indexes creation). This user must be a server administrator for the current server.
password for the specified user
semicolon-separated list of repository root folders which are necessary for indexes recreation. Eg: ./repo;./resources
list of databases to reindex in WildcardPathSet format (just semicolon separated list of database names will usually work)

An example of file is shown below.

After this file is created, launch rebuild_indexes script and it will try to create the missing indexes. It's desired to shutdown the BioUML server for the indexes creation procedure.

Recreating indexes after the database update

When you update the database indexes will become obsolete. The easiest way to update them is to terminate BioUML, remove luceneIndexes subfolder and recreate the indexes using the procedure above.

See also

Personal tools

BioUML platform
Analysis & Workflows
Collaborative research
Virtual biology