cqtsadmin.pl

cqtsadmin.pl ist ein Perl-Script, über das die Schritte zum Einrichten, Konfigurieren und Verwalten der Volltextsuche von IBM® Rational ClearQuest automatisiert werden.

cqtsadmin.pl ist eine von zwei Komponenten des Administratortools zur Volltextsuche. Bei der anderen Komponente handelt es sich um cqtsadmin-dbset-userdb.xml, eine XML-Datei, die vom Script cqtsadmin.pl generiert wird. Die Datei cqtsadmin-dbset-userdb.xml enthält Daten zur Implementierung der Volltextsuche. Bearbeiten Sie die Datei cqtsadmin-dbset-userdb.xml, um Ihre Implementierung abzuschließen.

Die Befehlszeilenoptionen von cqtsadmin.pl werden im Administrationshandbuch zur Volltextsuche von IBM Rational ClearQuest beschrieben. Unter Volltextsuche konfigurieren erhalten Sie Informationen dazu, wo Sie dieses Dokument finden.

Mit ClearQuest v8.0.0.5 erhalten Sie jetzt Unterstützung für die Befehlszeilenoption upgrade_solr_app, die im folgenden Abschnitt beschrieben wird.

Übersicht

cqperl cqtsadmin.pl --username Name_des_Superusers --password Kennwort --dbset Datenbankgruppe --userdb Verbindungsname --ftshome CQ-FTS-Ausgangsverzeichnis [--upgrade_solr_app]

Beschreibung

Wenn Sie ein Upgrade von ClearQuest und Ihren Implementierungen zur Volltextsuche mithilfe der Befehle prep_upgd_was_profiles und restore_was_profiles durchführen, wird für die Apache Solr-Anwendung nicht automatisch ebenfalls ein Upgrade durchgeführt. Verwenden Sie die Befehlszeilenoption upgrade_solr_app für ein Upgrade von Apache Solr auf die Version, die der Version des durchgeführten ClearQuest-Upgrades entspricht. Während des Upgrades der Apache Solr-Anwendung steht die Volltextsuche für 1 bis 5 Minuten nicht zur Verfügung.

Wenn Sie ein Upgrade für mehrere Implementierungen zur Volltextsuche durchführen, müssen Sie die Befehlszeilenoption upgrade_solr_app nacheinander für jede Implementierung einzeln durchführen.

Tipp: Ziehen Sie vor dem Upgrade der Apache Solr-Anwendung eine Sicherung Ihrer Implementierung zur Volltextsuche mithilfe der Befehlszeilenoption backup_fts in Betracht. Lesen Sie zudem in den Release-Informationen zu IBM Rational ClearQuest nach, ob die Version von ClearQuest, die Sie durch das Upgrade installieren, eine neue Version von Apache Solr enthält.

Wenn Sie nach dem Ausführen der Befehlszeilenoption upgrade_solr_app zum Erstellen eines neuen Indexes Ihrer ClearQuest-Datensätze aufgefordert werden, verwenden Sie dazu die Befehlszeilenoption fresh_batch_idx.

Beispiel

Sie müssen nach dem Upgrade von ClearQuest ein Upgrade der Apache Solr-Anwendung für eine Ihrer Implementierungen zur Volltextsuche durchführen.

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

Wenn Sie nach dem Ausführen der Befehlszeilenoption upgrade_solr_app zum Erstellen eines neuen Indexes Ihrer ClearQuest-Datenbank aufgefordert werden, führen Sie die folgenden Befehle aus. Während der Ausführung dieser Befehle steht die Volltextsuche von ClearQuest weiterhin zur Verfügung.

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

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

cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --start_update_idx
Anmerkung: Das Ausführen der Befehlszeilenoption fresh_batch_idx kann unterschiedlich lang dauern. Möglich ist eine Zeitspanne zwischen einigen Stunden und einigen Tagen. Die Dauer richtet sich nach der Anzahl an Datensätzen in Ihrer ClearQuest-Datenbank. Während der Ausführung dieses Befehls steht die Volltextsuche von ClearQuest mit allen ihren Funktionen zur Verfügung, jedoch könnte die Qualität beeinträchtigt sein.

Feedback