Upgrading Your Lucene Indexes

As of WebFOCUS Release 8.2 Version 01 and higher, Magnify Search requires Lucene indexes to be at the version 4.x level. Earlier versions of Lucene indexes (for example, version 2.x) will not function.

Magnify Search provides an upgrade utility that is packaged with your WebFOCUS installation in the following directory:

drive:\ibi\WebFOCUS82\utilities\magnify

A batch file for Windows platforms named upgrade.bat and a shell script for UNIX/Linux platforms named upgrade.sh is available, as shown in the following image.

Perform the following steps to upgrade any earlier versions of Lucene indexes to version 4.9 using the available upgrade utility. For demonstration purposes, the upgrade utility for Windows platforms (upgrade.bat) is used. However, the general steps in this procedure are also applicable when using the upgrade utility for UNIX/Linux platforms (upgrade.sh).

Note: Before proceeding, it is recommended that you create a backup of your existing Lucene index, since this utility replaces the entire index in the specified directory path.

Run the upgrade.bat file.
The following prompt is displayed in a command console window:
```
Enter OLD Lucene Index Location (default-C:\ibi\WebFOCUS82\magnify\lucene_index):
```
Specify the directory path to the old Lucene index and press Enter.
Note: If you enter an invalid path, the upgrade utility displays a warning indicating that the directory does not exist and prompts you to re-enter the path. If this is the case, press y to continue and enter the correct path.

The following prompt is displayed:
```
Enter NEW Lucene Index Location (default-C:\ibi\WebFOCUS82\magnify\lucene4_index):
```
Specify the directory path to where you require the upgraded Lucene index to be created and press Enter.
The following message is displayed:
```
Upgrading Lucene Indeces ......
```
Notes:
- Depending on the amount and size of indexes that are being upgraded by this utility, this operation may take some time to complete. However, status messages are actively displayed in the command console window, which indicate the progress.
- If an index of the same name as an old index exists, then it will be overwritten by the upgraded version of the index.
After the upgrade process has finished, the command console window automatically closes.
Navigate to the directory path you specified where the upgraded Lucene indexes are created and verify that the corresponding indexes are available.