Upgrading Solr to the latest version supported by HCL Compass

You can upgrade Solr to the latest version supported by HCL Compass. This is useful when the Solr version in your deployment is older than the version that HCL Compass supports.

Before you begin

This scenario should take approximately 15 minutes to complete if you are using the HCL Compass SAMPL database. If you are using a production database and you need to re-index, the time will increase relative to the size of your database.

About this task

This scenario assumes that you have upgraded HCL Compass, and have upgraded your full-text search deployment by using the cqtsadmin.pl prep_upgd_was_profiles and restore_was_profiles command-line options. Furthermore, the scenario assumes that the Apache Solr version currently used in this deployment is older than the version that HCL Compass supports, and you want to upgrade the Solr application.
Note: If you do not upgrade the Solr application, then the current version is used. If you deploy a new instance of full-text search, then the latest Solr version that is included with HCL Compass is installed and used. It is possible to have a mix of full-text search deployments on the same host, each using a different Solr version.

This scenario uses a schema repository with a connection named TextSearch and a user database named SAMPL. The path specifications assume that you are running on Windows™. Make the appropriate substitutions if you are running on the UNIX™ system or Linux™.

Procedure

  1. Back up your full-text search deployment by running the cqtsadmin.pl command with the backup_fts option:

    cqperl cqtsadmin.pl --username admin --password secret --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --backup_fts E:\FTS.Backup

  2. Upgrade the Solr application by running the cqtsadmin.pl command again with the upgrade_solr_app option:

    cqperl cqtsadmin.pl --username admin --password secret --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --upgrade_solr_app

  3. If a message displays after the command in Step 2 completes that instructs you to re-index the user database, then rerun the cqtsadmin.pl command four times with the stop_update_idx, run_batch_idx, optimize_idx, and start_update_idx command-line options, respectively:

    cqperl cqtsadmin.pl --username admin --password secret --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --stop_update_idx

    cqperl cqtsadmin.pl --username admin --password secret --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --run_batch_idx

    cqperl cqtsadmin.pl --username admin --password secret --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --optimize_idx

    cqperl cqtsadmin.pl --username admin --password secret --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --start_update_idx

Results

You have upgraded the Solr application to the latest version that HCL Compass supports.