Upgrading Solr to the latest version supported by Rational® ClearQuest®

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

Before you begin

This scenario should take approximately 15 minutes to complete if you are using the Rational® ClearQuest® 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 Rational® ClearQuest®, 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 Rational® ClearQuest® 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 Rational® ClearQuest® 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 Rational® ClearQuest® supports.