cqtsadmin.pl

cqtsadmin.pl automatisiert die Schritte zur Einrichtung, Konfiguration und Verwaltung der Volltextsuche von IBM® Rational ClearQuest.

Übersicht

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

Beschreibung

Das Script cqtsadmin.pl script ist eine der beiden Komponenten des Verwaltungstools für die Volltextsuche. Bei der anderen Komponente handelt es sich um die Datei cqtsadmin-dbset-userdb.xml, die vom Script cqtsadmin.pl generiert wird. Die Datei cqtsadmin-Datenbankgruppe-Benutzerdatenbank.xml enthält Daten zur Implementierung der Volltextsuche. Sie bearbeiten cqtsadmin-Datenbankgruppe-Benutzerdatenbank.xml, um Ihre Implementierung abzuschließen. Alle Befehlszeilenoptionen funktionieren unter Windows, UNIX und Linux gleich, mit Ausnahme von scrub_oplog. Diese Option ist unter UNIX und Linux nicht verfügbar.

Wichtig: Zum Ausführen des Befehls cqtsadmin.pl muss die Umgebungsvariable CQFTS_AppServer_HOME auf das Verzeichnis gesetzt sein, in dem WebSphere Application Server installiert ist. Unter bestimmten Bedingungen - beispielsweise wenn Sie ClearQuest in ein vorhandenes WebSphere Application-Profil installieren oder wenn Sie die Volltextsuche auf einem separaten System installieren, das über Fernzugriff auf ClearQuest Web-Server zugreift - ist die Umgebungsvariable CQFTS_AppServer_HOME nicht gesetzt und eine Fehlernachricht wie die folgende wird angezeigt:

Das Ausgangsverzeichnis von WebSphere AppServer kann nicht bestimmt werden. Das Benutzerhandbuch für die ClearQuest-Volltextsuche enthält Informationen darüber, wie das Verzeichnis mit der Umgebungsvariablen CQFTS_AppServer_HOME definiert wird.

Zur Behebung des Problems setzen Sie die Variable CQFTS_AppServer_HOME auf das Verzeichnis, in dem Sie WebSphere Application Server installiert haben. Definieren Sie die Variable beispielsweise wie folgt:

Unter Windows-Betriebssystemen:
set CQFTS_AppServer_HOME=C:\Programme\IBM\WebSphere\AppServer
Auf dem UNIX-System und unter Linux-Betriebssystemen:
setenv CQFTS_AppServer_HOME /opt/IBM/WebSphere/AppServer
Wichtig: Bei den Argumenten für dbset, userdb und ftshome muss die Groß-/Kleinschreibung beachtet werden. Sie müssen bei der Verwendung des Scripts cqtsadmin.pl stets die gleiche Kombination aus Groß-/Kleinbuchstaben verwenden. Andernfalls wird die Implementierung der Volltextsuche möglicherweise neu konfiguriert.

Option "ftshome"

Wenn Sie die Volltextsuche implementieren oder auf eine Implementierung verweisen, definieren die Argumente der erforderlichen Befehlszeilenoptionen ftshome, dbset und userdb die Position, an der Ihre Implementierungsdaten sich befinden. Das folgende Beispiel zeigt, wie eine neue Implementierung der ClearQuest-Volltextsuche auf Laufwerk D im Verzeichnis CQ.Search erstellt wird. Das Verzeichnis wird erstellt, wenn es nicht vorhanden ist. Das Unterverzeichnis TextSearch_SAMPL wird im vorgenannten Verzeichnis erstellt. Der Unterverzeichnisname wird auf der Basis des Namens Ihrer ClearQuest-Datenbankgruppe und des logischen Namens Ihrer ClearQuest-Benutzerdatenbank generiert. Das Unterverzeichnis enthält die Daten der Volltextsuche für diese Implementierung.

cqperl cqtsadmin.pl --username admin --password “” --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --init_cq_fts --create_fts_was_profile manual --fts_was_profile_home D:\FTS.WASprofiles

Nachdem das Verzeichnis D:\CQ.Search\TextSearch_SAMPL erstellt wurde, ist dieses die Position der Implementierung der Volltextsuche für die Datenbankgruppe TextSearch und die Benutzerdatenbank SAMPL. Alle Daten und Einstellungen, die zu dieser Implementierung gehören, werden in diesem Verzeichnis gespeichert. Nachfolgende Befehle, die Sie mit denselben Werten für die Argumente von ftshome, dbset und userdb absetzen, werden auf dieses Verzeichnis angewendet.

Zum Implementieren der Volltextsuche für eine zweite ClearQuest-Benutzerdatenbank geben Sie die erforderlichen Befehlszeilenoptionen an, die sich auf diese zweite ClearQuest-Benutzerdatenbank beziehen. Für weitere ClearQuest-Benutzerdatenbanken werden Konfigurationen für die Volltextsuche implementiert, die auf den angegebenen ftshome-Argumenten und der generierten Unterverzeichnisstruktur basieren.

cqperl cqtsadmin.pl --username admin --password “” --dbset TextSearch --userdb PROD --ftshome D:\CQ.Search --init_cq_fts --create_fts_was_profile manual --fts_was_profile_home D:\FTS.WASprofiles
Tabelle 1. Verzeichnisstruktur für die Implementierung der Volltextsuche
Verzeichnis oder Datei Beschreibung
FTS-Ausgangsverzeichnis\Datenbankgruppe_Benutzerdatenbank\logs\ Dieses Verzeichnis enthält Protokolle für jeden Befehl, den Sie mit dieser Implementierung ausführen. In diesem Verzeichnis finden Sie bei Bedarf Informationen dazu, welche Befehle Sie verwendet haben, wann Sie die Befehle ausgeführt haben und welchen Status die Befehle haben. Der IBM Software Support untersucht möglicherweise diese Protokolle, wenn er mit Ihnen gemeinsam ein Problem behebt. Die Kennwörter werden in den Protokollen und in der Ausgabe am Bildschirm durch Sterne (*) ersetzt und nicht im Klartext dargestellt.
FTS-Ausgangsverzeichnis\Datenbankgruppe_Benutzerdatenbank\Solr\solr\conf\schema.xml Diese Datei ist eine der Konfigurationsdateien, mit denen die Suchmaschine feststellt, welche Felder indexiert und durchsucht werden sollen. Wird der Befehl cust_solr_files abgesetzt, werden die Felder in dieser Datei so angepasst, dass sie mit den Feldern in Ihren Datensatztypen übereinstimmen, die durch Ihre Entitätsdatei angegebenen sind.

Eventuell müssen Sie diese Datei bearbeiten, um sie weiter anzupassen, wenn Ihre ClearQuest-Datenbank nicht in Englisch vorliegt. Weitere Informationen finden Sie in Volltextsuche für eine Datenbank in einer anderen Sprache als Englisch aktivieren.

FTS-Ausgangsverzeichnis\Datenbankgruppe_Benutzerdatenbank\Solr\solr\data\index\ Dieses Verzeichnis enthält den eigentlichen Index Ihrer Implementierung.
Achtung: Ändern Sie den Inhalt dieses Verzeichnisses nicht. Änderungen an diesem Verzeichnis können die Integrität Ihrer Implementierung beeinträchtigen und eine erneute Indexierung oder Implementierung erfordern.
FTS-Ausgangsverzeichnis\Datenbankgruppe_Benutzerdatenbank\AboutThisFTS.txt Diese Datei wird ein einziges Mal während der ursprünglichen Implementierung der Volltextsuche generiert. Sie enthält Informationen zu der Implementierung, die Sie eventuell benötigen. Der IBM Software Support untersucht möglicherweise diese Datei, wenn er mit Ihnen gemeinsam ein Problem behebt.
FTS-Ausgangsverzeichnis\Datenbankgruppe_Benutzerdatenbank\CQ-Datenbankgruppe-Benutzerdatenbank.xml Diese XML-Datei enthält die Eigenschaften der ClearQuest-Volltextsuche. Die Datei enthält Daten zur Indexierung im Stapel- und Aktualisierungsmodus, zum Suchserver, zum Verbindungsprofil und zu den Datensatztypen und Feldern, die indexiert und durchsucht werden sollen. Der IBM Software Support untersucht diese Datei, wenn er mit Ihnen gemeinsam ein Problem behebt.
FTS-Ausgangsverzeichnis\Datenbankgruppe_Benutzerdatenbank\cqtsadmin-Datenbankgruppe-Benutzerdatenbank.xml Diese Datei enthält die Administratorkonfiguration der Volltextsuche. Sie enthält Daten zu Ihrer Implementierung. Die meisten Daten werden während der Implementierung definiert; Sie müssen diese Datei jedoch eventuell bearbeiten, um einige Einstellungen anzupassen. Der IBM Software Support untersucht diese Datei, wenn er mit Ihnen gemeinsam ein Problem behebt.
FTS-Ausgangsverzeichnis\Datenbankgruppe_Benutzerdatenbank\Entity-Datenbankgruppe-Benutzerdatenbank.txt Die Entitätsdatei enthält eine Liste der Entitätstypen und der zugehörigen Felder, für die die Suche aktiviert ist. Während der Implementierung müssen Sie diese Datei möglicherweise bearbeiten, um Datensatztypen und Felder zu entfernen, die nicht durchsucht werden sollen. Nach dem Abschluss der Implementierung bearbeiten Sie diese Datei nicht mehr. Der IBM Software Support untersucht diese Datei, wenn er mit Ihnen gemeinsam ein Problem behebt.

Unterstützung landessprachlicher Versionen

Um cqtsadmin.pl auf einem anderen als einem englischen Betriebssystem verwenden zu können, legen Sie für die Systemumgebungsvariable LANGUAGE eine der folgenden unterstützten Werte fest:

Wenn für LANGUAGE ein nicht unterstützter Wert angegeben wird, schlägt cqtsadmin.pl mit einer Fehlernachricht fehl.

Optionen und Argumente

Das Script cqtsadmin.pl verfügt über erforderliche und optionale Befehlszeilenoptionen. Sie müssen die erforderlichen Befehlszeilenoptionen bei jeder Ausführung des Scripts cqtsadmin.pl bereitstellen. Ist einer der Parameter für die erforderlichen Optionen falsch, schlägt das Tool mit einer Fehlernachricht fehl. Das Tool authentifiziert den Benutzer anhand der ClearQuest-Datenbank, bevor Aktionen ausgeführt werden. Sie müssen mindestens eine optionale Befehlszeilenoption angeben, wenn Sie das Script cqtsadmin.pl ausführen.

Erforderliche Befehlszeilenoptionen
username Name_des_Superusers
Name des ClearQuest-Benutzers mit Superuser-Berechtigung
password Kennwort
ClearQuest-Benutzerkennwort
dbset Datenbankgruppe
Name der ClearQuest-Datenbankgruppe. Bei dem Wert muss die Groß-/Kleinschreibung beachtet werden.
userdb Verbindungsname
Name der ClearQuest-Benutzerdatenbank. Bei dem Wert muss die Groß-/Kleinschreibung beachtet werden.
ftshome CQ-FTS-Ausgangsverzeichnis
Ausgangsverzeichnis für die ClearQuest-Volltextsuche. Dieses Verzeichnis enthält alle zu dieser Implementierung gehörigen Konfigurationsdateien sowie die Solr-Dateien, die Einstellungen und den Lucene-Index. Bei dem Wert muss die Groß-/Kleinschreibung beachtet werden.

Optionale Befehlszeilenoptionen

Die optionalen Befehlszeilenoptionen führen bestimmte Aktionen mit der Implementierung der ClearQuest-Volltextsuche aus. Alle Befehle generieren Ausgabe in Form von Informationen, Fortschrittsangaben, Warnungen, Fehlern und Anweisungen. Die Ausgabe von Anweisungen hilft Ihnen bei der Behebung eines Fehlers. Die Terminalanzeige wird auch im Protokollverzeichnis aufgezeichnet. Diese Protokolldaten sind hilfreich, wenn Sie versuchen, in einer Implementierung einen Fehler zu beheben oder Ihre Aktionen zu verfolgen, da Sie die Ausgabe am Bildschirm nicht in eine Datei umleiten müssen. In der Regel schlagen Befehle nicht fehl. Ist dies dennoch einmal der Fall, machen die meisten Befehle alle Änderungen rückgängig. Kann eine Änderung nicht rückgängig gemacht werden, wird eine Fehlernachricht mit Anweisungen zu durchzuführenden Maßnahmen angezeigt. Sie können eine optionale Befehlszeilenoption mehrfach absetzen. Werden mehrere optionale Befehlszeilenoptionen angegeben, werden sie in der Reihenfolge ausgeführt, in der sie in der Befehlszeile stehen. Schlägt eine Option fehl, werden die nachfolgenden Befehle nicht ausgewertet oder ausgeführt und das Tool wird mit einer Fehlernachricht beendet. Die optionalen Befehlszeilenoptionen können in zwei Kategorien eingeteilt werden: häufig verwendete und selten verwendete Optionen.

add_record_type
Übersicht
Fügt dem Index mindestens einen neuen Datensatztyp hinzu. Diese Option inaktiviert die Volltextsuche für ClearQuest Web-Benutzer temporär, während der Befehl ausgeführt wird. Die Liste der neuen Datensatztypen und der zugehörigen Felder wird über den Tag <addRecordType> angegeben, der sich in der Administratorkonfigurationsdatei für die Volltextsuche befindet.
Verwendung
Verwenden Sie diese Befehlszeilenoption, um einen Datensatztyp hinzuzufügen, wenn Sie bei der ursprünglichen Implementierung der Volltextsuche einen Datensatztyp vergessen haben oder wenn Sie Ihrem ClearQuest-Schema nach der ursprünglichen Implementierung einen neuen Datensatztyp hinzugefügt haben und der neue Datensatztyp durchsucht werden soll. Verwenden Sie diesen Befehl, wenn Sie ein Feld in einem bereits indexierten Datensatztyp umbenannt, hinzugefügt oder entfernt haben. Wenn die Änderung sich in Ihrem Index widerspiegeln soll, setzen Sie den Befehl remove_record_type ab, um den Datensatztyp zu entfernen. Anschließend setzen Sie diesen Befehl ab, um ihn erneut hinzuzufügen. Zum Hinzufügen von zwei oder mehr Datensatztypen verwenden Sie ein Semikolon als Trennzeichen. Mit dem folgenden Code werden beispielsweise die Datensatztypen "Customer" und "Product" hinzugefügt.

