cqtsadmin-dbset-userdb.xml

cqtsadmin-Datenbankgruppe-Benutzerdatenbank.xml ist eine Administratorkonfigurationsdatei für die Volltextsuche, die vom Perl-Script cqtsadmin.pl generiert und verwendet wird. Die Datei enthält Daten zu Ihrer Implementierung, die Sie weiter anpassen können.

cqtsadmin-Datenbankgruppe-Benutzerdatenbank.xml ist eine von zwei Komponenten des Verwaltungstools für die Volltextsuche. Bei der anderen Komponente handelt es sich um das Perl-Script cqtsadmin.pl, über das die Schritte zum Einrichten, Konfigurieren und Verwalten der Volltextsuche von IBM Rational ClearQuest automatisiert werden.

Die Konfigurationsdatei cqtsadmin-Datenbankgruppe-Benutzerdatenbank.xml enthält XML-Elemente, die Einstellungen für die Volltextsuche darstellen, die vom Perl-Script cqtsadmin.pl verwendet werden. Jedes Element enthält die folgenden Tags:

Tabelle 1. Format der XML-Elemente von cqtsadmin-Datenbankgruppe-Benutzerdatenbank.xml
Tag Beschreibung
<description> Erläutert den Zweck des XML-Elements
<note> Stellt weitere relevante Informationen zu dem Tag bereit
<defaultValue> Enthält den Standardwert des XML-Elements
<newValue required="yes"> Enthält eventuell einen neuen Überschreibungswert, der den Standardwert im Tag <defaultValue> ersetzt. Der Wert von <newValue> wird auf der Basis von Parametern gesetzt, die Sie in der Befehlszeilenoption angeben oder die aus der ClearQuest-Datenbank oder vom Betriebssystem abgerufen werden. Sie können diesen Wert auch ändern, indem Sie die Datei direkt bearbeiten.
Anmerkung: Erforderliche Konfigurationselemente besitzen das XML-Attribut <newValue required="yes">.
.
Im folgenden Beispiel hat das XML-Element <dbSet> eine Beschreibung, einen Hinweis und den Standardwert TextSearch. Der Tag <newValue required="yes"> überschreibt den Standardwert TextSearch mit dem Wert 8.0.0. Dieser basiert auf dem Befehlszeilenparameter, der für die Option -Benutzerdatenbank verwendet wird.
<dbSet>
	<description>Der Name des CQ-Schemarepositorys (der Datenbankgruppe), für das (die) Sie CQ-FTS aktivieren möchten.</description>
	<note>Sie müssen diese Daten angeben, da der Standardwert eventuell nicht korrekt ist (er ist für Ihre CQ-Datenbank spezifisch).</note>
	<defaultValue>TextSearch</defaultValue>
			<newValue required="yes">8.0.0</newValue>
</dbSet>

XML-Elemente von cqtsadmin-dbset-userdb.xml

Tabelle 2. Tags für XML-Elemente von cqtsadmin-dbset-userdb.xml
Tagname Beschreibung Notes
<dbSet> Der ClearQuest-Datenbankgruppenname.

Der Standardwert dieses Tags wird automatisch durch das Tool cqtsadmin.pl generiert. Sie brauchen diesen Wert nicht zu ändern.

Der Wert dieses Tags basiert auf der ClearQuest-Datenbankgruppe, die bei der Erstkonfiguration als Befehlszeilenargument für das Tool cqtsadmin.pl angegeben wird.

<userDB> Der Name der ClearQuest-Benutzerdatenbank.

Der Standardwert dieses Tags wird automatisch durch das Tool cqtsadmin.pl generiert. Sie brauchen diesen Wert nicht zu ändern.

Der Wert dieses Tags basiert auf dem Namen der ClearQuest-Benutzerdatenbank, der bei der Erstkonfiguration als Befehlszeilenargument für das Tool cqtsadmin.pl angegeben wird.

<siteName> Der ClearQuest-Standortname.

Der Standardwert dieses Tags wird automatisch durch das Tool cqtsadmin.pl generiert. Sie brauchen diesen Wert nicht zu ändern.

