Upgrading a pre-9.8.2 ImageMaster Solr system
If you upgrade from an ImageMaster release before 9.8.2 with Solr, you have Solr 4.10 but you now need Solr version ≥ 8.11.4 or 9.x.y (x.y ≥ 0.0).
To continue using the ImageMaster full-text functionality, conduct these steps (from the previous installation sections):
-
Authentication and communication security (reconfigure if you have SSL enabled)
The existing Solr configuration files must then be adapted:
One of the main differences to version 4.10 is that Solr no longer runs in an application server, but is installed as a standalone application. So remember to uninstall or deactivate the existing Solr 4.10 Web application after the upgrade.
If the host or port of the new Solr installation has changed, you also have to update the ImageMaster full-text settings:
Basically there are two ways to use the ImageMaster full-text Index for existing documents:
-
re-indexing all existing documents
-
upgrading the existing Solr index
Which option is to be chosen depends mainly on the numbers and sizes of documents already indexed. In general, re-indexing all existing documents (started from the ImageMaster AdminClient) is the more comfortable method, but it will take significantly longer than an index upgrade. This is no realistic option for any larger project. Upgrading an existing Solr index is faster, but requires more manual steps.
Before starting, make sure that you back up the existing Solr home directory. Create at least a backup of all configuration files in all cores inside the Solr home directory. A backup of the ./data/ directories (the location where Solr keeps its index) for each core is recommended, but must be decided on a per-project basis for larger projects.
The configuration files in the Solr home directory must be adapted independently of the selected method. This is described in the next chapter.