<newValue required="no">Customer=CustomerNum,address,phone,product;Product=name,version</newValue>

Wenn Sie einen Datensatztyp ohne Feldliste auflisten, werden alle Felder dieses Datensatztyps hinzugefügt. Im folgenden Beispiel werden alle Felder für die Datensatztypen "Customer" und "Product" hinzugefügt.

<newValue required="no">Customer;Product</newValue>
Auswirkungen
Dieser Befehl wirkt sich auf den Index der ClearQuest-Volltextsuche, die XML-Datei mit den Eigenschaften der ClearQuest-Volltextsuche, die Entitätsdatei und die Solr-Datei schema.xml aus. Sichern Sie Ihre Implementierung, bevor Sie diesen Befehl absetzen. Führen Sie diese Option zu Zeiten geringer Systemauslastung aus. Die Operation ist zeitaufwendig und verursacht eine kurze Ausfallzeit für die Volltextsuche.
Zustandsüberwachungsstatus
Der Befehl umfasst Zustandsüberwachung. Wenn der Befehl bei einem seiner Ausführungspunkte fehlschlägt, müssten Sie in der Lage sein, das Problem zu beheben und anschließend den Befehl erneut auszuführen. Die Operation wird an dem Punkt fortgesetzt, an dem sie gestoppt wurde. Tritt ein Fehler auf, werden Sie mit einer Fehlernachricht über durchzuführende Maßnahmen informiert.
Beispiel
Sie müssen einen neuen Datensatztyp mit dem Namen "Customer" hinzufügen.
  1. Bearbeiten Sie die Datei cqtsadmin-TextSearch-SAMPL.xml und ändern Sie den Tag <addRecordType>.

    <newValue required="no">Customer=CustomerNum,address,phone,product</newValue>

  2. Erstellen Sie eine Sicherung.

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

  3. Fügen Sie den neuen Datensatztyp hinzu.

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

  4. Bearbeiten Sie die Datei cqtsadmin-TextSearch-SAMPL.xml und entfernen Sie den Text, den Sie dem Tag <addRecordType> hinzugefügt haben. Dieser Schritt dient hauptsächlich der Bereinigung.
archive_fts
Übersicht
Archiviert eine Implementierung der ClearQuest-Volltextsuche. Diese Option inaktiviert die aktive Implementierung der Volltextsuche und entfernt anschließend ein implementiertes WebSphere Application Server-Profil. Alle Konfigurationsdaten und der Index bleiben erhalten. Diese Option kann verwendet werden, um mit der Einrichtung einer neuen Konfiguration zu beginnen und die alte Konfiguration als Referenz zu nutzen.
Verwendung
Verwenden Sie diese Befehlszeilenoption, um eine neue Implementierung zu starten oder wenn Sie das Feature Volltextsuche einer Implementierung nicht mehr benötigen. Diese Befehlszeilenoption stoppt alle Services der Volltextsuche und archiviert alle relevanten Ressourcen wie Services und Dateien. Sie können die Implementierung nach der Archivierung als Referenz verwenden.
Anmerkung: Verwenden Sie diese Befehlszeilenoption nicht, wenn Sie eine zukünftige Wiederherstellung planen. Verwenden Sie in diesem Fall stattdessen die Befehlszeilenoption prep_upgd_was_profiles.
Auswirkungen
Diese Befehlszeilenoption inaktiviert die Volltextsuche. Außerdem entfernt und löscht sie alle Dateien, Ressourcen und Einstellungen, die unter WebSphere Application Server für diese Implementierung verwendet und definiert wurden. Die Implementierungsdaten unter dem FTS-Ausgangsverzeichnis bleiben intakt; sie werden jedoch in Datenbankgruppe_Benutzerdatenbank.Archived-Zeitmarke umbenannt.
Zustandsüberwachungsstatus
Diese Option umfasst keine Zustandsüberwachung. Wenn der Befehl bei einem seiner Ausführungspunkte fehlschlägt, müssen Sie die Archivierung möglicherweise manuell ausführen. Anhand eines Fortschrittsberichts und einer Fehlernachricht werden Sie informiert, wie Sie den Fehler beheben können.
Beispiel
Das folgende Beispiel zeigt, wie eine Implementierung archiviert wird.

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

Nach der Ausführung des Scripts lautet der Name der archivierten Implementierung der Volltextsuche wie folgt: D:\CQ.Search\TextSearch_SAMPL.Archived-Zeitmarke.

backup_fts Ziel
Übersicht
Erstellt eine Sicherungskopie Ihrer Implementierung der ClearQuest-Volltextsuche. Nachdem eine Sicherung erstellt wurde, können Sie Daten aus der Sicherung oder aus der gesamten Implementierung wiederherstellen. Für optimale Ergebnisse empfiehlt es sich, eine Sicherung zu erstellen, bevor Befehle ausgeführt werden, die die vorhandene Implementierung erheblich ändern. Vergewissern Sie sich vor der Sicherung Ihrer Implementierung, dass an der Sicherungsposition ebenso viel Plattenspeicherplatz verfügbar ist wie Ihre Implementierung im FTS-Ausgangsverzeichnis belegt.
Verwendung
Verwenden Sie diesen Befehl, um eine Sicherung zu erstellen, wenn Sie einen Datensatztyp hinzufügen oder aktualisieren oder wenn Ihre organisationsbezogene Richtlinie erfordert, dass Sie regelmäßig Sicherungen erstellen.
Anmerkung: Verwenden Sie diesen Befehl nicht anstelle der Befehlszeilenoption prep_upgd_was_profiles. Diese sichert zusätzlich die WebSphere Application Server-Profile für jede Benutzerdatenbank.
Auswirkungen
Dieser Befehl inaktiviert temporär den Indexer im Aktualisierungsmodus, während die Sicherung stattfindet. Während der Dauer der Sicherung sind die Ergebnisse der Volltextsuche möglicherweise nicht aktuell. Die Dauer ist von der Größe des Index, von der Geschwindigkeit der Festplatte und vom Netz abhängig, wenn Sie über ein LAN oder WAN sichern.
Zustandsüberwachungsstatus
Diese Option umfasst keine Zustandsüberwachung. Wenn der Befehl bei einem seiner Ausführungspunkte fehlschlägt, müssen Sie die Sicherung manuell ausführen oder von vorne beginnen, je nach dem Fehlertyp und der Fehlernachricht, die ausgegeben wird. Der wahrscheinlichste Fehler ist, dass auf dem Zielgerät nicht genügend Plattenspeicherplatz verfügbar ist. Während der Sicherung werden keine Implementierungsdaten geändert.
Beispiel
Sie möchten eine Sicherung Ihrer Implementierung erstellen, bevor Sie neue Datensatztypen hinzufügen.

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

Nach der Ausführung des Scripts lautet der Name der archivierten Implementierung der Volltextsuche wie folgt: E:\FTSBackup\TextSearch_SAMPL.Backup-Zeitmarke.

clear_state
Übersicht
Setzt den Status in der Prozedur des Tools cqtsadmin.pl zurück, sodass kein Status vorhanden ist. Jeder Status, in dem das Tool sich befunden hat (möglicherweise ein unvollständiger Status), wird gelöscht.
Verwendung
Verwenden Sie diese Befehlszeilenoption, um den Status eines Befehls mit Zustandsüberwachung zu löschen, damit Sie weitere Befehle ausgeben oder den Befehl mit Zustandsüberwachung erneut absetzen können. Wie viel Zeit das Löschen des Status in Anspruch nimmt, ist von den folgenden Faktoren abhängig: von dem Befehl mit Zustandsüberwachung, um den es sich handelt; von dem Status, in dem der Befehl mit Zustandsüberwachung sich zuletzt befunden hat; von der Fehlernachricht und den angegebenen Anweisungen für die Fehlerbehebung.
Auswirkungen
Die Auswirkungen der Ausführung dieser Befehlszeilenoption sind davon abhängig, welcher Befehl mit Zustandsüberwachung gestoppt wurde und wie weit die Befehlsverarbeitung fortgeschritten war, als sie gestoppt wurde. Dem Protokoll und der Fehlernachricht können Sie entnehmen, ob Sie den Status zurücksetzen können.
Zustandsüberwachungsstatus
Diese Option umfasst keine Zustandsüberwachung. Dieser Befehl sollte niemals fehlschlagen; es sei denn, es liegt ein E/A-Fehler vor.
Beispiel
Die Anweisungen in der Fehlernachricht geben an, dass Sie den Status einer Aktion mit Zustandsüberwachung löschen müssen, damit Sie nach einen nicht behebbaren Fehler die Arbeit fortsetzen können.

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

copy_fts_template
Übersicht
Kopiert und definiert die Standardschablone für die ClearQuest-Volltextsuche. Wenn Sie die Volltextsuche auf einer Datenbank implementieren, die noch nicht für die Volltextsuche aktiviert ist, müssen Sie mit einer frischen Standardschablone beginnen, die Sie in Ihr ftshome-Verzeichnis kopieren. Wenn Sie versuchen, diesen Befehl auf einer vorhandenen Implementierung zu verwenden, tritt ein Fehler auf.
Verwendung
Im Allgemeinen müssen Sie diese Befehlszeilenoption nicht explizit verwenden, weil sie aufgerufen wird, wenn Sie die Befehlszeilenoption init_cq_fts absetzen. Diese Befehlszeilenoption wird für den Fall bereitgestellt, dass Sie Ihre Implementierung optimieren oder Fehler beheben müssen.
Auswirkungen
Diese Befehlszeilenoption kopiert die Standarddaten, die für die Volltextsuche erforderlich sind, in das angegebene FTS-Ausgangsverzeichnis.
Zustandsüberwachungsstatus
Diese Option umfasst keine Zustandsüberwachung. Dieser Befehl sollte niemals fehlschlagen; es sei denn, es liegt ein E/A-Fehler vor.
Beispiel
Die IBM Rational-Kundenunterstützung hat Sie angewiesen, diesen Befehl abzusetzen, um ein Implementierungsproblem zu beheben oder eine Implementierung anzupassen.

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

create_fts_was_profile Starttyp { manual | automatic | disabled }
Übersicht
Erstellt ein WebSphere Application Server-Profil für die ClearQuest-Volltextsuche. Ist für alle neuen Implementierungen erforderlich.
Verwendung

Jede Implementierung der ClearQuest-Volltextsuche muss über ein eigenes WebSphere Application Server-Profil verfügen, und zwar über je ein WebSphere Application Server-Profil für jede Benutzerdatenbank, die für die ClearQuest-Volltextsuche aktiviert ist.

Der Parameterwert konfiguriert nur für Implementierungen unter Windows-Betriebssystemen einen Starttyp für den Windows-Dienst. Unter UNIX- und Linux-Betriebssystemen wird dieser Wert ignoriert und Sie müssen das WebSphere Application Server-Profil so konfigurieren, dass es zur Bootzeit als Dämon gestartet wird.

Der Name des WebSphere Application Server-Profils wird vom Namen der Datenbankgruppe und Benutzerdatenbank abgeleitet. Sie können diesen Namen jedoch mit dem Tag <ftsWASProfileName> überschreiben.

Geben Sie die Position für die Erstellung des WebSphere Application Server-Profils mit der Befehlszeilenoption fts_was_profile_home an. Wenn Sie die Position nicht angeben, wird die Standardposition %CLEARQUEST_HOME%/cqweb/ verwendet. Geben Sie für optimale Ergebnisse eine Position an.

Anmerkung: Verwenden Sie diese Befehlszeilenoption immer in Kombination mit der Befehlszeilenoption init_cq_fts, damit ein WebSphere Application Server-Profil erstellt und auf der Basis Ihrer Implementierung der ClearQuest-Volltextsuche angepasst wird. Andernfalls schlägt die Implementierung fehl; es sei denn, das WebSphere Application Server-Profil wurde zuvor mit diesem Tool erstellt und wird wiederverwendet.
Auswirkungen
Mit dieser Befehlszeilenoption wird ein neues WebSphere Application Server-Profil unter dem WebSphere Application Server erstellt und der nächste verfügbare Port verwendet. Nach dem Abschluss der Operation sind etwa 200 MB des Plattenspeicherplatzes belegt. Ist das Profil unter Windows auf "automatic" gesetzt, wird der Dienst automatisch gestartet, wenn Windows erneut gestartet wird.
Zustandsüberwachungsstatus
Diese Option umfasst keine Zustandsüberwachung. Dieser Befehl sollte niemals fehlschlagen; es sei denn, es liegt ein E/A-Fehler vor.
Beispiel
Sie möchten die Volltextsuche für eine zweite Benutzerdatenbank implementieren. Der Name der Datenbankgruppe ist MASTR und der Name der Benutzerdatenbank ist SAMPL.
  1. Setzen Sie den folgenden Befehl ab, um eine ursprüngliche Implementierung einzurichten.

    cqperl cqtsadmin.pl --username admin --password "" --dbset MASTR --userdb SAMPL --ftshome D:\CQ.Search --init_cq_fts --create_fts_was_profile automatic --fts_was_profile_home D:\FTS.WASprofiles

  2. Ändern Sie die Entitätsdatei so, dass sie nur die Datensatztypen und Felder enthält, die durchsucht werden sollen.
  3. Setzen Sie diesen Befehl ab, um Ihre Implementierung abzuschließen.

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

cust_fts_files
Übersicht
Passt die XML-Datei mit den Eigenschaften der ClearQuest-Volltextsuche auf der Basis der Benutzerdatenbank, der Entitätsdatei und der Administratorkonfigurationsdatei für die Volltextsuche an. Wenn Sie die ClearQuest-Volltextsuche zum ersten Mal implementieren, müssen Sie die Eigenschaftendatei CQ-Datenbankgruppe-Benutzerdatenbank.xml für die Volltextsuche anpassen.
Verwendung
Die Standardschablone für die Volltextsuche enthält generische Einstellungen, die Sie auf der Basis Ihrer Benutzerdatenbank anpassen. Eine der Dateien, die Sie anpassen müssen, ist die XML-Datei mit den Eigenschaften der Volltextsuche. Diese Datei umfasst eine Liste aller Datensatztypen und der zugehörigen Felder, die auf den Angaben in Ihrer Entitätsdatei basieren. Außerdem enthält die Datei Parameter wie das als Anzeigefeld zu verwendende Feld, das Intervall für die Überprüfung der ClearQuest-Benutzerdatenbank auf Änderungen und die Art der Kommunikation mit der Datenbank und dem Server für ClearQuest. Im Allgemeinen müssen Sie diese Befehlszeilenoption nicht explizit verwenden, weil sie aufgerufen wird, wenn Sie die Befehlszeilenoption setup_cq_fts absetzen. Diese Befehlszeilenoption wird für den Fall bereitgestellt, dass Sie Ihre Implementierung optimieren oder Fehler beheben müssen.
Auswirkungen
Wenn Sie diese Befehlszeilenoption in einer Implementierung verwenden, wird die Datei CQ-Datenbankgruppe-Benutzerdatenbank.xml überschrieben. Alle Änderungen, die entweder manuell oder durch Absetzen von Befehlen an der Datei vorgenommen wurden, gehen verloren.
Zustandsüberwachungsstatus
Diese Option umfasst keine Zustandsüberwachung. Dieser Befehl sollte niemals fehlschlagen; es sei denn, es liegt ein E/A-Fehler vor.
Beispiel
Der IBM Software Support fordert Sie auf, ein Problem in einer Implementierung der Volltextsuche zu beheben oder eine Implementierung anzupassen.

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