Der Wert dieses Tags basiert auf Ihrem ClearQuest-Datenbanktyp. Wird Ihre Datenbank nicht repliziert, lautet der Wert <local>. Andernfalls ist der Wert der Name Ihres Masterreplikats.

<enableAtSites> Durch Kommas getrennte Liste der Standorte, an denen die ClearQuest-Volltextsuche aktiviert wird.

Der Standardwert dieses Tags wird automatisch durch das Tool cqtsadmin.pl generiert. Sie brauchen diesen Wert nicht zu ändern.

Der Wert dieses Tags basiert auf Ihrem ClearQuest-Datenbanktyp. Wird Ihre Datenbank nicht repliziert, wird dieser Wert ignoriert. Wird Ihre Datenbank repliziert, ist der Standardwert leer. Dadurch wird die ClearQuest-Volltextsuche an allen Standorten aktiviert.

Zum Aktivieren der ClearQuest-Volltextsuche an ausgewählten Standorten listen Sie die Standortnamen in diesem XML-Tag auf, wobei Sie Kommas als Trennzeichen verwenden.

<entityFile> Die Entitätsdatei für die ClearQuest-Volltextsuche.

Der Standardwert dieses Tags wird automatisch durch das Tool cqtsadmin.pl generiert. Sie brauchen diesen Wert nicht zu ändern.

Der Wert dieses Tags ist der Pfad zu der automatisch generierten Entitätsdatei für Ihre Implementierung der ClearQuest-Volltextsuche. Die Standarddatei ist Entity-Datenbankgruppe-Benutzerdatenbank.txt; eine Textdatei, in der die Datensatztypen und die zu durchsuchenden Felder in diesen Datensatztypen aufgelistet sind.

<ftsWASProfileName> Der Name des WebSphere Application Server-Profils für die Volltextsuche.

Der Standardwert dieses Tags wird automatisch durch das Tool cqtsadmin.pl generiert. Sie brauchen diesen Wert nicht zu ändern.

Die Namenskonventionen für das Profil lauten cqsearchprofile_Name_der_Datenbankgruppe_Name_der_Benutzerdatenbank, wobei Name_der_Datenbankgruppe und Name_der_Benutzerdatenbank anhand der Befehlszeilenparameter festgelegt werden, die an cqtsadmin.pl übergeben werden.

Überschreitet der sich ergebende Profilname 27 Zeichen, wird der Profilname cqsearchprofile_Name_der_Datenbankgruppe_Name_der_Benutzerdatenbank als cqfts_Name_der_Datenbankgruppe Name_der_Benutzerdatenbank abgekürzt.

Überschreitet der Profilname noch immer 27 Zeichen, kürzen Sie Name_der_Datenbankgruppe oder Name_der_Benutzerdatenbank ab. Ist dies nicht möglich, geben Sie einen eigenen Profilnamen an, indem Sie den Wert in diesem XML-Tag durch einen Profilnamen ersetzen, der auf dem Computer eindeutig ist, auf dem Sie die Volltextsuche implementieren, z. B. MeinProfil_1.

<ftsWASProfileHome> Der Pfad zu dem Ausgangsverzeichnis des WebSphere Application Server-Profils für die ClearQuest-Volltextsuche.

Der Standardwert dieses Tags wird automatisch durch das Tool cqtsadmin.pl generiert. Sie brauchen diesen Wert nicht zu ändern.

Der Wert dieses Pfads wird automatisch bestimmt, wenn die Befehlszeilenoption fts_was_profile_home verwendet wird. Andernfalls wird der Standardpfad %CLEARQUEST_HOME%/cqweb/ verwendet.

Anmerkung: Verwenden Sie die Befehlszeilenoption fts_was_profile_home, um einen Ausgangsverzeichnispfad für das WebSphere Application Server-Profil zu definieren, wenn Sie Ihre WebSphere Application Server-Profile für die Volltextsuche implementieren.
.
<ftsWASProfilePort> Die Portnummer des WebSphere Application Server-Profils für die ClearQuest-Volltextsuche, die für die Implementierung der Volltextsuche für diese Benutzerdatenbank verwendet werden soll.

