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
-
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. -
Back up the
config.json
file in the Find home directory. -
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. -
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
-
Obtain the
find-migrate_24.1.0_COMMON.zip
release package. This package is available in the same place as the Find ZIP. -
Extract the contents of the ZIP file.
-
Stop Find and save a backup of the existing database (the
data
folder inside your Find home folder). -
In a command prompt, navigate to the folder
find-migrate-24.1
from the ZIP that you extracted. -
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
-
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
- Uninstall the existing version of Find.
- Follow the instructions in Install Find to install the previous version.
- Restore the backup copies of
config.json
and thedata
directory that you made during the upgrade process to the Find home directory.