cust_solr_files
Übersicht
Wenn Sie die ClearQuest-Volltextsuche zum ersten Mal implementieren, müssen Sie die Solr-Schemadatei anpassen, die auf Ihrer aktuellen ClearQuest-Entitätsdatei basiert.
Verwendung
Die Standardschablone für die Volltextsuche ist generisch und enthält Standardeinstellungen, die Sie auf der Basis Ihrer Benutzerdatenbank anpassen müssen. Eine der Dateien, die Sie anpassen müssen, ist die Datei Solr schema.xml. Diese Datei enthält alle Felder aller Datensatztypen, die Sie unter Verwendung der Entitätsdatei als durchsuchbar definiert haben. Im Allgemeinen müssen Sie diese Befehlszeilenoption nicht explizit verwenden, weil sie aufgerufen wird, wenn Sie die Befehlszeilenoption setup_cq_fts absetzen. Diese Befehlszeilenoption wird für den Fall bereitgestellt, dass Sie Ihre Implementierung optimieren oder Fehler beheben müssen.
Auswirkungen
Diese Befehlszeilenoption liest Daten aus Ihrer Entitätsdatei und passt anschließend die Datei Solr schema.xml an. Wenn Sie diese Option auf einer vorhandenen Implementierung verwenden, wird die Datei schema.xml geändert. Falls Sie die Entitätsdateien nach der ursprünglichen Implementierung geändert haben, gehen die vorherigen Werte verloren.
Zustandsüberwachungsstatus
Diese Option umfasst keine Zustandsüberwachung. Dieser Befehl sollte niemals fehlschlagen; es sei denn, es liegt ein E/A-Fehler vor.
Beispiel
Der IBM Software Support fordert Sie auf, ein Problem in einer Implementierung der Volltextsuche zu beheben oder eine Implementierung anzupassen.

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

delete_fts_was_profile
Übersicht
Führen Sie diese Befehlszeilenoption aus, um ein WebSphere Application Server-Profil zu löschen oder um von vorne zu beginnen. Sie löscht das WebSphere Application Server-Profil für die ClearQuest-Volltextsuche, das dieser Implementierung der ClearQuest-Volltextsuche zugeordnet ist. Der Unterschied zwischen dieser Option und archive_fts besteht darin, dass nur das WebSphere Application Server-Profil gelöscht wird. Das Ausgangsverzeichnis für die Volltextsuche und die zugehörigen Metadaten werden nicht entfernt. Soll eine Implementierung der ClearQuest-Volltextsuche vollständig gelöscht werden, verwenden Sie stattdessen die Option archive_fts.
Verwendung
Im Allgemeinen verwenden Sie diesen Befehl nicht explizit, weil er aufgerufen wird, wenn Sie die Befehlszeilenoption archive_fts absetzen. Dieser Befehl wird für den Fall bereitgestellt, dass Sie Ihre Implementierung optimieren oder Fehler beheben müssen.
Auswirkungen
Die von WebSphere für dieses WebSphere Application Server-Profil verwendeten Ressourcen werden freigegeben. Wurde die ClearQuest Web-Volltextsuche nicht mit der Befehlszeilenoption disable_cqweb_fts inaktiviert, führen Volltextsuchen zu Fehlern.
Zustandsüberwachungsstatus
Diese Option umfasst keine Zustandsüberwachung. Dieser Befehl sollte niemals fehlschlagen; es sei denn, es liegt ein E/A-Fehler vor.
Beispiel
Sie müssen die Position Ihres WebSphere Application Server-Profils umbenennen oder ändern, möchten jedoch Ihre Lösung für die Volltextsuche nicht vollständig neu implementieren.
  1. Löschen Sie das WebSphere Application Server-Profil.

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

  2. Bearbeiten Sie die Datei cqtsadmin-dbset-userdb.xml und ändern Sie den automatisch generierten Standardnamen im Tag <ftsWASProfileName> in den neuen Namen für das WebSphere Application Server-Profil. Der Name muss eindeutig sein. Andernfalls schlägt der Befehl fehl.
  3. Erstellen Sie das WebSphere Application Server-Profil erneut.

    cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --create_fts_was_profile automatic --fts_was_profile_home D:\FTS.WASprofiles

  4. Falls auch die Portnummer für dieses WebSphere Application Server-Profil geändert werden soll, bearbeiten Sie die Datei cqtsadmin-dbset-userdb.xml und aktualisieren Sie die Portnummer im Tag <ftsWASProfilePort>, bevor Sie den obigen Schritt 3 ausführen. Sie können auch den folgenden Befehl absetzen, um die Ports neu zu definieren:

    cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --create_fts_was_profile automatic --fts_was_profile_home D:\FTS.WASprofiles --was_profile_ports_file D:\CQ.Search\TextSearch_SAMPL\cqftsportdef.props

disable_cqweb_fts
Übersicht
Diese Befehlszeilenoption inaktiviert das Optionsfeld Vollständiger Text in ClearQuest Web und stoppt die Aufzeichnung von Operationsprotokollen (Oplogs) in einer nicht replizierten ClearQuest-Benutzerdatenbank. Diese Befehlszeilenoption hat keine Auswirkungen auf die Erstellung von Oplogs in replizierten Umgebungen.
Achtung: Verwenden Sie diese Befehlszeilenoption vorsichtig. Sie inaktiviert die Aufzeichnung von Oplogs, wenn Ihre ClearQuest-Datenbank nicht repliziert wird. Werden ClearQuest-Datensätze geändert und keine Oplogs generiert, werden die geänderten Datensätze nicht neu indexiert. Sie müssen die gesamte Benutzerdatenbank neu indexieren. Blockieren Sie entweder den Benutzerzugriff auf ClearQuest oder gestatten Sie nur Leseoperationen, bis die Volltextsuche wieder aktiviert ist.
Verwendung
Sie brauchen diesen Befehl nicht zu verwenden; es sei denn, Sie befinden sich in einer Testumgebung oder der IBM Software Support erteilt eine entsprechende Anweisung.
Auswirkungen
Die Erstellung von Oplogs wird gestoppt, wenn Ihre Datenbank nicht repliziert wird, und das Optionsfeld "Vollständiger Text" wird inaktiviert.
Zustandsüberwachungsstatus
Diese Option umfasst keine Zustandsüberwachung. Dieser Befehl sollte niemals fehlschlagen; es sei denn, es liegt ein E/A-Fehler vor.
Beispiel
Die IBM Rational-Kundenunterstützung weist Sie an, die Volltextsuche zu inaktivieren, damit Sie Probleme beheben können.

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

enable_cqweb_fts
Übersicht
Aktiviert das Optionsfeld Vollständiger Text in ClearQuest Web. Außerdem wird die Erstellung von Oplogs aktiviert, wenn Ihre ClearQuest-Datenbank nicht repliziert wird und Produktstufe 7 aufweist. Wird Ihre ClearQuest-Benutzerdatenbank repliziert, wird keine Änderung an der Erstellung von Oplogs vorgenommen. Falls Ihre Implementierung nicht ordnungsgemäß konfiguriert ist, werden Fehlernachrichten ausgegeben, wenn Benutzer versuchen, die Volltextsuche zu verwenden.
Verwendung
Sie brauchen diesen Befehl nicht zu verwenden; es sei denn, Sie befinden sich in einer Testumgebung oder der IBM Software Support erteilt eine entsprechende Anweisung.
Auswirkungen
Die Erstellung von Oplogs wird gestartet, wenn Ihre Datenbank nicht repliziert wird und die Produktstufe 7 aufweist. Das Optionsfeld "Vollständiger Text" in ClearQuest Web wird aktiviert.
Zustandsüberwachungsstatus
Diese Option umfasst keine Zustandsüberwachung. Dieser Befehl sollte niemals fehlschlagen; es sei denn, es liegt ein E/A-Fehler vor.
Beispiel
Der IBM Software Support weist Sie an, die Volltextsuche zu aktivieren, damit Sie Probleme beheben können.

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

fresh_batch_idx
Übersicht
Mit dieser Befehlszeilenoption können Sie nach der ursprünglichen Indexierung eine vollständige Neuindexierung im Stapelmodus erzwingen. Als Indexierung im Stapelmodus wird der Prozess bezeichnet, durch den alle für die Suche konfigurierten ClearQuest-Datensätze gelesen und die Daten dieser Datensätze zur Indexierung an die Suchmaschine (Solr) gesendet werden. Die Indexierung im Stapelmodus wird als Bestandteil der Ausführung der Befehlszeilenoption setup_cq_fts ausgeführt. Setzen Sie vor der Ausgabe dieses Befehls die Befehlszeilenoption stop_update_idx ab, um den Indexer im Aktualisierungsmodus zu stoppen. Andernfalls ersetzt der Indexer im Stapelmodus möglicherweise die Daten eines neueren Datensatzes, der vom Indexer im Aktualisierungsmodus indexiert wurde. Nach Abschluss der erneuten Indexierung ist der Index fragmentiert. In der Regel beeinträchtigt diese Fragmentierung die Leistung bei Ihren Suchvorgängen nicht. Die Indexgröße kann jedoch bis auf das Doppelte der aktuellen Größe anwachsen. Führen Sie die Befehlszeilenoption optimize_idx aus, um den Index zu optimieren und seine Größe zu reduzieren.
Verwendung
Sie brauchen diesen Befehl nicht zu verwenden; es sei denn, Sie befinden sich in einer Testumgebung oder der IBM Software Support erteilt eine entsprechende Anweisung.
Auswirkungen
Der Suchindex wird aktualisiert. Seine Größe kann auf das Doppelte der aktuellen Größe anwachsen. Stellen Sie daher vor der Verwendung dieses Befehls sicher, dass genügend Plattenspeicherplatz verfügbar ist. Während der erneuten Indexierung sind die Suchergebnisse möglicherweise unvollständig, da der Indexer im Aktualisierungsmodus inaktiviert ist.
Zustandsüberwachungsstatus
Diese Option umfasst keine Zustandsüberwachung. Dieser Befehl sollte niemals fehlschlagen; es sei denn, es liegt ein E/A-Fehler vor.
Beispiel
Der IBM Software Support weist Sie an, die durchsuchbaren Datensätze vollständig neu zu indexieren.
  1. Stoppen Sie den Indexer im Aktualisierungsmodus.

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

  2. Erzwingen Sie die erneute Indexierung im Stapelmodus.

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

  3. Führen Sie die Indexoptimierung aus.

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

  4. Aktivieren Sie den Indexer im Aktualisierungsmodus.

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

    Anmerkung: Diese Schritte können Sie in einem einzigen Befehl kombinieren. Dies empfiehlt sich möglicherweise, da diese Operation längere Zeit dauern kann, wenn viele Datensätze neu indexiert werden.

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

fresh_update_idx
Übersicht
Erzwingt eine vollständige Neuindexierung aller in Oplogs aufgezeichneten Datensatzänderungen durch den Indexer im Aktualisierungsmodus. Verwenden Sie diese Option vorsichtig. Der Indexer im Aktualisierungsmodus arbeitet im Einzelthreadbetrieb. Diese Operation kann lange Zeit dauern, besonders wenn Ihre ClearQuest-Datenbank viele Oplogs enthält.

Als Indexierung im Aktualisierungsmodus wird der Prozess bezeichnet, durch den die ClearQuest-Datenbank auf Änderungen bei den Datensatztypen überwacht wird, die für die Suche konfiguriert sind. Die Überwachung wird durch die Überprüfung auf Oplogs in der ClearQuest-Datenbank ausgeführt. Die Indexierung im Aktualisierungsmodus wird als Bestandteil der Befehlszeilenoption setup_cq_fts aktiviert. Im Gegensatz zur Befehlszeilenoption fresh_batch_idx erfordert dieser Befehl nicht, dass Sie den Indexer im Aktualisierungsmodus stoppen. Wird dieser Befehl mit einem gefüllten Index ausgeführt, ist der Index anschließend fragmentiert. In der Regel beeinträchtigt diese Fragmentierung die Leistung bei Ihren Suchvorgängen nicht. Die Indexgröße kann jedoch bis auf das Doppelte der aktuellen Größe anwachsen. Führen Sie die Befehlszeilenoption optimize_idx aus, um den Index zu optimieren und seine Größe zu reduzieren. Überlegen Sie sorgfältig, ob der Indexer im Aktualisierungsmodus ab dem ersten aufgezeichneten Oplog gestartet werden soll. Mit der Zeit sammeln sich sehr viele Oplogs an, da für jede mit einem ClearQuest-Datensatz ausgeführte Aktion ein Oplog aufgezeichnet wird. Daher ist es eventuell nicht sinnvoll, die Indexierung mit dem ersten aufgezeichneten Oplog zu beginnen, besonders wenn die Oplogs nicht konsistent bereinigt wurden. Dieser Befehl ist für Testumgebungen und für die Problembehebung bei Implementierungen der Volltextsuche in Zusammenarbeit mit der IBM Rational-Kundenunterstützung konzipiert.