Der Standardwert dieses Tags wird automatisch durch das Tool cqtsadmin.pl generiert. Sie brauchen diesen Wert nicht zu ändern.

Der cqsearchprofile-Standardwert des ursprünglichen WebSphere Application Server-Profils für die ClearQuest-Volltextsuche ist 14080. Wenn Sie ein neues WebSphere Application Server-Profil für eine neue Implementierung der Volltextsuche erstellen, wird der Portwert automatisch generiert, indem der nächste verfügbare Port auf Ihrem Server verwendet wird. Dabei wird mit 15080 begonnen und der Wert für weitere Implementierungen der Volltextsuche um jeweils 1000 erhöht. Die Portwerte lauten beispielsweise wie folgt: 15080, 16080, 17080 usw.

<ftsWASProfilePortsDefPropFile> Der Pfad zu der Portdatei des WebSphere Application Server-Profils für die ClearQuest-Volltextsuche. Verwenden Sie diesen Pfad mit der Befehlszeilenoption create_fts_was_profile für die Implementierung der Volltextsuche für die Benutzerdatenbank. Wenn Sie die Ports angeben müssen, verwenden Sie die Befehlszeilenoption was_profile_ports_file.

Der Standardwert dieses Tags wird automatisch durch das Tool cqtsadmin.pl generiert. Sie brauchen diesen Wert nicht zu ändern.

Standardmäßig werden die WebSphere Application Server-Profilports automatisch für WebSphere Application Server-Profile für die ClearQuest-Volltextsuche bestimmt, die Sie mit der Befehlszeilenoption create_fts_was_profile erstellen. Wenn Sie jedoch eigene Ports angeben müssen, verwenden Sie die Befehlszeilenoption was_profile_ports_file, um den Pfad zu einer Datei mit Portinformationen anzugeben, die als Schablone verwendet werden soll.

Wenn Sie einen Port angeben, wird diese Portdatei für das WebSphere Application Server-Profil in Ihr aktuelles Ausgangsverzeichnis für die Implementierung der Volltextsuche kopiert und dieser Tag wird automatisch so aktualisiert, dass er auf die Instanz der Datei im Ausgangsverzeichnis für die Volltextsuche zeigt.

Ändern Sie den Wert dieses Tags nur, wenn Sie eine differenziertere Steuerung der Einrichtung benötigen oder ein Problem beheben.

<ftsWASProfileMaxHeapSize> Die maximale Größe des Heapspeichers für die JVM (Java Virtual Machine) des WebSphere Application Server-Profils in Megabyte.

Der Standardwert dieses Tags ist 1024, d. h., die maximale Größe des Heapspeichers für die JVM kann bis zu 1 MB betragen.

Wenn bei der Indexierung und insbesondere bei der Indexierung im Stapelmodus Fehler aufgrund abnormaler Speicherbedingungen in Ihrem WebSphere Application Server-Profil für die Volltextsuche (Solr) auftreten, erhöhen Sie die Größe des Heapspeichers, um dieses Problem zu vermeiden. Der Maximalwert beträgt zurzeit ungefähr 1792 MB. Wenn Sie den Wert ändern, vergessen Sie nicht, ihn auf 1024 zurückzusetzen.

<ftsServerName> Der Name des Hosts oder Servers, auf dem diese Implementierung der ClearQuest-Volltextsuche durchgeführt wird.

Der Standardwert dieses Tags wird automatisch durch das Tool cqtsadmin.pl generiert. Sie brauchen diesen Wert nicht zu ändern.

Der Wert dieses Tags wird auf den Servernamen gesetzt, auf dem Sie die Volltextsuche implementieren. Ändern Sie diesen Namen nur, wenn Sie Ihren Computer umbenennen oder Ihre Implementierung auf einen Server mit einem anderen Namen versetzen.

