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
VolltextsucheVerzeichnis 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:
- en Englisch (Vereinigte Staaten, Standardwert)
- de Deutsch (Deutschland)
- fr Französisch (Frankreich)
- it Italienisch (Italien)
- br Portugiesisch (Brasilien)
- es Spanisch (Spanien)
- cn Vereinfachtes Chinesisch (China)
- hk Traditionelles Chinesisch (Hongkong, Sonderverwaltungsregion von China)
- tw Traditionelles Chinesisch (Taiwan, wie Hongkong)
- ja Japanisch (Japan)
- ko Koreanisch (Südkorea)
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.
- Bearbeiten Sie die Datei cqtsadmin-TextSearch-SAMPL.xml und
ändern Sie den Tag
<addRecordType>.
<newValue required="no">Customer=CustomerNum,address,phone,product</newValue>
- Erstellen Sie eine
Sicherung.
cqperl cqtsadmin.pl --username admin
--password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search
--backup_fts E:\FTSBackup
- Fügen Sie den neuen Datensatztyp
hinzu.
cqperl cqtsadmin.pl --username
admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search
--add_record_type
- 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.
- 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
- Ändern Sie die Entitätsdatei so, dass sie nur die Datensatztypen und Felder
enthält, die durchsucht werden sollen.
- 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.
- 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
- 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.
- 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
- 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.
- Stoppen Sie den Indexer im
Aktualisierungsmodus.
cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --stop_update_idx
- Erzwingen Sie die erneute Indexierung im
Stapelmodus.
cqperl cqtsadmin.pl --username admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search --fresh_batch_idx
- Führen Sie die Indexoptimierung
aus.
cqperl cqtsadmin.pl --username
admin --password "" --dbset TextSearch --userdb SAMPL --ftshome D:\CQ.Search
--optimize_idx
- 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.
- 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
- 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
- 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.
- 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.
- 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
- Ändern Sie den Wert des XML-Tags <deleteFtsWASProfiles> in
FALSE oder entfernen Sie den Wert TRUE.
- Führen Sie das ClearQuest-Upgrade,
die Änderung des Features Volltextsuche oder die Neuinstallation durch.
- 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:
- 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.
- 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>
- 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
- 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.
- 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>
- 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.
- Erstellen Sie eine Kopie der Datei portdef.props und
geben Sie anschließend eigene Portwerte an.
- 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
- Fahren Sie mit der Verwendung Ihrer Implementierung der Volltextsuche
fort.