Verwendung
Sie brauchen diesen Befehl nicht zu verwenden; es sei denn, Sie befinden sich in einer Testumgebung oder der IBM Software Support erteilt eine entsprechende Anweisung.
Auswirkungen
Der Suchindex wird aktualisiert. Seine Größe kann auf das Doppelte der aktuellen Größe anwachsen. Stellen Sie vor der Verwendung dieses Befehls sicher, dass genügend Plattenspeicherplatz verfügbar ist.
Zustandsüberwachungsstatus
Diese Option umfasst keine Zustandsüberwachung. Dieser Befehl sollte niemals fehlschlagen; es sei denn, es liegt ein E/A-Fehler vor.
Beispiel
Der IBM Software Support weist Sie an, eine erneute Indexierung des Indexers im Aktualisierungsmodus zu erzwingen.

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

fts_was_profile_home Ziel
Übersicht
Verwenden Sie diese Befehlszeilenoption in Kombination mit der Befehlszeilenoption create_fts_was_profile, um anzugeben, wo das WebSphere Application Server-Profil für diese Implementierung der ClearQuest-Volltextsuche erstellt werden soll. Wenn Sie diese Option nicht angeben, wird die Standardposition ${CLEARQUEST_HOME}/cqweb/ verwendet. Die Standardposition ist nicht immer geeignet, da zusätzliche Dateien, die im ClearQuest-Installationsverzeichnis erstellt werden, möglicherweise Konflikte mit der ClearQuest-Installation verursachen, beispielsweise bei der Deinstallation oder Aktualisierung. Diese Befehlszeilenoption kann auch in Kombination mit der Befehlszeilenoption restore_was_profile verwendet werden. Sie können eine Position für die Erstellung der WebSphere Application Server-Profile für die Volltextsuche angeben, die sich von der ursprünglichen Position unterscheidet.
Verwendung
Sie möchten die ClearQuest-Volltextsuche für eine ClearQuest-Datenbank implementieren. Sie möchten nicht, dass die Standardposition für die Erstellung und Speicherung der WebSphere-Dateien für Ihre Implementierung verwendet wird. Verwenden Sie diese Befehlszeilenoption in Kombination mit der Befehlszeilenoption create_fts_was_profile, um anzugeben, wo die WebSphere Application Server-Profile für die Volltextsuche erstellt werden sollen. Enthält diese Maschine mehrere Implementierungen der Volltextsuche, verwenden Sie dieselbe Position für alle Implementierungen, damit alle WebSphere Application Server-Profile sich an derselben Position befinden.
Auswirkungen
Falls das angegebene Verzeichnis nicht vorhandenen ist, wird es an der Position fts_was_profile_home erstellt. Es enthält die zu dem WebSphere Application Server-Profil gehörigen Daten. In diesem Verzeichnis wird ein Unterverzeichnis erstellt. Sein Name entspricht dem Namen des WebSphere Application Server-Profils. Dieser lautet cqsearchprofile_dbset_userdb oder cqfts_dbset_userdb.
Zustandsüberwachungsstatus
Diese Option umfasst keine Zustandsüberwachung. Dieser Befehl sollte niemals fehlschlagen; es sei denn, es liegt ein E/A-Fehler vor oder der Pfad ist ungültig (z. B. nicht vorhandener Laufwerkbuchstabe oder nicht vorhandener UNIX- oder Linux-Mountpfad).
Beispiel
Sie müssen die ClearQuest-Volltextsuche implementieren. Sie möchten nicht die Standardposition für die WebSphere Application Server-Profile verwenden.

cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --init_cq_fts --create_fts_was_profile manual --fts_was_profile_home D:\FTS.WASprofiles

gather_diagnostic_data
Übersicht
Erfasst Daten, die den IBM Software Support bei der Diagnose potenzieller Probleme bei der ClearQuest-Volltextsuche unterstützen. Wenn Sie Unterstützung benötigen, können Sie diese Befehlszeilenoption für die Diagnose ausführen und die mit dieser Befehlszeilenoption erfassten Daten an den Support senden, um die Unterstützung zu beschleunigen. Diese Befehlszeilenoption stellt relevante Daten zu Ihrer Implementierung der ClearQuest-Volltextsuche zusammen. Die Daten werden in ein Verzeichnis kopiert und eventuell vom IBM Software Support angefordert. Überprüfen Sie vor dem Senden der Daten, dass sie keine vertraulichen Informationen enthalten. Die vertraulichsten Daten sind normalerweise die Namen der Datensatztypen, die Sie für die Suche aktiviert haben, und der Verlauf der Suchbegriffe, die in Ihrem Unternehmen übergeben wurden. Der Verlauf ist das Protokoll, das WebSphere für das WebSphere Application Server-Profil verwaltet. Kennwörter werden in Sterne umgewandelt, wenn die Ausgabe am Bildschirm angezeigt oder in Protokolldateien geschrieben wird. Sie werden niemals im Klartext gespeichert.
Verwendung
Verwenden Sie diesen Befehl, um Diagnosedaten zusammenzustellen und an den IBM Software Support zu senden, damit dieser Ihnen bei der Diagnose von Problemen bei der Volltextsuche helfen kann.
Auswirkungen
Es werden keine Daten oder Konfigurationseinstellungen geändert. Ein neues Verzeichnis wird erstellt, dessen Name den Namen Ihrer Implementierung und eine Zeitmarke enthält. Die kumulative Größe der Diagnosedaten variiert und ist von der Gesamtgröße der Protokolle in Ihrer Implementierung abhängig. Sie liegt normalerweise im Megabytebereich. Der eigentliche Index ist nicht Bestandteil der Diagnosedaten.
Zustandsüberwachungsstatus
Diese Option umfasst keine Zustandsüberwachung. Dieser Befehl sollte niemals fehlschlagen; es sei denn, es liegt ein E/A-Fehler vor.
Beispiel
Der IBM Software Support weist Sie an, Diagnosedaten zu senden, um Ihnen bei der Behebung von Problemen bei der Volltextsuche zu helfen. Mit dem folgenden Befehl werden die Diagnosedaten erstellt und in die Datei D:\CQ.Search\TextSearch_SAMPL.Diag-Zeitmarke gestellt.

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

gen_entity_file
Übersicht
Mit dieser Befehlszeilenoption wird die Entitätsdatei generiert. Diese enthält alle Datensatztypen, die an die ClearQuest-Datenbank übergeben werden können. Standardmäßig enthält die Entitätsdatei alle Datensatztypen und alle zugehörigen Felder Ihres ClearQuest-Schemas. Und diese sind Kandidaten für die Volltextsuche. Sie können die Datei anpassen und nur die Datensatztypen und zugehörigen Felder auswählen, die indexiert werden sollen. Wenn Sie die Volltextsuche zum ersten Mal auf einer ClearQuest-Benutzerdatenbank implementieren, müssen Sie über eine Entitätsdatei mit allen Datensatztypen und zugehörigen Feldern verfügen, auf die das Schema der ClearQuest-Benutzerdatenbank verweist. Diese Entitätsdatei wird als Eingabe für die Generierung der XML-Datei mit den Eigenschaften der Volltextsuche, der temporären Solr-XML-Datei und der Datei Solr schema.xml verwendet.
Verwendung
Im Allgemeinen müssen Sie diesen Befehl nicht explizit verwenden. Der Aufruf erfolgt, wenn Sie die Befehlszeilenoption init_cq_fts absetzen. Dieser Befehl wird für den Fall bereitgestellt, dass Sie Ihre Implementierung optimieren oder Fehler beheben müssen.
Auswirkungen
Wenn Sie diesen Befehl für eine vorhandene Implementierung verwenden, wird die Datei Entity-dbset-userdb.txt überschrieben und die Änderungen, die Sie vorgenommen haben, gehen verloren.
Zustandsüberwachungsstatus
Diese Option umfasst keine Zustandsüberwachung. Dieser Befehl sollte niemals fehlschlagen; es sei denn, es liegt ein E/A-Fehler vor.
Beispiel
Der IBM Rational Software Support hat Sie angewiesen, ein Problem mit einer Implementierung der Volltextsuche zu beheben oder eine Implementierung anzupassen.

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

gen_fts_files
Übersicht
Mit dieser Befehlszeilenoption werden Setup-Dateien für die ClearQuest-Volltextsuche generiert, die auf Ihrer Benutzerdatenbank, Entitätsdatei und Administratorkonfigurationsdatei für die Volltextsuche basieren. Wenn Sie die Volltextsuche zum ersten Mal auf einer Benutzerdatenbank implementieren, müssen Sie die XML-Datei mit den Eigenschaften der Volltextsuche generieren. Diese Datei enthält Informationen zu Ihren Implementierungseinstellungen, z. B. die Häufigkeit der Indexierung, die Stapelgröße für die Indexierung und Informationen zum Suchserver.
Verwendung
Im Allgemeinen verwenden Sie diese Befehlszeilenoption nicht explizit. Der Aufruf erfolgt, wenn Sie die Befehlszeilenoption setup_cq_fts absetzen. Diese Befehlszeilenoption wird für den Fall bereitgestellt, dass Sie Ihre Implementierung optimieren oder Fehler beheben müssen.
Auswirkungen
Wenn Sie diesen Befehl für eine vorhandene Implementierung verwenden, werden die Dateien Entity-dbset-userdb.txt, Solr-dbset-userdb.txt und CQ-dbset-userdb.xml überschrieben und die Änderungen, die Sie an diesen Dateien vorgenommen haben, gehen verloren.
Zustandsüberwachungsstatus
Diese Option umfasst keine Zustandsüberwachung. Dieser Befehl sollte niemals fehlschlagen; es sei denn, es liegt ein E/A-Fehler vor.
Beispiel
Der IBM Rational Software Support hat Sie angewiesen, ein Problem mit einer Implementierung der Volltextsuche zu beheben oder eine Implementierung anzupassen.

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

help
Übersicht
Zeigt einen Hilfetext an und wird anschließend beendet.
Verwendung
Sie sind mit dem Script cqtsadmin.pl vertraut, wünschen jedoch eine schnelle Auffrischung der Informationen zu den verfügbaren Befehlen.
Auswirkungen
Keine. Durch diesen Befehl werden keine Daten geändert. Für seine Ausführung ist keine Authentifizierung erforderlich.
Zustandsüberwachungsstatus
Diese Option umfasst keine Zustandsüberwachung. Dieser Befehl sollte niemals fehlschlagen; es sei denn, es liegt ein E/A-Fehler vor.
Beispiel
Sie wünschen eine Liste der verfügbaren Befehle.

cqperl cqtsadmin.pl --help

init_cq_fts
Übersicht
Kopiert die Standardschablone für die ClearQuest-Volltextsuche und generiert anschließend die Standardentitätsdatei. Dieser Befehl führt im Grunde die beiden Optionen copy_fts_template und gen_entity_file aus. Dieser Befehl ist einer der ersten Befehle, den Sie bei der Implementierung der Volltextsuche ausführen. Er erstellt ein Verzeichnis Datenbankgruppe_Benutzerdatenbank in Ihrem ftshome-Verzeichnis. Alle Standarddaten und -einstellungen für diese Implementierung werden in dieses Verzeichnis gestellt. Eine der wichtigsten Dateien, die von dieser Option erstellt werden, ist die Entitätsdatei Entity-dbset-userdb.txt. Sie wird in Ihr ftshome-Verzeichnis gestellt. Wenn Sie Ihre Implementierung anpassen, entscheiden Sie, ob Sie diese Datei unverändert verwenden oder ob Sie Datensatztypen und Felder entfernen, die nicht durchsucht werden sollen. Eine weitere Datei, die erstellt wird, ist die Administratorkonfigurationsdatei für die Volltextsuche, cqftsadmin-dbset-userdb.xml. Diese Datei enthält weitere Standardeinstellungen speziell für Ihre Implementierung und Umgebung, z. B. den Servernamen, den Namen Ihres WebSphere Application Server-Profils, die Stapelgröße für den Index und die Indexierungshäufigkeit.
Anmerkung: Diese Befehlszeilenoption wird in der Regel in Kombination mit den Befehlszeilenoptionen create_fts_was_profile und fts_was_profile_home ausgeführt, sodass ein neues WebSphere Application Server-Profil für diese Implementierung erstellt wird. Andernfalls schlägt die Implementierung der ClearQuest-Volltextsuche fehl; es sei denn, Sie verwenden ein WebSphere Application Server-Profil erneut, das zuvor für die Volltextsuche implementiert wurde.
Verwendung
Verwenden Sie diesen Befehl, um Ihre Implementierung der Volltextsuche vorzukonfigurieren. Der Befehl erstellt Ihr ftshome-Verzeichnis, kopiert die Standarddateien in dieses Verzeichnis und definiert die Standardwerte. Vor dem Abschluss Ihrer Implementierung passen Sie normalerweise die Entitätsdatei an.
Auswirkungen
Dieser Befehl erstellt ein neues ftshome-Verzeichnis, wenn das Verzeichnis nicht vorhanden ist, und kopiert die Standarddaten und -einstellungen für Ihre Implementierung in dieses Verzeichnis.
Zustandsüberwachungsstatus
Diese Option umfasst keine Zustandsüberwachung. Dieser Befehl sollte niemals fehlschlagen; es sei denn, es liegt ein E/A-Fehler vor.
Beispiel
Sie möchten eine neue Implementierung der Volltextsuche für eine Ihrer Benutzerdatenbanken starten.
  1. Führen Sie diesen Befehl aus, um Ihre Implementierung vorzukonfigurieren.

    cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --init_cq_fts --create_fts_was_profile automatic --fts_was_profile_home D:\CQFTS.WASprofiles

  2. Bearbeiten Sie diese Implementierungsentitätsdatei und entfernen Sie Datensatztypen oder Felder, die für Benutzer nicht durchsuchbar sein sollen. Fügen Sie außerdem für jeden Datensatztyp ein Et-Zeichen (&) vor einem Feld ein. Dieses Feld ist das Anzeigefeld in der Trefferliste mit den Ergebnissen der Volltextsuche.

    D:\CQ.Search\TextSerch_SAMPL\Entity-TextSearch-SAMPL.txt

  3. Schließen Sie Ihre Implementierung ab, indem Sie diesen Befehl ausführen:

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

lock_cq_fts
Übersicht

Mit dieser Befehlszeilenoption wird diese Implementierung der ClearQuest-Volltextsuche gesperrt, sodass nur nicht zerstörerische cqtsadmin.pl-Befehle ausgeführt werden können. Alle Befehle mit Ausnahme von gather_diagnostic_data und help werden inaktiviert. Verwenden Sie die Option unlock_cq_fts, um die Befehle wieder zu aktivieren.