Anmerkung: Wenn Sie diesen Wert ändern, müssen Sie einen vollständig qualifizierten und universal zugänglichen Hostnamen angeben. Wenn Sie den Lastausgleich oder die Volltextsuche in einer replizierten ClearQuest MultiSite-Datenbankkonfiguration verwenden, müssen alle ClearQuest Web-Server auf den Hostnamen zugreifen können.
<enableCQFTS> Dieser Tag wird auf TRUE gesetzt, um das Optionsfeld Vollständiger Text in ClearQuest Web zu aktivieren.

Der Standardwert dieses Tags wird automatisch durch das Tool cqtsadmin.pl generiert. Sie brauchen diesen Wert nicht zu ändern.

Dieser Tag hat zwei Werte: TRUE und jeder andere Wert oder leer. Ist er auf TRUE gesetzt, wird das Optionsfeld Vollständiger Text in ClearQuest Web bei der Einrichtung aktiviert. Andernfalls wird dieser Schritt übersprungen.

Ändern Sie den Wert dieses Tags nur, wenn Sie eine differenziertere Steuerung der Einrichtung benötigen oder ein Problem beheben.

Achtung: Setzen Sie den Wert nicht auf FALSE, um das Optionsfeld zu inaktivieren, wenn die Benutzerdatenbank vollständig oder teilweise indexiert ist, jedoch nicht repliziert wird. Durch die Inaktivierung des Optionsfelds wird die Erstellung von Oplogs für nicht replizierte ClearQuest-Datenbanken inaktiviert. Daher protokolliert die Volltextsuche keine Änderungen an ClearQuest-Datensätzen und geänderte Datensätze werden niemals neu indexiert. Setzen Sie den Wert auf FALSE und werden Datensätze geändert, müssen Sie die Datenbank vollständig neu indexieren. Wenn Sie den Wert auf FALSE setzen müssen, dürfen keine ClearQuest-Datensätze geändert werden, bis der Wert auf TRUE zurückgesetzt wird.
<runBatchIndex> Dieser Tag wird auf TRUE gesetzt, um den Start der Indexierung im Stapelmodus während der Einrichtung der ClearQuest-Volltextsuche zu aktivieren.

Der Standardwert dieses Tags wird automatisch durch das Tool cqtsadmin.pl generiert. Sie brauchen diesen Wert nicht zu ändern.

Dieser Tag hat zwei Werte: TRUE und jeder andere Wert oder leer. Ist dieser Tag auf TRUE gesetzt, wird der Indexer im Stapelmodus während der Einrichtung ausgeführt. Andernfalls wird dieser Schritt übersprungen.

Wird die Indexierung im Stapelmodus übersprungen, bedeutet dies, dass alle vorhandenen Datensätze nicht indexiert und nicht durchsuchbar sind. Daher sind die Suchergebnisse unvollständig.

<startUpdateIndex> Dieser Tag wird auf TRUE gesetzt, um den Start der Indexierung im Aktualisierungsmodus während der Einrichtung der ClearQuest-Volltextsuche zu aktivieren.

Der Standardwert dieses Tags wird automatisch durch das Tool cqtsadmin.pl generiert. Sie brauchen diesen Wert nicht zu ändern.

Dieser Tag hat zwei Werte: TRUE und jeder andere Wert oder leer. Ist der Wert auf TRUE gesetzt, wird der Indexer im Aktualisierungsmodus so konfiguriert, dass er geladen wird, wenn das WebSphere Application Server-Profil gestartet wird. Andernfalls wird dieser Schritt übersprungen.

Wird die Indexierung im Aktualisierungsmodus übersprungen, bedeutet dies, dass alle geänderten oder neu hinzugefügten Datensätze nach der ursprünglichen Indexierung im Stapelmodus nicht indexiert werden und nicht durchsuchbar sind. Daher sind die Suchergebnisse unvollständig.

<batchIndexJVMParm> Die JVM-Parametereinstellung, die der Indexer im Stapelmodus verwendet.

Der Standardwert dieses Tags ist -Xmx1536m. Dies bedeutet, dass der Indexer im Stapelmodus bis zu 1,5 GB Arbeitsspeicher verwenden kann.

