Es werden nicht die richtigen Suchergebnisse zurückgegeben (FTS)

Wenn Suchergebnisse in Ihrem BOC-Produkt nicht wie erwartet angezeigt werden, kann dies an einem ungültigen oder veralteten Datensatz im Full-Text Search (FTS)-Index liegen.

Dieses Problem kann auftreten, wenn der automatische Bereinigungsjob, der alte Dateien entfernt, fehlschlägt oder wenn dem System die notwendigen Lese-/Schreibrechte für den Ordner fehlen, in dem der FTS-Index gespeichert ist. In der Regel befindet sich dieser Ordner im temporären Verzeichnis unter: C:\Windows\TEMP

Eine weitere mögliche Ursache ist eine Neuinstallation Ihres Webservers (z. B. Apache Tomcat).
Wenn die Datei axw.ids während dieses Vorgangs nicht korrekt übertragen wird, kann dies den Suchindex negativ beeinflussen. Wenn Sie Ihre Tomcat-Webservice- Installation aktualisieren, beachten Sie bitte unsere Anleitung:  Wie migriere ich die Tomcat-seitige Konfiguration eines BOC-Produkts?

Wie kann ich feststellen, ob mit meinem FTS-Index etwas nicht stimmt?

Probleme mit dem FTS-Index können in den BOC-Produkt-Logs erkannt werden.

Hier sind einige Beispiele, wie solche Log-Einträge aussehen können:

[FATAL] [boc.adoxx.fulltext.JNIIndexWriter] Could not open index (C:\windows\TEMP\FTS_4092DF8C-2BA8-4C08-AC6A-1DDD8DC79353\{30961770-dd4b-4c94-b6a5-f892f8a12f67}-998775608189594953\{ab71db7b-a17a-4d10-be36-f33eb745f153}) org.apache.lucene.index.CorruptIndexException: Unexpected file read error while reading index. 
2023-11-24 08:36:38.142 [10484] [WARN] [Index Updater] Error during index update, returned code UnexpectedError 
2023-11-24 08:36:38.126 [10484] [ERROR] [C++Assert] expr: !pDocBuf->IndexClosed() code: NS_ERROR_FAILURE (0x80004005) file: ..\src\applications\fts\index\afts_index_updater.cxx line: 1179 

Informationen dazu, wie Sie Ihre eigenen Logs lesen können, finden Sie in unserem Log-Leitfaden.

Lösung: FTS-Index manuell neu aufbauen 

Diese Anleitung gilt für ADONIS 16, ADOIT 17, ADOGRC und spätere Versionen. Für Anweisungen zu älteren Versionen klicken Sie bitte hier.

Wichtig: Bitte beachten Sie, dass diese Option eine hohe Last auf die Serverressourcen legt und die Performance der Anwendung beeinflusst. Es wird dringend empfohlen, diese Aufgabe außerhalb der Hauptnutzungszeiten durchzuführen.

1.) Melden Sie sich mit einem Admin-Benutzer in Ihrer Administrationsansicht an und klicken Sie auf Weitere Optionen (1). 

2.) Wählen Sie die Option Server (2)

3.) Wählen Sie die Option Suchindex neu initialisieren (3) und bestätigen Sie Ihre Auswahl im folgenden Popup.

 

FTS-Index manuell neu aufbauen (unter ADONIS 16, ADOIT 17 und ADOGRC 13)

1.) Öffnen Sie den Web-Client in Ihrem bevorzugten Internetbrowser und melden Sie sich mit einem geeigneten Admin-Benutzer in Ihrer Administrationsansicht an. Weitere Informationen, wie Sie Ihre Admin-Ansicht erreichen, finden Sie im Admin-Handbuch. Der beschriebene Pfad ist für alle BOC-Produkte gleich. 

 

2.) Klicken Sie nach dem Login auf die drei Punkte oben links und wählen Sie die Option Server

3.) Wählen Sie die Option Suchindex reinitialisieren und bestätigen Sie Ihre Auswahl im folgenden Popup.

 

Wichtig: Bitte beachten Sie, dass diese Option eine hohe Last auf die Serverressourcen legt und die Performance der Anwendung beeinflusst. Es wird dringend empfohlen, diese Aufgabe außerhalb der Hauptnutzungszeiten durchzuführen.

Zusätzliche Informationen (nur On-Premise)

Eine weitere Möglichkeit, den FTS-Index neu aufzubauen, besteht darin, den Ordner zu verschieben, in den der Index schreibt – insbesondere, wenn der Zugriff auf den aktuellen Speicherort eingeschränkt ist.

Dies kann erreicht werden, indem Sie die Datei [PRODUCT]/conf/adoxx.conf mit einem Editor Ihrer Wahl bearbeiten.

Im folgenden Beispiel wird der FTS-Index in das Installationsverzeichnis des BOC-Produkts verschoben, indem das Rautezeichen vor ADOXX_INDEXES_DIR entfernt und %temp% durch /_FTS ersetzt wird.

Wenn Sie den FTS-Index an einen anderen Ort verschieben möchten, müssen Sie den vollständigen Pfad angeben. Anschließend ist ein vollständiger Neustart erforderlich.