Verwendung
Setzen Sie nach der Implementierung der Volltextsuche diesen Befehl ab, um die Implementierung zu sperren und versehentliche Änderungen zu verhindern. Diese Sperre ist schwach. Jeder Benutzer mit dem richtigen Dateisystemzugriff oder mit ClearQuest-Berechtigung kann eine Implementierung entsperren. Mithilfe dieses Befehls können Administratoren signalisieren, dass die Implementierung abgeschlossen ist. Weitere Änderungen müssen kommuniziert und sorgfältig ausgeführt werden.
Auswirkungen
Keine. Die Daten und Einstellungen für Ihre Implementierung der Volltextsuche sind nicht betroffen.
Zustandsüberwachungsstatus
Diese Option umfasst keine Zustandsüberwachung. Dieser Befehl sollte niemals fehlschlagen; es sei denn, es liegt ein E/A-Fehler vor.
Beispiel
Sie haben eine Implementierung abgeschlossen und möchten sicherstellen, dass die Implementierung nicht geändert wird.

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

optimize_idx
Übersicht

Mit dieser Befehlszeilenoption wird der Index defragmentiert. Damit die Optimierung erfolgreich ausgeführt wird, muss der freie Plattenspeicherplatz mindestens 1,5-mal so groß wie die aktuelle Indexgröße sein. Belegt Ihr Index beispielsweise 2 GB Plattenspeicherplatz, benötigen Sie einen freien Plattenspeicherplatz von 3 GB, um den Befehl auszuführen.

Verwendung

Wenn Sie Datensätze im Suchindex hinzufügen oder ändern, kann der Suchindex fragmentiert werden. Fragmentierte Indizes sind tendenziell größer als nicht fragmentierte Indizes. Möglicherweise führen sie auch zu leichten Leistungseinbußen. Optimieren Sie Ihren Index mindestens einmal im Jahr, um die Indexgröße zu reduzieren und die Leistung zu erhöhen. Führen Sie die Optimierung häufiger durch, wenn die Aktivität in Ihrer ClearQuest-Datenbank hoch ist, d. h., wenn viele Datensätze geändert, hinzugefügt oder gelöscht werden.

Stellen Sie vor der Ausführung dieses Befehls sicher, dass genügend freier Plattenspeicherplatz verfügbar ist. Andernfalls schlägt die Optimierung zwar fehl; der ursprüngliche Index wird jedoch nicht beschädigt. Freier Plattenspeicherplatz ist erforderlich, weil der ursprüngliche Index während der Optimierung neu geschrieben wird. Der alte Index bleibt bestehen, bis der neue Index generiert wurde.

Wie lange die Optimierung eines Index dauert, ist von der Größe des Index sowie von der Geschwindigkeit der Festplatte und der Ein-/Ausgabe abhängig. Für einen Index mit einer Größe von 2 GB kann die Optimierung einige Stunden dauern. Während die Optimierung stattfindet, sind alle Services der Volltextsuche verfügbar, einschließlich des Indexers im Aktualisierungsmodus. Möglicherweise treten jedoch leichte Leistungseinbußen auf. Führen Sie die Indexoptimierung in Zeiten geringer Systemauslastung aus.

Auswirkungen
Der Suchindex wird neu geschrieben. Tritt während der Optimierung ein E/A-Fehler auf, ist die wahrscheinlichste Ursache zu wenig Plattenspeicherplatz. Der ursprüngliche Index bleibt intakt. Der ursprüngliche Index ist möglicherweise größer; nach Abschluss der Optimierung kehrt der Index jedoch zu seiner ursprünglichen Größe zurück.
Zustandsüberwachungsstatus
Diese Option umfasst keine Zustandsüberwachung. Dieser Befehl sollte niemals fehlschlagen; es sei denn, es liegt ein E/A-Fehler vor.
Beispiel
Sie müssen Ihren Suchindex optimieren.

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

prep_upgd_was_profiles Ziel
Übersicht
Während einer geplanten Ausfallzeit führt diese Befehlszeilenoption die Vorbereitung auf eine ClearQuest-Änderung oder -Neuinstallation durch. Verwenden Sie die durch diesen Befehl erstellte Sicherung, um die Implementierungen der Volltextsuche einschließlich ihres WebSphere Application Server-Profils in ihrem ursprünglichen Zustand wiederherzustellen.
Verwendung

Für alle Benutzerdatenbanken, auf denen die Volltextsuche implementiert wird, ist ein entsprechendes WebSphere Application Server-Profil erforderlich. Diese Profile bleiben möglicherweise nicht erhalten, wenn Sie ClearQuest aktualisieren, ändern oder erneut installieren. In ClearQuest-Fixpacks bereitgestellte Updates können nur mithilfe dieser Vorbereitungs- und Wiederherstellungsprozedur in Implementierungen der ClearQuest-Volltextsuche integriert werden. Wenn Sie diese Befehlszeilenoption zusammen mit der Befehlszeilenoption restore_was_profiles verwenden, werden Sicherungsdaten erstellt, die WebSphere Application Server-Profile werden optional gelöscht und die gelöschten WebSphere Application Server-Profile werden anschließend aus den Sicherungsdaten wiederhergestellt. Der Pfad für die Sicherungsdaten wird beim Aufruf angegeben, nachdem das Upgrade oder die Neuinstallation von ClearQuest beendet ist.

Zum Löschen der WebSphere Application Server-Profile für ClearQuest müssen Sie den Wert des Tags <deleteFtsWASProfiles> für eine der Administratorkonfigurationsdateien für die Volltextsuche, cqtsadmin-dbset-userdb.xml, von FALSE in TRUE ändern. Stellen Sie sicher, dass auf diese geänderte Implementierung verwiesen wird, wenn Sie den Befehl ausführen. Andernfalls werden die WebSphere Application Server-Profile bei der Vorbereitung auf ihre Wiederherstellung und Aktualisierung nicht ordnungsgemäß entfernt.

Diese Befehlszeilenoption kann für jede Datenbankgruppe, jede Benutzerdatenbank und jedes FTS-Ausgangsverzeichnis ausgeführt werden. Die Option ist keiner bestimmten Implementierung der Volltextsuche zugeordnet. Sie wirkt sich auf alle Implementierungen der ClearQuest-Volltextsuche auf dem Host in jedem ftshome-Verzeichnis aus.
Anmerkung: Enthält die aktuelle Maschine mehrere Implementierungen der Volltextsuche, müssen diese Befehlszeilenoption und die Befehlszeilenoption restore_was_profiles nur einmal ausgeführt werden. Diese beiden Befehle gelten global und verarbeiten alle Implementierungen der Volltextsuche auf der aktuellen Maschine.
Achtung: Wenn Sie ClearQuest aktualisieren, muss der Tag <deleteFtsWASProfiles> auf TRUE gesetzt sein, wenn Sie diese Befehlszeilenoption ausführen. Andernfalls werden Ihre Implementierungen der Volltextsuche eventuell nicht vollständig aktualisiert. Nachdem das Upgrade beendet ist und die Befehlszeilenoption restore_was_profiles ausgeführt wurde, ändern Sie diese Option wieder in FALSE.
Auswirkungen
Ist der Tag <deleteFtsWASProfiles> für eine Administratorkonfigurationsdatei für die Volltextsuche, cqtsadmin-dbset-userdb.xml, auf TRUE gesetzt, werden Sicherungsdaten für Ihre WebSphere Application Server-Profile für die ClearQuest-Volltextsuche erstellt und diese WebSphere Application Server-Profile werden gelöscht. Alle Anforderungen an die Volltextsuche schlagen fehl, bis diese Profile wiederhergestellt sind. Das Optionsfeld bleibt jedoch aktiviert und die Erstellung von Oplogs für nicht replizierte Benutzerdatenbanken der Produktstufe 7 wird fortgesetzt. Dieser Typ des Fehlschlagens ist annehmbar, da Sie diese Befehlszeilenoption nur verwenden, wenn Sie ClearQuest aktualisieren, ändern oder erneut installieren.
Zustandsüberwachungsstatus
Diese Option umfasst keine Zustandsüberwachung. Dieser Befehl sollte niemals fehlschlagen; es sei denn, ein E/A-Fehler tritt auf.
Beispiel
Sie haben vor, ClearQuest zu aktualisieren, zu ändern oder erneut zu installieren. Bevor Sie die Installation starten, müssen Sie alle WebSphere Application Server-Profile auf diesem Host sichern.
  1. Bearbeiten Sie die Datei cqtsadmin-dbset-userdb.xml einer einzigen Implementierung der Volltextsuche und ändern Sie den XML-Tag <deleteFtsWASProfiles> wie folgt, um zuzulassen, dass die WebSphere Application Server-Profile gesichert und gelöscht werden.

    <newValue required="no">true</newValue>

    Speichern Sie die Änderung. In diesem Beispiel wird die XML-Datei cqtsadmin-TextSearch-SAMPL.xml verwendet.

  2. Setzen Sie die Befehlszeilenoption ab, um Sicherungsdaten zu erstellen und die WebSphere Application Server-Profile zu löschen:

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

  3. Ändern Sie den Wert des XML-Tags <deleteFtsWASProfiles> in FALSE oder entfernen Sie den Wert TRUE.
  4. Führen Sie das ClearQuest-Upgrade, die Änderung des Features Volltextsuche oder die Neuinstallation durch.
  5. Setzen Sie die Befehlszeilenoption ab, um alle Implementierungen der Volltextsuche und gelöschten WebSphere Application Server-Profile aus den Sicherungsdaten wiederherzustellen. Es folgen zwei mögliche Szenarios:
    • Für ClearQuest 8.0 (alle Releases): Behalten Sie die ursprünglichen Ausgangsverzeichnisse für die WebSphere Application Server-Profile bei und stellen Sie sie an den ursprünglichen, eindeutigen Positionen wieder her:

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

    • Für ClearQuest 8.0 (alle Releases) und 7.0 (alle Releases): Konsolidieren Sie bei der Wiederherstellung alle WebSphere Application Server-Profile in ein einziges Ausgangsverzeichnis für WebSphere Application Server-Profile.

      cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --restore_was_profiles E:\FTSBackupWASProfiles --fts_was_profile_home D:\FTS.WASprofiles

  6. Wenn ein Problem auftritt, führen Sie die Befehlszeilenoption gather_diagnostic_data für dieselbe Datenbankgruppe, dieselbe Benutzerdatenbank und dasselbe FTS-Ausgangsverzeichnis aus und senden die Daten an die IBM Rational-Unterstützung.
Achtung: Wenn Sie die Solr-Datei schema.xml für die Unterstützung einer anderen Sprache als Englisch angepasst oder Änderungen an der Analysefunktion oder dem Tokenizer von Solr vorgenommen haben, gehen diese Änderungen verloren. Sollen die Änderungen beibehalten werden, zeichnen Sie sie auf und nehmen Sie sie nach Abschluss des Upgrades erneut vor. Nachdem Sie Änderungen an der Datei schema.xml vorgenommen haben, stoppen Sie das WebSphere Application Server-Profil für die Volltextsuche und starten es anschließend erneut, damit die Änderungen in Kraft treten.
remove_lucene_idx_lock
Übersicht
Verwenden Sie diesen Befehl, um eine Lucene-Sperre für den Suchindex zu entfernen. Die Lucene-Suchmaschine verwendet Sperren, um Updates zu synchronisieren. In seltenen Fällen bleibt die Sperre aktiv, wenn bei Lucene oder dem Server ein Fehler auftritt, den Lucene nicht beheben kann. Während die Sperre aktiv ist, kann der Suchindex nicht aktualisiert werden. Daher können keine ClearQuest-Datensätze hinzugefügt oder aktualisiert werden. Volltextsuchen im Index funktionieren weiterhin, wenn kein Integritätsproblem bei dem Index besteht. Zum Entfernen einer solchen Sperre starten Sie das WebSphere Application Server-Profil erneut, indem Sie die Befehlszeilenoptionen stop_fts_was_profile und start_fts_was_profile absetzen. Volltextsuchen sind während des Neustarts des Service nicht möglich.
Verwendung
Sie stellen fest, dass neu hinzugefügte ClearQuest-Datensätze nicht in den Suchergebnissen enthalten sind. In den Protokollen für das WebSphere Application Server-Profil ist zu erkennen, dass Lucene-Fehler auftreten und der Index gesperrt ist. Verwenden Sie diesen Befehl, um die Sperre zu entfernen.
Auswirkungen
Keine. Die Daten und Einstellungen für die Implementierung der Volltextsuche sind nicht betroffen.
Zustandsüberwachungsstatus
Diese Option umfasst keine Zustandsüberwachung. Dieser Befehl sollte niemals fehlschlagen; es sei denn, es liegt ein E/A-Fehler vor.
Beispiel
Sie möchten eine Lucene-Indexsperre entfernen. Mit dem folgenden Befehl können Sie in einem einzigen Schritt das Profil stoppen, den Index entsperren und das Profil erneut starten:

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

remove_record_type
Übersicht
Mit diesem Befehl wird mindestens ein ClearQuest-Datensatztyp aus dem Suchindex entfernt. Bei nachfolgenden Suchvorgängen werden keine Übereinstimmungen mit den entfernten Datensatztypen gefunden. Dieser Befehl wird in Kombination mit Daten verwendet, die Sie über die Administratorkonfigurationsdatei für die Volltextsuche, cqtsadmin-dbset-userdb.xml, bereitstellen müssen. Listen Sie in der Konfigurationsdatei die Namen der zu entfernenden Datensatztypen in dem XML-Tag <removeRecordType> auf. Zum Entfernen mehrerer Datensatztypen trennen Sie die Namen durch ein Semikolon.

Dieser Befehl wird in mehreren Stadien ausgeführt. Tritt während eines Stadiums ein Fehler auf, wird in einer Fehlernachricht erläutert, wie der Fehler behoben werden kann. Wenn Sie den Befehl erneut starten, wird er an dem Punkt fortgesetzt, an dem der Fehler aufgetreten ist.

Erstellen Sie eine Sicherung Ihrer Implementierung, bevor Sie diesen Befehl absetzen. Durch die Entfernung eines Datensatztyps werden nur die zu diesem Datensatztyp gehörigen Daten aus dem Suchindex entfernt. ClearQuest selbst ist von diesem Befehl nicht betroffen.