Wenn während der Indexierung im Stapelmodus Fehler aufgrund abnormaler Speicherbedingungen ausgegeben werden, reduzieren Sie entweder die Stapelgröße oder die Anzahl der Threads. Möglicherweise hilft es, den JVM-Wert auf -Xmx1792m zu setzen. Der Effekt ist jedoch gering, da der Maximalwert für ein 32-Bit-Betriebssystem 2048 MB ist.

Da dieser JVM-Parameterwert unverändert an den Indexer im Stapelmodus übergeben wird, müssen Sie korrekte Werte gemäß der JVM-Spezifikation verwenden. Soll die Größe des Heapspeichers für JVM beispielsweise auf 1,7 GB erhöht werden, verwenden Sie den Wert -Xmx1792m und nicht 1792. Verwenden Sie den Wert -Xmx1536m -XX:-PrintGCDetails, um den Speicher zu vergrößern und das JVM-Debugging zu aktivieren.

<batchIndexBatchSize> Die Anzahl der Datensätze, die während der Indexierung im Stapelmodus pro Thread indexiert werden sollen. Der Wert ist eine ganze Zahl zwischen 1 und 1000. Der Standardwert ist 50.

Der Standardwert dieses Tags wird automatisch durch das Tool cqtsadmin.pl generiert. Sie können den Wert dieses Tags ändern, um die Geschwindigkeit der Indexierung im Stapelmodus zu erhöhen. Dadurch erhöht sich die Anzahl der zu lesenden Datensätze pro Thread. Sie können den Wert auch ändern, um Fehler aufgrund abnormaler Speicherbedingungen zu beheben, indem Sie die Anzahl der zu lesenden Datensätze pro Thread reduzieren.

Der Standardwert ist 50. Sind in Ihrer Umgebung ausreichende CPU-Zyklen und Arbeitsspeicherressourcen verfügbar und möchten Sie die Geschwindigkeit der Indexierung im Stapelmodus erhöhen, empfiehlt es sich, den Wert auf 200 zu erhöhen. Durch diese Aktion wird die Zeit verringert, die für die Indexierung von ClearQuest-Datensätzen im Stapelmodus erforderlich ist. Es besteht jedoch die Gefahr, dass Fehler aufgrund abnormaler Speicherbedingungen ausgegeben werden. Zur Behebung dieser Fehler erhöhen Sie den JVM-Speicher für den Indexer im Stapelmodus, für das WebSphere Application Server-Profil oder für beides.

<batchIndexDelay> Der Verzögerungswert in Sekunden für den Indexer im Stapelmodus. Der Wert ist eine ganze Zahl zwischen 0 und 86400 (1 Tag). Der Standardwert ist 0.

Der Standardwert dieses Tags wird automatisch durch das Tool cqtsadmin.pl generiert. Sie können den Wert ändern, um auf der Basis der Prozessorauslastung und Leistung die Zeit für die Indexierung im Stapelmodus zu verringern. Stellen Sie dabei sicher, dass auch für andere Anwendungen auf dem Server Ressourcen zur Verfügung stehen.

Jedes Mal, wenn der Indexer im Stapelmodus die Anzahl der im Tag <batchIndexBatchSize> angegebenen Datensätze verarbeitet hat, pausiert er für die Dauer, die im Tag <batchIndexDelay> festgelegt ist. Während dieser Verzögerung können andere Prozesse den Prozessor verwenden. Der Standardwert ist 0 Sekunden.

Mit diesem Wert können Sie die Auslastung für Ihren Server - hauptsächlich den ClearQuest-Datenbankserver und den ClearQuest-Server für die Volltextsuche - einstellen. Auch bei dem Wert 0 ist bereits eine Pause integriert, sodass nicht beide Server gleichzeitig verwendet werden. Während der Indexierung im Stapelmodus, wenn Daten aus der Datenbank gelesen werden, ist der Server für die Volltextsuche zum größten Teil inaktiv. Wenn der Server für die Volltextsuche die Daten indexiert, ist der Datenbankserver inaktiv. Wenn Sie eine Pause zwischen diesen Zyklen definieren wollen, erhöhen Sie den Wert auf 30. Dann ist der Indexer 30 Sekunden lang inaktiv, sodass andere Prozesse auf beiden Servern Prozessorressourcen verwenden können.

