Upgrade/Migrate Lucene Indexes¶

The update 8.0u20230301 upgrades the library Apache Lucene from the version 5.5 to 9.4. This change causes that neither Data Catalog nor Scheduler can use the indexes generated by Scheduler-Index with the update 8.0u20220815 or previous updates.

The update 8.0u20230301 includes a tool that modifies the existing indexes to be accessible again.

Follow these steps to use this tool:

1. Stop Scheduler Index: run <DENODO_HOME>/bin/arnindex_shutdown.

2. Decompress the file <DENODO_HOME>/tools/scheduler/denodo-lucene-migrator-tool

3. Run the script <DENODO_HOME>/tools/scheduler/denodo-lucene-migrator-tool/bin/lucene-migrator

lucene-migrator [-?] -f <from_lucene_version> [-nb] -p <path_to_index> -t <to_lucene_version>

? prints the help (usage).

-f <from_lucene_version>: current Lucene version of the index to be migrated (Minimum version is 4).

-t <to_lucene_version>: desired Lucene version to migrate the index to (Maximum version is 9).

-p <path_to_index>: path of the index to be migrated.

-nb: optional. Do not generate backup of the current index. By default, if this option is not supplied, the current index folder is renamed to <path_to_index>.lucene-<from_lucene_version>.backup.

Examples of using the lucene-migrator script

Example 1

cd <DENODO_HOME>
cd tools/scheduler/denodo-lucene-migrator-tool/bin
./lucene-migrator -f 5 -t 9 -p "/opt/denodo/path/to/my/index"

This command does this:

• Upgrades the index of the path /opt/denodo/path/to/my/index from Lucene version 5 to version 9.

• Keeps a backup the current index in the folder /opt/denodo/path/to/my/index.lucene-5.backup

Example 2

cd <DENODO_HOME>
cd tools/scheduler/denodo-lucene-migrator-tool/bin
./lucene-migrator -f 5 -t 9 -p "/opt/denodo/path/to/my/index" -nb

This command does the same as “Example #1” but without creating a backup.