Verwendung
Nach der Implementierung der Volltextsuche werden Sie angewiesen, Suchvorgänge für bestimmte Datensatztypen nicht mehr zuzulassen. Durch diesen Befehl werden diese Datensatztypen aus dem Index entfernt, sodass sie nicht mehr durchsuchbar sind. Dieser Befehl wird ebenfalls verwendet, wenn indexierte Datensatztypen sich in Ihrem ClearQuest-Schema geändert haben. Möglicherweise haben Sie neue Felder hinzugefügt oder Felder umbenannt. Verwenden Sie die Befehlszeilenoptionen remove_record_type und add_record_type, damit diese Änderungen sich in Ihrem Suchindex widerspiegeln.
Auswirkungen
Der Suchindex wird so geändert, dass keine Verweise mehr auf die Datensatztypen vorhanden sind, die entfernt wurden. Daher sind die entfernten Datensatztypen nicht mehr durchsuchbar. Verweise auf diese Datensatztypen werden aus der XML-Datei mit den Eigenschaften der Volltextsuche und der Entitätsdatei entfernt. Während der Ausführung dieses Befehl sind die Suchservices kurzzeitig unterbrochen, wenn das WebSphere Application Server-Profil erneut gestartet wird. Bei den Benutzern tritt möglicherweise der Fehler auf, dass der Server nicht aktiv ist. Zudem sind bei Benutzern, deren ClearQuest-Sitzung nach der Beendigung des Befehls noch aktiv ist, die entfernten Datensatztypen noch immer im Suchbereich in ClearQuest Web enthalten. Wenn sie Suchvorgänge für diese Datensatztypen ausführen, werden keine Übereinstimmungen gefunden. Diese Benutzer müssen sich erneut anmelden, damit ihr Suchbereich den Suchindex widerspiegelt. Dieser Befehl bewirkt eine Fragmentierung des Index. Optimieren Sie den Index nach der Ausführung dieses Befehls, damit sowohl die Indexgröße als auch die Leistung optimal sind.
Zustandsüberwachungsstatus
Der Befehl umfasst Zustandsüberwachung. Wenn der Befehl bei einem seiner Ausführungspunkte fehlschlägt, sind Sie normalerweise in der Lage, das Problem zu beheben und den Befehl erneut auszuführen. Er wird an dem Punkt fortgesetzt, an dem er gestoppt wurde. Tritt ein Fehler auf, werden die durchzuführenden Maßnahmen in einer Fehlernachricht erläutert.
Beispiel
Sie müssen zwei Datensatztypen aus Ihrem Suchindex entfernen.
  1. Geben Sie in der Datei cqtsadmin-TextSearch-SAMPL.xml in dem XML-Tag <removeRecordType> die Datensatztypen an, die entfernt werden sollen. Trennen Sie die Datensatztypen durch ein Semikolon.

    <newValue required="no">Email_Rule;Customer</newValue>

  2. Führen Sie den Befehl aus, um die beiden Datensatztypen zu entfernen.

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

  3. Entfernen Sie in der Datei cqtsadmin-TextSearch-SAMPL.xml die beiden Datensatztypen, die Sie dem XML-Tag <removeRecordType> hinzugefügt haben. Diese Bereinigungstask verhindert die versehentliche Entfernung, wenn Sie diese entfernten Datensatztypen zu einem späteren Zeitpunkt wieder hinzufügen.
repair_records
Übersicht
Wenn bei einem Indexierungsprozess im Stapel- oder Aktualisierungsmodus Probleme auftreten, die verhindern, dass Datensätze gelesen oder zur Indexierung an den Server gesendet werden, wird eine Reparaturdatei erstellt. In der Reparaturdatei sind die ClearQuest-Datensatz-IDs der fehlgeschlagenen Datensätze aufgelistet. Durch diesen Befehl wird ein Datensatz nach dem anderen in der Reparaturdatei gelesen und erneut indexiert, um die Wahrscheinlichkeit eines weiteren Fehlers zu reduzieren.
Verwendung
Führen Sie diesen Befehl im Rahmen Ihrer Implementierung der Volltextsuche aus, wenn die Indexierung im Stapelmodus beendet ist, um Datensätze zu indexieren, die zuvor nicht indexiert wurden. Sie sollten das ftshome-Verzeichnis in regelmäßigen Abständen auf Datensätze überprüfen, die bei der Indexierung im Aktualisierungsmodus nicht indexiert wurden. Wenn Datensätze nicht indexiert werden, enthält das Verzeichnis Dateien mit der Namenskonvention Name_des_DatensatzypsZeitmarke.xml. Das folgende Beispiel zeigt eine nicht indexierte Datei: Defect1222923990646.xml. Führen Sie diesen Befehl aus, um die Datensätze zu indexieren, wenn solche Dateien vorhanden sind.
Auswirkungen
Ihr Suchindex enthält Daten aus den neu indexierten Datensätzen.
Zustandsüberwachungsstatus
Diese Option umfasst keine Zustandsüberwachung. Dieser Befehl sollte niemals fehlschlagen; es sei denn, es liegt ein E/A-Fehler vor.
Beispiel
Sie müssen Datensätze indexieren, die während der Indexierung im Stapel- oder Aktualisierungsmodus nicht indexiert wurden.

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

restore_was_profiles Pfad_zur_Sicherung
Übersicht
Verwenden Sie diese Befehlszeilenoption, um Ihre WebSphere Application Server-Profile für die ClearQuest-Volltextsuche aus Sicherungsdaten wiederherzustellen, die mit der Befehlszeilenoption prep_upgd_was_profiles erstellt wurden.
Verwendung
Die WebSphere Application Server-Profile bleiben eventuell nicht erhalten, wenn Sie ClearQuest aktualisieren, ändern oder deinstallieren. Fixes für die Volltextsuche müssen in aktuelle WebSphere Application Server-Profile integriert werden, nachdem Sie ClearQuest-Fixpacks anwenden. Alle diese werden von der Vorbereitungs- und Wiederherstellungsprozedur verarbeitet. Nachdem Sie ClearQuest aktualisiert, geändert oder erneut installiert haben, werden mit dieser Befehlszeilenoption alle WebSphere Application Server-Profile für die ClearQuest-Volltextsuche wiederhergestellt, die mit der Befehlszeilenoption prep_upgd_was_profiles erstellt wurden.

Diese Befehlszeilenoption schlägt fehl, wenn Sie versuchen, ein WebSphere Application Server-Profil für die ClearQuest-Volltextsuche wiederherzustellen, das bereits vorhanden ist oder das zuvor nicht mit der Befehlszeilenoption prep_upgd_was_profiles gesichert und gelöscht wurde.

Sie können diese Befehlszeilenoption für jede Datenbankgruppe, jede Benutzerdatenbank und jedes FTS-Ausgangsverzeichnis ausführen. Sie wirkt sich auf alle Implementierungen der Volltextsuche und WebSphere Application Server-Profile in jedem Ausgangsverzeichnis für WebSphere Application Server-Profile auf diesem Host aus.
Anmerkung: Sie können diese Befehlszeilenoption in Kombination mit der Befehlszeilenoption fts_was_profile_home angeben, um ein konsolidiertes neues Ziel für die WebSphere Application Server-Profile anstelle ihres ursprünglichen Ziels anzugeben. Geben Sie diesen Schalter an, wenn Sie ein Upgrade für ClearQuest 7.0 (alle Releases) durchführen, um sicherzustellen, dass ein neues Ausgangsverzeichnis für WebSphere Application Server-Profile verwendet wird.
Auswirkungen
Ihre WebSphere Application Server-Profile für die Volltextsuche werden erneut erstellt und mit den ursprünglichen Einstellungen an der ursprünglichen Position wiederhergestellt oder in dem für fts_was_profile_home angegebenen Verzeichnispfad konsolidiert.
Zustandsüberwachungsstatus
Diese Option umfasst keine Zustandsüberwachung. Dieser Befehl sollte niemals fehlschlagen; es sei denn, es liegt ein E/A-Fehler vor.
Beispiel
Bei der Vorbereitung des Upgrades für ClearQuest haben Sie die Befehlszeilenoption prep_upgd_was_profiles ausgeführt, wobei der Tag <deleteFtsWASProfiles> auf TRUE gesetzt war. Nach dem Upgrade für ClearQuest müssen Sie alle WebSphere Application Server-Profile für die ClearQuest-Volltextsuche aus den Sicherungsdaten wiederherstellen. Außerdem möchten Sie die WebSphere Application Server-Profile mithilfe der Befehlszeilenoption fts_was_profile_home in ein neues Verzeichnis konsolidieren.

cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --restore_was_profiles E:\FTSBackupWASProfiles [ --fts_was_profile_home D:\FTS.WASprofiles ]

Achtung: Wenn Sie die Solr-Datei schema.xml für die Unterstützung einer anderen Sprache als Englisch angepasst oder Änderungen an der Analysefunktion oder dem Tokenizer von Solr vorgenommen haben, gehen diese Änderungen verloren. Sollen die Änderungen beibehalten werden, zeichnen Sie sie auf und nehmen Sie sie nach Abschluss des Upgrades erneut vor. Nachdem Sie Änderungen an der Datei schema.xml vorgenommen haben, stoppen Sie das WebSphere Application Server-Profil für die Volltextsuche und starten es anschließend erneut, damit die Änderungen in Kraft treten.
run_batch_idx
Übersicht
Mit diesem Befehl wird der Indexer im Stapelmodus gestartet. Er indexiert alle ClearQuest-Datensätze, die für die Suche konfiguriert wurden.

Dieser Befehl schlägt möglicherweise fehl, wenn der Wert für die Stapelgröße oder die Anzahl der Threads zu hoch ist oder wenn Ihre ClearQuest-Datensätze ein umfangreiches Datenvolumen enthalten. Die häufigste Ursache ist ein Fehler aufgrund abnormaler Speicherbedingungen. Reduzieren Sie in diesem Fall den verwendeten Wert für entweder die Stapelgröße oder die Anzahl der Threads. Als Folge verlängert sich die Dauer der Indexierung. Eine andere Möglichkeit besteht darin, dass Sie den JVM-Speicher (Java™ Virtual Machine) sowohl mithilfe des XML-Tags <batchIndexJVMParm> für den Indexer im Stapelmodus als auch mithilfe des XML-Tags <ftsWASProfileMaxHeapSize> für den Speicher des Suchservers erhöhen. Der erhöhte Speicherbedarf besteht jedoch nur temporär, bis der Indexer im Stapelmodus beendet ist. Die IBM Rational-Kundenunterstützung kann Ihnen helfen, die beste Maßnahme für die jeweilige Situation zu ermitteln. Wird der Befehl gestoppt, bevor er abgeschlossen ist, können Sie ihn erneut starten. Die Ausführung wird an dem Punkt fortgesetzt, an dem sie gestoppt wurde.

Verwendung
Sie brauchen diesen Befehl nicht explizit zu verwenden. Der Aufruf erfolgt, wenn Sie die Befehlszeilenoption setup_cq_fts absetzen. Dieser Befehl wird für den Fall bereitgestellt, dass Sie Ihre Implementierung optimieren oder Fehler beheben müssen.
Auswirkungen
Durch diesem Befehl werden ClearQuest-SQL-Abfragen mit Ihrer ClearQuest-Datenbank ausgeführt. Anschließend werden die gefundenen Datensätze zur Indexierung an den Solr-Suchserver gesendet. Während dieser Befehl ausgeführt wird, ist Ihr ClearQuest-Datenbankserver damit beschäftigt, Daten an die ClearQuest-Volltextsuche zu senden, und der Suchindex wird aktualisiert. Führen Sie diesen Befehl, falls erforderlich, zu Zeiten geringer Systemauslastung aus, um die Belastung Ihres Datenbankservers und damit die Auswirkungen auf seine Leistung zu reduzieren.
Zustandsüberwachungsstatus
Diese Option umfasst keine Zustandsüberwachung. Dieser Befehl sollte niemals fehlschlagen; es sei denn, es liegt ein E/A-Fehler, ein Fehler aufgrund abnormaler Speicherbedingungen oder ein nicht erwarteter Konfigurationsfehler vor.
Beispiel
Sie müssen alle ClearQuest-Datensätze indexieren.

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

scrub_oplog vor_Datum
Übersicht
Dieser Befehl wird verwendet, um die Oplogs einer nicht replizierten ClearQuest-Benutzerdatenbank zu bereinigen. ClearQuest generiert Oplogs, um Änderungen zu protokollieren, die Sie an Datensätzen vornehmen. Die ClearQuest-Volltextsuche überwacht Oplogs bei der Indexierung im Aktualisierungsmodus, um den Suchindex mit diesen Änderungen zu synchronisieren.

Oplogs sind temporäre Daten. Eine langfristige Aufbewahrung dieser Daten ist nicht erforderlich. Damit das Volumen der Oplogs bei nicht replizierten Datenbanken nicht kontinuierlich ansteigt, empfiehlt es sich, alte Oplogs gelegentlich, jedoch nicht zu häufig zu bereinigen. Die Häufigkeit der Bereinigung sollte auf der Rate der Oplog-Erstellung basieren.

Falls Ihre ClearQuest-Benutzerdatenbank repliziert wird, verwenden Sie Ihre Replizierungstools und -richtlinien für die Bereinigung von Oplogs. Wenn Sie versuchen, diesen Befehl für eine replizierte Datenbank auszuführen, schlägt er fehl und Sie werden in einer Fehlernachricht aufgefordert, Replikationstools zu verwenden.

Bereinigen Sie niemals alle Oplogs, besonders wenn einige noch nicht vom Indexer im Aktualisierungsmodus verarbeitet wurden. Andernfalls ist Ihr Suchindex nicht mit den ClearQuest-Datensätzen synchronisiert. Suchvorgänge liefern dann möglicherweise keine korrekten oder vollständigen Ergebnisse. Dieses Szenario erfordert die erneute Indexierung im Stapelmodus.

Werden Oplogs intensiv bereinigt und ist der Durchsatz des Indexers im Aktualisierungsmodus zu gering, ist der Index eventuell nicht korrekt und Treffer werden nicht gefunden. Stellen Sie sicher, dass der Indexer im Aktualisierungsmodus aktuell ist, und bereinigen Sie nur Oplogs, die älter sind als einen Monat, oder bereinigen Sie Oplogs nicht.