<batchIndexThreads> Die Anzahl der Threads, die für die Indexierung im Stapelmodus erstellt werden sollen. Der Wert ist eine ganze Zahl zwischen 1 und 10. Der Standardwert ist 5.

Der Standardwert dieses Tags wird automatisch durch das Tool cqtsadmin.pl generiert. Sie können Wert dieses Tags ändern. Wenn Sie den Wert erhöhen, verringert sich die Zeit für die Indexierung im Stapelmodus. Wenn Sie den Wert reduzieren, verlängert sich die Zeit für die Indexierung im Stapelmodus und die CPU wird für andere Anwendungen freigegeben bzw. die Auslastung des Datenbankservers wird gesenkt.

Bei der Indexierung im Stapelmodus können Sie angeben, wie viele Threads erstellt werden, wobei jeder Thread die durch <batchIndexBatchSize> angegebene Anzahl Datensätze verarbeitet.

Wenn genügend Prozessor- und Arbeitsspeicherressourcen vorhanden sind, können Sie den Indexer im Stapelmodus beschleunigen, indem Sie die Anzahl der Threads erhöhen. Dabei besteht jedoch die Gefahr, dass Fehler aufgrund abnormaler Speicherbedingungen ausgegeben werden. Ist dies der Fall, erhöhen Sie den JVM-Speicher für den Stapel, für das WebSphere Application Server-Profil oder für beides. Sie können auch über <batchIndexBatchSize> eine kleinere Anzahl der Datensätze konfigurieren, die pro Thread gelesen werden.

<updateIndexBatchSize> Die Anzahl der Datensätze, die während eines einzigen Arbeitsgangs des Indexers im Aktualisierungsmodus indexiert werden. Der Wert ist eine ganze Zahl zwischen 1 und 1000. Der Standardwert ist 250.

Der Standardwert dieses Tags wird automatisch durch das Tool cqtsadmin.pl generiert. Sie brauchen diesen Wert nicht zu ändern.

Der Standardwert ist 250. Sie müssen den Wert möglicherweise erhöhen, wenn der Indexer im Aktualisierungsmodus nicht mit der Anzahl der Änderungen Schritt halten kann, die an der ClearQuest-Datenbank vorgenommen werden.
Anmerkung: Im Gegensatz zum Indexer im Stapelmodus arbeitet der Indexer im Aktualisierungsmodus im Einzelthreadbetrieb. Möglicherweise müssen Sie höhere Größenwerte pro Arbeitsgang oder eine kürzere Einstellung für <updateIndexDelay> festlegen, um den erforderlichen Durchsatz bei der Indexierung im Aktualisierungsmodus zu erzielen. Diese Durchsatzrate ist davon abhängig, wie viele Datensätze durchschnittlich pro Minute pro ClearQuest-Benutzerdatenbank erstellt, aktualisiert und gelöscht werden.
<updateIndexDelay> Der Verzögerungswert in Sekunden für den Indexer im Aktualisierungsmodus. Der Wert ist eine ganze Zahl zwischen 1 und 86400 (1 Tag). Der Standardwert ist 60.

Der Standardwert dieses Tags wird automatisch durch das Tool cqtsadmin.pl generiert. Sie brauchen diesen Wert nicht zu ändern.

Der Standardwert ist 60 Sekunden (1 Minute). Wenn Sie diesen Wert auf 600 (10 Minuten) erhöhen, wird der Suchindex alle 10 Minuten mit der ClearQuest-Datenbank synchronisiert. Die Nachteile sind weniger Anmeldungen (und temporär ein höherer Lizenzbedarf) sowie weniger Prozessorzyklen.

<updateIndexLoginInterval> Dieser Tag gibt die Anzahl n der Zyklen für die Datensatzextraktion im Aktualisierungsmodus an, die ausgeführt werden müssen, bevor ein ClearQuest-Account sich erneut anmelden kann. Der Standardwert ist 10.

