Find 24.3

# Upgrade Find

IMPORTANT: To upgrade to Find version 24.3 from a version earlier than 23.4, you must first upgrade to version 23.4, and then upgrade to version 24.1.

OpenText recommends that you back up your configuration file (`config.json`) and the database for saved searches before you upgrade (that is, copy the `data` directory in the home directory). During the upgrade process, Find migrates the database to the new version. If you need to revert to the earlier version of Find, you must restore the `data` directory and configuration file.

When you upgrade to Find version 24.1 from version 23.4, if you want to preserve your saved searches you must also perform an additional database upgrade.

To upgrade Find

1. Back up the `data` directory in the Find home directory. This directory contains the database file that stores saved search data. The backup is required if you need to revert to the previous version of Find after upgrading.

2. Back up the `config.json` file in the Find home directory.

3. Run the new Find installer, or replace the `.war` file in the Find home directory. You must use the same home directory as the installed version of Find.

4. Follow the installation and setup instructions in Install Find with the Interactive Installer (Recommended).

   The installer migrates your database to the latest version.

To upgrade the database from Find version 23.4 to 24.1

1. Obtain the `find-migrate_24.1.0_COMMON.zip` release package. This package is available in the same place as the Find ZIP.

2. Extract the contents of the ZIP file.

3. Stop Find and save a backup of the existing database (the `data` folder inside your Find home folder).

4. In a command prompt, navigate to the folder `find-migrate-24.1` from the ZIP that you extracted.

5. Using Java 8, run the following commands, replacing `<HOME>` in each case with your Find home folder:

       java -cp "lib/*:h2-1.4.199.jar" org.flywaydb.commandline.Main -url='jdbc:h2:<HOME>/data/find-db' -locations=db/migration/h2 -user= -password= migrate

       java -cp h2-1.4.199.jar org.h2.tools.Script -url 'jdbc:h2:<HOME>/data/find-db' -script find-db.gz -options compression zip

       java -cp h2-2.2.224.jar org.h2.tools.RunScript -url 'jdbc:h2:<HOME>/data/find-db-v2' -script find-db.gz -options compression zip variable_binary

6. Start the new version of Find and verify that your saved searches are present.

## Revert to a Previous Version of Find

The Find upgrade process modifies the database, and the configuration settings might not be compatible between different versions. If you need to revert to a previous version of Find, you must restore the configuration file and `data` directory to the earlier version.

CAUTION: Any data that you save after you upgrade Find is lost when you revert to an earlier version.

To revert to a previous version of Find

1. Uninstall the existing version of Find.
2. Follow the instructions in Install Find to install the previous version.
3. Restore the backup copies of `config.json` and the `data` directory that you made during the upgrade process to the Find home directory.

Copyright 2015-2024 Open Text
Version 24.3 | Last updated June 2024

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to MFI-swpdl.idoldocsfeedback@opentext.com.

We appreciate your feedback!

Product: IDOL Find 24.3

Topic Title: Upgrade Find