Setup:Installationsanleitung/Kompendium/Neu-Indexierung der Suche: Unterschied zwischen den Versionen

Aktuelle Version vom 10. Januar 2024, 16:07 Uhr

Verschiedene Umstände machen es u.U. nötig, eine Reindexierung der Suche vorzunehmen. Dieses Dokument beschreibt die nötige Vorgehensweise.

Hinweise zum Dokument

Beim Editieren von Konfigurationsdateien mit einem Texteditor müssen die Dateien in UTF-8 Kodierung ohne BOM (Byte Order Mark) gespeichert werden.
Der Platzhalter <installpath-bluespice> steht stellvertretend für den Pfad zu Ihrer BlueSpice-Installation, z.B. C:\bluespice\var\www (Windows bei Beachtung der Dokumentation "Ordnerstruktur unter Windows") oder /var/www/bluespice (Linux).
Der Platzhalter <tomcat-webapps> steht stellvertretend für den Pfad zum Webapps-Verzeichnis Ihres Tomcat-Servers, z.B. C:\Program Files\Apache Software Foundation\Tomcat 9.0\webapps (Windows) oder /var/lib/tomcat9/webapps (Linux).

Neu-Indexierung der Suche

Um die folgenden Schritte ausführen zu können, öffnen Sie bitte zunächst eine Kommandozeile. Dort wechseln Sie in <installpath-bluespice>. Führen Sie hier die folgenden Befehle aus:

php extensions/BlueSpiceExtendedSearch/maintenance/rebuildIndex.php (Linux)
sudo -u www-data phpextensions/BlueSpiceExtendedSearch/maintenance/rebuildIndex.php (Docker)
php extensions\BlueSpiceExtendedSearch\maintenance\rebuildIndex.php (Windows)

php maintenance/runJobs.php (Linux)
sudo -u www-data php maintenance/runJobs.php (Docker)
php maintenance\runJobs.php (Windows)

Hinweis:Achten Sie unter Windows darauf, dass die Umgebungsvariablen korrekt gesetzt sind, um auf den Befehl "php" zugreifen zu können.

Je nach der Größe Ihrer Inhalte wird die Indexierung nun einige Zeit in Anspruch nehmen.

Troubleshooting

index read-only

Falls die Meldung "index: /bluespice_wikipage/wikipage/ caused blocked by: [FORBIDDEN/12/index read-only / allow delete (api)];" angezeigt wird, bitte folgenden Befehl ausführen und anschließend die Neu-Indexierung erneut durchführen.

curl -XPUT -H "Content-Type: application/json"http://localhost:9200/_all/_settings -d'{"index.blocks.read_only_allow_delete": null}'

Feedback zur Dokumentation ist im Community-Forum möglich.

@@ Zeile 12: / Zeile 12: @@
   php extensions/BlueSpiceExtendedSearch/maintenance/rebuildIndex.php ''(Linux)''
-  php extensions\BlueSpiceExtendedSearch\maintenance\rebuildIndex.php ''(Windows))''
+ sudo -u www-data phpextensions/BlueSpiceExtendedSearch/maintenance/rebuildIndex.php ''(Docker)''
+  php extensions\BlueSpiceExtendedSearch\maintenance\rebuildIndex.php ''(Windows)''
   php maintenance/runJobs.php ''(Linux)''
-  php maintenance\runJobs.php ''(Windows))''
+ sudo -u www-data php maintenance/runJobs.php ''(Docker)''
-{{Hint
+  php maintenance\runJobs.php ''(Windows)''
-|text=Achten Sie unter Windows darauf, dass die [[Setup:Installationsanleitung/Systemkonfigurationen/Umgebungsvariablen|Umgebungsvariablen]] korrekt gesetzt sind, um auf den Befehl "php" zugreifen zu können.
+{{Hinweisbox|boxtype=Hinweis|Note text=Achten Sie unter Windows darauf, dass die [[Setup:Installationsanleitung/Systemkonfigurationen/Umgebungsvariablen|Umgebungsvariablen]] korrekt gesetzt sind, um auf den Befehl "php" zugreifen zu können.
 }}
@@ Zeile 24: / Zeile 25: @@
 [[de:{{FULLPAGENAME}}]][[en:Setup:Installation Manual/Advanced/Rebuilding the search index]]
 [[Category:Suche]]
+==Troubleshooting==
+===index read-only===
+Falls die Meldung <code>"index: /bluespice_wikipage/wikipage/ caused blocked by: [FORBIDDEN/12/index read-only / allow delete (api)];"</code> angezeigt wird, bitte folgenden Befehl ausführen und anschließend die Neu-Indexierung erneut durchführen.
+ curl -XPUT -H "Content-Type: application/json"http://localhost:9200/_all/_settings -d'{"index.blocks.read_only_allow_delete": null}'