Transitioning Cloudera Search configuration before upgrading to Cloudera Runtime

If your CDH cluster includes Cloudera Search, there are steps you need to take before transitioning your cluster to CDP Private Cloud Base. Read these instructions even if the Cloudera Search instance installed in your cluster is not in use to avoid compromising your entire upgrade procedure.

As Cloudera Search is included in Cloudera Runtime 7, upgrading from CDH 5 to Cloudera Runtime 7 upgrades Cloudera Search as well. If you are upgrading to Cloudera Runtime 7 from CDH 5, and you are using Cloudera Search, you must complete certain preparatory tasks.

Cloudera Search that is shipped with Cloudera Runtime 7 uses Apache Solr 8, which has certain incompatibilities with previous Solr versions. To facilitate the upgrade, Cloudera provides a Solr configuration transition script, solr-upgrade.sh. This script is included with Cloudera Manager. You must upgrade to Cloudera Manager 7.1 or higher before you can start the Cloudera Search transition.

Use the following procedures to migrate your Cloudera Search configuration before upgrading a cluster to Cloudera Runtime 7. The migration script cannot upgrade the Lucene index files. After upgrading, you must reindex your collections. For more information, see Reindexing in Solr in the Apache Solr wiki.