Verwendung
Sie müssen möglicherweise Oplogs in einer nicht replizierten ClearQuest-Benutzerdatenbank bereinigen, um Speicherplatz in der Datenbank freizugeben und nicht benötigte Daten zu löschen. Verwenden Sie diesen Befehl nicht, wenn Ihre ClearQuest-Datenbank repliziert wird.
Auswirkungen
ClearQuest-Oplogs in Ihrer Oplog-Tabelle, die vor dem angegebenen Datum erstellt wurden, werden gelöscht.
Zustandsüberwachungsstatus
Diese Option umfasst keine Zustandsüberwachung. Dieser Befehl sollte niemals fehlschlagen; es sei denn, es liegt ein E/A-Fehler vor.
Beispiel
Als ClearQuest-Administrator möchten Sie alte Oplogs in regelmäßigen Abständen bereinigen. Informationen über die unterstützten Datumsformate finden Sie in der Befehlsreferenz zu scruboplog.

cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --scrub_oplog "31-Oct-2009"

setup_cq_fts
Übersicht
Mit diesem Befehl wird eine Implementierung der Volltextsuche ausgeführt. Erstens werden durch diese Option die folgenden Dateien angepasst und auf der Basis Ihrer Administratorkonfigurationsdatei für die Volltextsuche, Ihrer ClearQuest-Datenbank und Ihres Betriebssystems konfiguriert:
  • Entitätsdatei
  • XML-Datei mit den Eigenschaften der Volltextsuche
  • Solr-Datei schema.xml
Zweitens wird die ClearQuest-Volltextsuche in ClearQuest Web aktiviert, indem das Optionsfeld Vollständiger Text aktiviert wird. Die Generierung von Oplogs beginnt, wenn Ihre ClearQuest-Datenbank Produktstufe 7 aufweist und nicht repliziert wird. Drittens wird die Indexierung im Stapelmodus gestartet, bei der alle ClearQuest-Datensätze indexiert werden, die in der Entitätsdatei für die Suche definiert wurden. Schließlich wird die Indexierung im Aktualisierungsmodus aktiviert. Damit ist die Implementierung abgeschlossen.

Dieser Befehl verwaltet seinen Status. Tritt ein Fehler auf, bevor der Befehl abgeschlossen ist, wird der Status gesetzt und Sie müssen den Fehler beheben, bevor Sie fortfahren können. Die Fehlernachricht und Protokolle enthalten Anweisungen zur Fehlerbehebung. Die Fehlerbehebungsmaßnahmen sind vom Fehler und vom Status abhängig, in dem der Fehler aufgetreten ist.

Verwendung
Verwenden Sie diesen Befehl, um Ihre Implementierung der Volltextsuche auszuführen. Normalerweise führen Sie diesen Befehl aus, nachdem Sie die Entitätsdatei angepasst haben. Während der Ausführung dieses Befehls ist das Optionsfeld Vollständiger Text in ClearQuest Web aktiviert. Benutzer, die sich erneut anmelden, können Suchvorgänge ausführen. Die Suchergebnisse sind erst dann vollständig, wenn die Implementierung abgeschlossen ist. Besonders wenn die ClearQuest-Datenbank nicht repliziert wird, muss das Optionsfeld aktiviert sein, da Oplogs generiert werden müssen, um alle Datensatzänderungen zu erfassen, die während und nach der Indexierung im Stapelmodus vorgenommen werden.

Die Auslastung des Computers, auf dem Sie die Volltextsuche implementieren, ist hoch, da die Indexierung im Stapelmodus hohe Anforderungen an Prozessor, Ein-/Ausgabe und Speicher stellt, wenn Sie die Standardeinstellung für den JVM-Speicher erhöhen. Wenn Sie die Intensität des Indexers im Stapelmodus steigern, indem Sie die Stapelgröße und die Anzahl der Threads erhöhen, kann die ClearQuest-Datenbank während der Indexierung im Stapelmodus stark ausgelastet sein.

Auswirkungen
Mehrere Dateien werden in Ihrem FTS-Ausgangsverzeichnis erstellt. Der Index wird erstellt. Die Suchservices unter WebSphere Application Server werden aktiviert. Und Ihre ClearQuest-Datenbank wird aktualisiert, sodass sie die XML-Datei mit den Eigenschaften der Volltextsuche enthält. Wird Ihre ClearQuest-Datenbank nicht repliziert, wird die Erstellung von Oplogs aktiviert. Replizierte ClearQuest-Benutzerdatenbanken setzen die Erstellung von Oplogs fort.
Zustandsüberwachungsstatus
Der Befehl umfasst Zustandsüberwachung. Wenn der Befehl bei einem seiner Ausführungspunkte fehlschlägt, müssten Sie in der Lage sein, das Problem zu beheben und den Befehl erneut auszuführen. Der Befehl wird an der Position fortgesetzt, an der er gestoppt wurde. Tritt ein Fehler auf, werden Sie mit einer Fehlernachricht über durchzuführende Maßnahmen informiert. Tritt ein Fehler auf, bevor der Befehl abgeschlossen ist, wird der Status gesetzt und Sie müssen den Fehler beheben, bevor Sie fortfahren können. Die Fehlernachricht und Protokolle enthalten Anweisungen zur Fehlerbehebung. Die Fehlerbehebungsmaßnahmen sind vom Fehler und vom Status abhängig, in dem der Fehler aufgetreten ist.
Beispiel
Sie haben die Befehlszeilenoption init_cq_fts ausgeführt und Ihre Entitätsdatei bearbeitet. Sie müssen die Implementierung jetzt abschließen.

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

set_was_max_mem
Übersicht
Mit diesem Befehl wird der maximale JVM-Speicher festgelegt, den das WebSphere Application Server-Profil verwenden kann. Der Standardwert ist 300 MB. Dieser Wert reicht möglicherweise in den folgenden Situationen nicht für die Indexierung im Stapelmodus aus:
  • Die Stapelgröße wurde erhöht.
  • Die Anzahl der Threads wurde erhöht.
  • Die ClearQuest-Datensatztypen sind komplex.

Dieser Befehl liest die Speichereinstellung aus dem XML-Tag <ftsWASProfileMaxHeapSize> in Ihrer Konfigurationsdatei. Anschließend wird der JVM-Speicher auf diesen Wert gesetzt.

Verwendung
Schlägt die Indexierung im Stapelmodus fehl, weil der Server des WebSphere Application Server-Profils einen Fehler aufgrund abnormaler Speicherbedingungen meldet, ist die Speichereinstellung wahrscheinlich zu niedrig. Führen Sie eine der folgenden Aktionen aus, um einen Fehler aufgrund abnormaler Speicherbedingungen zu beheben:
  • Reduzieren Sie die Stapelgröße und die Anzahl der Threads. Dies verlängert die Zeit, die für die Indexierung benötigt wird.
  • Erhöhen Sie temporär den JVM-Speicher. In der Regel sollte der maximale Wert für den JVM-Speicher erhöht werden, bis die Indexierung im Stapelmodus beendet ist.
Auswirkungen
Die Einstellung für den maximalen JVM-Speicher für das WebSphere Application Server-Profil wird auf den neuen Wert gesetzt. Im Grunde wird dem WebSphere Application Server-Profil mehr Systemspeicher zugeordnet.
Zustandsüberwachungsstatus
Diese Option umfasst keine Zustandsüberwachung. Dieser Befehl sollte niemals fehlschlagen; es sei denn, es liegt ein E/A-Fehler vor.
Beispiel
Bei der Indexierung gibt das WebSphere Application Server-Profil einen Fehler aufgrund abnormaler Speicherbedingungen aus. Sie müssen dieses Problem beheben, bevor Sie fortfahren können.
  1. Setzen Sie den JVM-Speicher im XML-Tag <ftsWASProfileMaxHeapSize> in der Datei cqtsadmin-TextSearch-SAMPL.xml auf 1,5 GB.

    <newValue required="no">1536</newValue>

  2. Führen Sie diesen Befehl aus, um die neue Einstellung für den JVM-Speicher festzulegen:

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

set_solr_home
Übersicht
Dieser Befehl wird verwendet, um das Solr-Ausgangsverzeichnis unter WebSphere Application Server festzulegen. Jede Implementierung verfügt über eine eigene Konfigurationsdatei schema.xml und einen eigenen Index. Ist das Solr-Ausgangsverzeichnis nicht ordnungsgemäß angegeben oder ist die falsche Position angegeben, kann das WebSphere Application Server-Profil für die Volltextsuche eventuell nicht gestartet werden. Wenn das WebSphere Application Server-Profil für die Volltextsuche nicht gestartet werden kann, werden Fehler in dem entsprechenden Protokollverzeichnis für das WebSphere Application Server-Profil für die Volltextsuche im Pfad %your-WAS-profile-home%/<cqfts>_<Datenbankgruppe>_<Benutzerdatenbank>/logs/server1/logs/ protokolliert.
Verwendung
Sie brauchen diesen Befehl nicht explizit zu verwenden. Der Aufruf erfolgt, wenn Sie die Befehlszeilenoption setup_cq_fts absetzen. Dieser Befehl wird für den Fall bereitgestellt, dass Sie Ihre Implementierung optimieren oder Fehler beheben müssen.
Auswirkungen
Die JVM-Eigenschaft des implementierten WebSphere Application Server-Profils wird so geändert, dass die Umgebungsvariable für das Solr-Ausgangsverzeichnis gesetzt ist.
Zustandsüberwachungsstatus
Diese Option umfasst keine Zustandsüberwachung. Dieser Befehl sollte niemals fehlschlagen; es sei denn, es liegt ein E/A-Fehler vor.
Beispiel
Sie wurden vom IBM Rational Software Support aufgefordert, diesen Befehl zu verwenden, um ein Problem mit einer Implementierung der Volltextsuche zu beheben oder eine Implementierung anzupassen.

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

show_scenarios [ID | all]
Übersicht
Mit diesem Befehl wird eine Liste von Szenarios angezeigt, die Beispiele für die Verwendung des Tools cqtsadmin.pl enthalten. Die Szenarios sind eine abgekürzte Version der Szenarios, die im Information Center aufgelistet werden. Möglicherweise werden nicht alle Szenarios oder nicht die gleichen Szenarios wie im Information Center aufgeführt.
Verwendung
Verwenden Sie diese Befehlszeilenoption, um eine Liste der häufigsten Einsatzszenarios des Tools cqtsadmin.pl anzuzeigen. Setzen Sie den Befehl ohne Parameter ab, um die Szenario-IDs und Überschriften anzuzeigen. Setzen Sie den Befehl mit einer Szenario-ID als Parameter ab, um den vollständigen Text des Szenarios anzuzeigen. Setzen Sie den Befehl mit dem Parameter all ab, um eine vollständige Liste der Szenarios jeweils mit ID, Überschrift und vollständiger Textbeschreibung anzuzeigen.
Auswirkungen
Die Daten und Einstellungen für die Implementierung der Volltextsuche sind nicht betroffen.
Zustandsüberwachungsstatus
Diese Option umfasst keine Zustandsüberwachung. Dieser Befehl sollte niemals fehlschlagen; es sei denn, es liegt ein E/A-Fehler vor.
Beispiel
Sie möchten eine Task mit dem Tool cqtsadmn.pl ausführen; Sie benötigen jedoch Informationen zu der Verwendung dieses Tools. Verwenden Sie diese Befehlszeilenoption, um die Überschriften der Szenarios sowie ihre IDs aufzulisten. Führen Sie anschließend diesen Befehl erneut aus und übergeben Sie die ID des Szenarios, für das Sie den vollständigen Text anzeigen möchten.

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

start_fts_was_profile
Übersicht
Dieser Befehl wird verwendet, um den Service für das WebSphere Application Server-Profil für die Volltextsuche zu starten. Ein WebSphere Application Server-Profil für die Volltextsuche muss gestartet sein, damit Suchanforderungen verarbeitet werden können. Außerdem muss ein Profil gestartet sein, damit der Indexer im Aktualisierungsmodus beginnt, auf neue oder aktualisierte Datensätze zu überprüfen und diese zur Indexierung an die Suchmaschine zu senden.
Verwendung
Sie brauchen diesen Befehl nicht explizit zu verwenden. Der Aufruf erfolgt, wenn Sie die Befehlszeilenoption setup_cq_fts absetzen. Dieser Befehl wird für den Fall bereitgestellt, dass Sie Ihre Implementierung optimieren oder Fehler beheben müssen.
Auswirkungen
War das WebSphere Application Server-Profil für die Volltextsuche gestoppt, wird es gestartet. Dadurch werden temporär Speicher- und Prozessorressourcen belegt. Sind die Suchservices und der Indexer im Aktualisierungsmodus aktiviert, wird ihre Ausführung gestartet. Ist das WebSphere Application Server-Profil bereits gestartet, wird keine Änderung vorgenommen.
Zustandsüberwachungsstatus
Diese Option umfasst keine Zustandsüberwachung. Dieser Befehl sollte niemals fehlschlagen; es sei denn, es liegt ein E/A-Fehler, ein Fehler beim Solr-Server oder ein Initialisierungsfehler beim WebSphere Application Server-Profil vor. Die häufigste Ursache hierfür sind Konfigurationsprobleme.
Beispiel
Der IBM Software Support hat Sie angewiesen, das WebSphere Application Server-Profil für die Suche zu starten.

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

start_update_idx
Übersicht
Dieser Befehl wird verwendet, um den Indexer im Aktualisierungsmodus zu starten. Dieser wird unter dem WebSphere Application Server-Profil ausgeführt. Der Indexer im Aktualisierungsmodus synchronisiert den Suchindex mit den Änderungen, die an der ClearQuest-Datenbank vorgenommen werden. Der Indexer überwacht Oplogs auf neue Werte, die indexiert werden müssen. Sie konfigurieren mithilfe des XML-Tags <updateIndexDelay> in Ihrer Administratorkonfigurationsdatei für die Volltextsuche, wie oft der Index synchronisiert wird.
Verwendung
Sie brauchen diesen Befehl nicht explizit zu verwenden. Der Aufruf erfolgt, wenn Sie die Befehlszeilenoption setup_cq_fts absetzen. Dieser Befehl wird für den Fall bereitgestellt, dass Sie Ihre Implementierung optimieren oder Fehler beheben müssen.
Auswirkungen
Der Indexer im Aktualisierungsmodus wird aktiviert und gestartet. Änderungen, Hinzufügungen und Entfernungen von ClearQuest-Datensätzen werden jetzt indexiert und spiegeln sich in den Suchergebnissen wider.
Zustandsüberwachungsstatus
Diese Option umfasst keine Zustandsüberwachung. Dieser Befehl sollte niemals fehlschlagen; es sei denn, es liegt ein E/A-Fehler, ein Fehler beim Solr-Server oder ein Initialisierungsfehler beim WebSphere Application Server-Profil vor. Die häufigste Ursache hierfür sind Konfigurationsprobleme.
Beispiel
Der IBM Software Support hat Sie angewiesen, den Indexer im Aktualisierungsmodus zu aktivieren.

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