Der Standardwert dieses Tags wird automatisch durch das Tool cqtsadmin.pl generiert und auf 10 gesetzt.

Der Wert dieses Tags wird in Kombination mit dem Wert des Tags <updateIndexDelay> verwendet. Mithilfe dieser Werte können Sie die Häufigkeit einstellen, mit der der Indexer im Aktualisierungsmodus den Index mit der ClearQuest-Datenbank synchronisiert. Wenn Sie beispielsweise konfigurieren möchten, dass der Index für die Volltextsuche jede Minute mit der ClearQuest-Datenbank synchronisiert wird, setzen Sie den Wert für <updateIndexDelay> auf 60 und den Wert für <updateIndexLoginInterval> auf 1. Dann meldet der Indexer im Aktualisierungsmodus sich jede Minute bei der ClearQuest Datenbank an, um diese auf Änderungen zu überprüfen, die seit der letzten Prüfung vorgenommen wurden. Werden Änderungen erkannt, werden die Daten gelesen und an den Indexer gesendet. Anschließend meldet der Indexer im Aktualisierungsmodus sich ab. Da eine Anmeldeoperation ressourcenintensiv ist, erzielen Sie dieselbe Synchronisierungshäufigkeit, wenn Sie den Wert für <updateIndexLoginInterval> auf 10 setzen. Damit wird der Indexer im Aktualisierungsmodus angewiesen, den Index einmal pro Minute zu synchronisieren, aber 10 Minuten lang angemeldet zu bleiben. Nach der zehnten Synchronisierung ist der Indexer eine Minute lang abgemeldet. Durch diese Methode werden nicht jede Minute Ressourcen für die Anmeldung belegt, um den Index zu synchronisieren. Jedoch bleibt eine Lizenz für einen längeren Zeitraum ausgecheckt.

Anmerkung: Beachten Sie, dass die Anzahl der Sekunden, die durch die Kombination der Werte für <updateIndexLoginInterval> und <updateIndexDelay> berechnet wird, keine längere Einstellung für die Anmeldedauer angeben darf als das konfigurierte Zeitlimit für die ClearQuest-Datenbank. Andernfalls können verschiedene Probleme wie Ressourcenlecks auftreten.
<addRecordType> Eine Liste der Datensatztypen und Felder, die einer vorhandenen Implementierung der Volltextsuche hinzugefügt werden sollen.

Der Standardwert dieses Tags ist leer. Verwenden Sie diesen Tag, um Ihrem Suchindex neue Datensatztypen oder Felder hinzufügen, wenn Ihr ClearQuest-Schema sich nach der Erstkonfiguration ändert.

Wenn Sie bei der Implementierung einen Datensatztyp vergessen haben oder wenn Sie einen Datensatztyp hinzufügen und diesen durchsuchen möchten, ist dies möglich, indem Sie den vollständigen Datensatztyp und die zugehörigen Felder mit diesem Tag angeben.

Beispiel: Angenommen, bei der ursprünglichen Implementierung der Volltextsuche haben Sie den Datensatztyp "Customer" nicht indexiert. Nun muss er jedoch indexiert werden. Verwenden Sie das folgende Format, um den Datensatztyp "Customer" und die zugehörige Gruppe von Feldern diesem Tag hinzuzufügen: Customer=field1,field2,fieldN

Sollen mehrere Datensatztypen hinzugefügt werden, verwenden Sie ein Semikolon (;) als Trennzeichen. Sie können beispielsweise zwei Datensatztypen hinzufügen: Customer=field1,field2,fieldN;NewRecord=field1,field2,fieldN

Mit dieser Option können Sie einem vorhandenen indexierten Datensatztyp keine Felder hinzufügen. Zu diesem Zweck müssen Sie den Datensatztyp zunächst entfernen und ihn dann mit dieser Option erneut hinzufügen. Bei dieser Prozedur muss dieser Datensatztyp vollständig indexiert werden, nachdem er erneut hinzugefügt wurde.

<removeRecordType> Eine Liste von Datensatztypen kann aus der Implementierung der Volltextsuche entfernt werden.

Der Standardwert dieses Tags ist leer. Verwenden Sie diesen Tag, um indexierte Datensatztypen aus Ihrer Implementierung zu entfernen.

Geben Sie die Namen der Datensatztypen, die entfernt werden sollen, in diesen Tag ein. Zum Entfernen des Datensatztyps "Customer" geben Sie seinen Namen in diesen Tag ein. Sollen mehrere Datensatztypen entfernt werden, verwenden Sie ein Semikolon (;) als Trennzeichen. Beispielsweise können Sie zwei Datensatztypen entfernen: Customer;NewRecord.

<deleteFtsWASProfiles> Dieser Tag wird auf TRUE gesetzt, um mit der Befehlszeilenoption prep_upgd_was_profiles alle WebSphere Application Server-Profile für die ClearQuest-Volltextsuche auf diesem Hostsystem zu sichern und zu löschen. Diese Entfernung ist erforderlich, wenn ClearQuest mit der implementierten Volltextsuche für eine Aktualisierung, Änderung oder Neuinstallation vorbereitet wird.

Der Standardwert dieses Tags wird automatisch durch das Tool cqtsadmin.pl generiert und auf FALSE gesetzt. Wenn Sie ClearQuest aktualisieren, ändern oder erneut installieren, setzen Sie den Wert auf TRUE, bevor Sie die Befehlszeilenoption prep_upgd_was_profiles für diese spezielle Implementierung der Volltextsuche ausführen. Anschließend wird der Befehl global für alle Implementierungen der Volltextsuche auf diesem Server ausgeführt.

Der Tag hat zwei Werte: TRUE und jeder andere Wert oder leer. Wird der Wert auf TRUE gesetzt und geben Sie die Befehlszeilenoption prep_upgd_was_profiles an, erstellt der Befehl Sicherungsdaten Ihrer WebSphere Application Server-Profile für die ClearQuest-Volltextsuche. Zudem löscht der Befehl diese Profile, um ihre Wiederherstellung nach der Installation vorzubereiten. Der Befehl führt diese Aktion für jedes WebSphere Application Server-Profil für die Volltextsuche aus, das sich auf diesem Server befindet.

Nachdem Sie ClearQuest aktualisiert, geändert oder erneut installiert haben, verwenden Sie die Befehlszeilenoption restore_was_profiles, um alle gelöschten WebSphere Application Server-Profile für die Volltextsuche erneut zu erstellen.

Nachdem Sie die Befehlszeilenoption prep_upgd_was_profiles ausgeführt haben, setzen Sie den Wert dieses Tags für diese spezielle Implementierung der Volltextsuche auf FALSE zurück, um eine versehentliche Löschung der Profile zu verhindern.

Wichtig: Im Gegensatz zu allen anderen Tags und Befehlen arbeitet dieser Tag und Befehl global und wirkt sich auf alle Implementierungen der Volltextsuche auf diesem Server aus. Wenn Sie diese Änderung vornehmen und den Befehl prep_upgd_was_profiles für eine beliebige Implementierung der Volltextsuche auf diesem Server ausführen, wirkt der Befehl sich auf alle Implementierungen auf diesem Server aus.
<solrVersion> Dieser Tag enthält die Apache Solr-Version, die ClearQuest zurzeit unterstützt. Das Verwaltungstool für die ClearQuest-Volltextsuche verwendet den Wert dieses Tags, um die aktuelle Apache Solr-Version zu bestimmen und festzustellen, ob eine neuere Version verfügbar ist. Wenn Sie ein Upgrade der Apache Solr-Anwendung mithilfe der Befehlszeilenoption upgrade_solr_app durchführen, wird der Wert dieses Tags aktualisiert, um die aktualisierte Version widerzuspiegeln.
Wichtig: Ändern Sie den Wert des Tags <solrVersion> nur dann, wenn Sie vom IBM Support dazu aufgefordert werden. Sie können diesen Tag nicht ändern.

Feedback