stop_fts_was_profile
Übersicht
Dieser Befehl wird verwendet, um den Service für das WebSphere Application Server-Profil für die Volltextsuche zu stoppen. Wenn ein WebSphere Application Server-Profil gestoppt wird, sind die Suchservices nicht verfügbar und der Indexer im Aktualisierungsmodus stoppt die Synchronisierung des Suchindex mit den Änderungen, die an den ClearQuest-Datensätzen vorgenommen wurden.
Verwendung
Sie brauchen diesen Befehl nicht explizit zu verwenden. Der Aufruf erfolgt, wenn Sie die Befehlszeilenoption setup_cq_fts absetzen. Dieser Befehl wird für den Fall bereitgestellt, dass Sie Ihre Implementierung optimieren oder Fehler beheben müssen.
Auswirkungen
Das WebSphere Application Server-Profil für die Volltextsuche wird gestoppt. Dadurch werden auch die Suchservices und die Indexierung im Aktualisierungsmodus gestoppt. Die Speicher- und Prozessorressourcen, die das WebSphere Application Server-Profil belegt, werden freigegeben. Ein Suchvorgang verursacht einen Fehler.

Das Schreiben von Nachrichten in das Oplog wird fortgesetzt, solange das Optionsfeld Vollständiger Text in ClearQuest Web aktiviert ist. Auf diese Weise kann der Indexer im Aktualisierungsmodus die Änderungen abarbeiten, wenn das WebSphere Application Server-Profil wieder ausgeführt wird.

Zustandsüberwachungsstatus
Diese Option umfasst keine Zustandsüberwachung. Dieser Befehl sollte niemals fehlschlagen; es sei denn, es liegt ein E/A-Fehler vor.
Beispiel
Der IBM Software Support hat Sie angewiesen, das WebSphere Application Server-Profil für die Suche zu stoppen.

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

stop_update_idx
Übersicht
Dieser Befehl wird verwendet, um den Indexer im Aktualisierungsmodus zu inaktivieren und zu stoppen. Wenn der Indexer im Aktualisierungsmodus gestoppt wird, sind die Suchservices weiterhin verfügbar. Änderungen, die an den ClearQuest-Datensätzen vorgenommen werden, spiegeln sich jedoch erst dann im Index wider, wenn die Indexierung im Aktualisierungsmodus wieder aktiviert oder fortgesetzt wird. Daher liefern Suchvorgänge möglicherweise Ergebnisse, die nicht aktuell oder nicht korrekt sind.
Verwendung
Sie brauchen diesen Befehl nicht explizit zu verwenden. Der Aufruf erfolgt, wenn Sie die Befehlszeilenoptionen setup_cq_fts und backup_fts absetzen. Dieser Befehl wird für den Fall bereitgestellt, dass Sie Ihre Implementierung optimieren oder Fehler beheben müssen.
Auswirkungen
Der Indexer im Aktualisierungsmodus, der unter dem WebSphere Application Server-Profil ausgeführt wird, wird inaktiviert. Neue und geänderte ClearQuest-Datensätze spiegeln sich nicht in den Suchergebnissen wider. Das Schreiben von Nachrichten in das Oplog wird fortgesetzt. Änderungen an ClearQuest-Datensätzen spiegeln sich in Volltextsuchen wider, nachdem der Datensatzindexer im Aktualisierungsmodus wieder aktiviert wurde und die aktuellen Oplogs abgearbeitet hat.
Zustandsüberwachungsstatus
Diese Option umfasst keine Zustandsüberwachung. Dieser Befehl sollte niemals fehlschlagen; es sei denn, es liegt ein E/A-Fehler vor.
Beispiel
Der IBM Software Support hat Sie angewiesen, den Indexer im Aktualisierungsmodus zu inaktivieren.

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

unlock_cq_fts
Übersicht
Dieser Befehl wird verwendet, um eine gesperrte Implementierung der Volltextsuche zu entsperren. Wenn der Befehl beendet ist, können Sie alle verfügbaren Administratorbefehle für die Volltextsuche ausführen.
Verwendung
Verwenden Sie diesen Befehl, um eine gesperrte Implementierung der Volltextsuche zu entsperren, sodass Sie alle verfügbaren Befehle ausführen können. Mit diesem Befehl wird die Sperre aufgehoben, die mit der Befehlszeilenoption lock_cq_fts gesetzt wurde.
Auswirkungen
Keine. Die Daten und Einstellungen für Ihre Implementierung der Volltextsuche sind nicht betroffen und alle Befehle können ausgeführt werden.
Zustandsüberwachungsstatus
Diese Option umfasst keine Zustandsüberwachung. Dieser Befehl sollte niemals fehlschlagen; es sei denn, es liegt ein E/A-Fehler vor.
Beispiel
Sie müssen Ihren Index optimieren; die Implementierung ist jedoch gesperrt. Sie müssen sie entsperren, den Index optimieren und die Implementierung anschließend erneut sperren.

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

update_fts_prop_files
Übersicht
Gibt Änderungen weiter, die Sie an der Administratorkonfigurationsdatei für die Volltextsuche, cqtsadmin-dbset-userdb.xml, vornehmen. Nachdem Sie einen der folgenden XML-Tags in der Konfigurationsdatei geändert haben, müssen Sie die Änderungen weitergeben, damit sie in Kraft treten:
  • <batchIndexBatchSize>
  • <batchIndexDelay>
  • <batchIndexThreads>
  • <ftsServerName>
  • <ftsWASProfileName>
  • <ftsWASProfilePort>
  • <updateIndexBatchSize>
  • <updateIndexDelay>
  • <updateIndexLoginInterval>

Wenn Sie beispielsweise die Stapelgröße für den Indexer im Stapelmodus ändern, müssen Sie diesen Befehl absetzen, bevor Sie die Befehlszeilenoption run_batch_idx mit dem neuen Wert ausführen können.

Anmerkung: Wenn Sie das Kennwort für den Benutzer mit Administratorberechtigung ändern, verwenden Sie update_fts_prop_files (mit Angabe des neuen Kennworts), um sicherzustellen, dass die Kennwortdatei (pwd.txt) aktualisiert wird und die Batchindizierung von neuen Datensätzen wieder aufgenommen werden kann. Beispiel:
cqperl cqtsadmin.pl --username admin --password neues_Kennwort --dbset 7.0.0 --userdb SAMPL --ftshome C:\CQ.Search --fresh_batch_idx
Verwendung
Wenn Sie die Volltextsuche implementieren, müssen Sie möglicherweise eine Standardeinstellung ändern. Wenn eine Änderung an der Konfigurationsdatei vorgenommen wird, muss die Änderung an die entsprechenden Komponenten der Volltextsuche weitergegeben werden.
Auswirkungen
Die betroffenen Komponenten sind von dem XML-Tag abhängig, dessen Wert Sie ändern. Weitere Informationen finden Sie in cqtsadmin-dbset-userdb.xml.
Zustandsüberwachungsstatus
Diese Option umfasst keine Zustandsüberwachung. Dieser Befehl sollte niemals fehlschlagen; es sei denn, es liegt ein E/A-Fehler vor.
Beispiel
Sie müssen die Indexierung im Stapelmodus beschleunigen, indem Sie die Stapelgröße und die Anzahl der Threads erhöhen. Setzen Sie diesen Befehl ab, nachdem Sie die Konfigurationsdatei geändert haben.

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

upgrade_solr_app
Übersicht
Mit dieser Befehlszeilenoption wird überprüft, ob die Apache Solr-Version Ihrer aktuellen Implementierung der Volltextsuche mit der neuesten Version übereinstimmt, die mit Ihrer ClearQuest-Version ausgeliefert wird. Ist dies nicht der Fall, wird Apache Solr aktualisiert.
Verwendung
Eine neuere ClearQuest-Version unterstützt möglicherweise neuere Apache Solr-Versionen als die Version, die zurzeit in Ihrer aktuellen Implementierung der Volltextsuche verwendet wird. Wenn Sie ein Upgrade für ClearQuest und für Ihre Implementierungen der Volltextsuche ausführen, in denen die Befehlszeilenoptionen prep_upgd_was_profiles und restore_was_profiles verwendet werden, wird Ihre Anwendung Apache Solr nicht automatisch ebenfalls aktualisiert. Diese Upgrademethode ist beabsichtigt, da sich das Indexformat geändert haben kann, sodass eine vollständige erneute Indexierung erforderlich ist. Verwenden Sie diesen Befehl, um Apache Solr auf die neueste unterstützte Version zu aktualisieren.

Es empfiehlt sich, vor der Verwendung dieser Befehlszeilenoption Ihre Implementierung der Volltextsuche mithilfe der Befehlszeilenoption backup_fts zu sichern. Darüber hinaus können Sie den Releaseinformationen zu IBM Rational ClearQuest entnehmen, ob Sie nach einem Upgrade von Apache Solr Ihre ClearQuest-Datenbank neu indexieren müssen. Eine erneute Indexierung ist eventuell erforderlich, wenn das Indexformat von Apache Solr sich geändert hat.

Nachdem Sie diese Befehlszeilenoption ausgeführt haben, müssen Sie die Befehlszeilenoption stop_fts_was_profile und anschließend die Befehlszeilenoption start_fts_was_profile ausführen, damit das Upgrade in Kraft tritt.
Wichtig: Sie müssen diese Befehlszeilenoption nach einem Upgrade für ClearQuest und nach einem Upgrade für die Implementierungen der Volltextsuche mithilfe der Befehlszeilenoptionen prep_upgd_was_profiles und restore_was_profiles ausführen. Andernfalls treten möglicherweise unbekannte Probleme auf.
Auswirkungen
Ihre vorhandene Anwendung Apache Solr wird auf die neueste Version aktualisiert, die unterstützt wird. Die ClearQuest-Volltextsuche ist nicht verfügbar, bis das Upgrade abgeschlossen ist.
Zustandsüberwachungsstatus
Diese Option umfasst keine Zustandsüberwachung. Dieser Befehl sollte niemals fehlschlagen; es sei denn, es liegt ein E/A-Fehler oder ein Problem bei WebSphere Application Server vor.
Beispiel
Sie möchten Apache Solr für eine Ihrer Implementierungen der Volltextsuche aktualisieren. Sichern Sie Ihre Implementierung der Volltextsuche, indem Sie den Befehl cqtsadmin.pl mit der Option backup_fts ausführen.

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

Aktualisieren Sie die Anwendung Solr, indem Sie den Befehl cqtsadmin.pl erneut ausführen; diesmal der Befehlszeilenoption upgrade_solr_app:

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

Wird eine Nachricht angezeigt, die Sie anweist, die Benutzerdatenbank neu zu indexieren, führen Sie den Befehl cqtsadmin.pl 4-mal aus und geben jeweils eine der Befehlszeilenoptionen stop_update_idx, run_batch_idx, optimize_idx und start_update_idx an:

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

Sind weitere Implementierungen der Volltextsuche für andere ClearQuest-Datenbanken vorhanden, führen Sie die obigen Befehle für jede Datenbank aus.

was_profile_ports_file
Übersicht
Mit dieser Befehlszeilenoption können Sie optional eine eigene Portdatei für das WebSphere Application Server-Profil angeben. Diese wird mit der Befehlszeilenoption create_fts_was_profile verwendet, wenn ein Profil für die Volltextsuche erstellt wird.
Verwendung
Bei der Erstellung einer neuen Implementierung der Volltextsuche wird standardmäßig ein neues WebSphere Application Server-Profil erstellt. Das Verwaltungstool für die Volltextsuche bestimmt den nächsten verfügbaren Port, der auf Ihrem System verwendet wird. Wenn Sie Ihre Implementierung optimieren und eigene Ports angeben möchten, müssen Sie eine eigene Portdatei erstellen. Anschließend teilen Sie dem Verwaltungstool für die Volltextsuche mithilfe der Option was_profile_ports_file mit, dass Ihre Portdatei verwendet werden soll. Eine Schablone, die Sie verwenden können, wird in der Datei portdef.props in Ihrer WebSphere-Installation bereitgestellt. Die Datei portdef.props befindet sich normalerweise im Verzeichnis \IBM\WebSphere\AppServer\profileTemplates\default\actions\portsUpdate\. Weitere Informationen zur Portdatei für das WebSphere Application Server-Profil finden Sie im Information Center zu WebSphere Application Server in der Beschreibung des Befehls manageprofiles im Abschnitt mit dem Beispiel zur Verwendung vordefinierter Portnummern. http://pic.dhe.ibm.com/infocenter/wasinfo/v8r0/index.jsp?topic=%2Fcom.ibm.websphere.base.doc%2Finfo%2Faes%2Fae%2Frxml_manageprofiles.html
Diese Befehlszeilenoption wird in Kombination mit der Option create_fts_was_profile verwendet.
Anmerkung: Stellen Sie bei der Verwendung eigener Ports sicher, dass die Ports nicht durch andere Anwendungen im Gebrauch sind. Andernfalls treten eventuell Probleme mit der Volltextsuche und mit anderen Anwendungen auf.
Auswirkungen
Die Ports, die Sie mit diesem Befehl angeben, werden anstelle der Port verwendet, die das Verwaltungstool für die Volltextsuche angibt.
Zustandsüberwachungsstatus
Diese Option umfasst keine Zustandsüberwachung. Dieser Befehl sollte niemals fehlschlagen; es sei denn, ein E/A-Fehler tritt auf.
Beispiel
Sie müssen eine eigene Gruppe von Ports angeben, die verwendet werden soll.
  1. Erstellen Sie eine Kopie der Datei portdef.props und geben Sie anschließend eigene Portwerte an.
  2. Führen Sie diesen Befehl aus, um eine neue Implementierung der Volltextsuche zu erstellen, für die Sie mit der Option was_profile_ports_file eigene Ports angeben.

    cqperl cqtsadmin.pl --username admin --password "" --dbset MASTR --userdb SAMPL --ftshome D:\CQ.Search --init_cq_fts --create_fts_was_profile automatic --fts_was_profile_home D:\FTS.WASprofiles --was_profile_ports_file D:\my-portdef.props

  3. Fahren Sie mit der Verwendung Ihrer Implementierung der Volltextsuche fort.

Feedback