From d1f3ae560c6cff453e4518fb048d53a5fa6d5579 Mon Sep 17 00:00:00 2001 From: Shinsuke Sugaya Date: Sat, 3 Oct 2026 22:15:37 +0900 Subject: [PATCH] docs(15.9): move the install and upgrade guides to OpenSearch 3.9.0 and document the reindex an upgraded index needs Fess 15.9 now runs on OpenSearch 3.9.0 (fess #3537), and fess-setup install opensearch installs 3.9.0, but the 15.9 pages still told readers to set up OpenSearch 3.8.0 and its 3.8.0 plugins. - Replace the OpenSearch version Fess 15.9 uses with 3.9.0 in install, install-linux, install-windows, prerequisites, run, troubleshooting, uninstall and upgrade, in all seven languages: download URLs, paths, the fess-opensearch image tag and the supported-version statements. The "3.8.0 and later refuse dictionaries outside the configuration directory" sentences and the configsync 3.8.0 note in admin-index-backup describe older versions and are kept. - Install the four Fess plugins by URL. From 3.8.1 on they are published to maven.codelibs.org only, and opensearch-plugin resolves the groupId:artifactId:version form against Maven Central only, so the old command form fails for 3.9.0. The commands now use the maven.codelibs.org URL, as the docker-fess image does, and a sentence under each command block says why. - Step 4 of the upgrade guide notes that a snapshot taken on 3.9.0 cannot be restored to 3.8.0 or earlier. - Add the section "Applying New Fields and Kana Normalization to an Existing Document Index". At startup 15.9 adds fields to the configuration, log and user indices only, so a document index created by 15.8 keeps its old mapping: owner and last_modifier (#3528) get mapped dynamically as text, and the kana and long-vowel-dash normalization (#3532) is missing from its analysis settings and mapping.txt. The section explains that Re-indexing with Replace Aliases and Reset Dictionaries applies both without a crawl, warns that Reset Dictionaries overwrites edited dictionaries, and that files already indexed need one crawl with Check Last Modified off to get their owner. Step 7 and the "Do I need to recreate the index?" answer link to it. --- de/15.9/install/install-linux.rst | 64 ++++++++++++----------- de/15.9/install/install-windows.rst | 34 +++++++------ de/15.9/install/install.rst | 6 +-- de/15.9/install/prerequisites.rst | 4 +- de/15.9/install/run.rst | 10 ++-- de/15.9/install/troubleshooting.rst | 4 +- de/15.9/install/uninstall.rst | 8 +-- de/15.9/install/upgrade.rst | 69 +++++++++++++++++++++---- en/15.9/install/install-linux.rst | 64 ++++++++++++----------- en/15.9/install/install-windows.rst | 33 ++++++------ en/15.9/install/install.rst | 6 +-- en/15.9/install/prerequisites.rst | 4 +- en/15.9/install/run.rst | 10 ++-- en/15.9/install/troubleshooting.rst | 4 +- en/15.9/install/uninstall.rst | 8 +-- en/15.9/install/upgrade.rst | 65 ++++++++++++++++++++---- es/15.9/install/install-linux.rst | 64 ++++++++++++----------- es/15.9/install/install-windows.rst | 34 +++++++------ es/15.9/install/install.rst | 6 +-- es/15.9/install/prerequisites.rst | 4 +- es/15.9/install/run.rst | 10 ++-- es/15.9/install/troubleshooting.rst | 4 +- es/15.9/install/uninstall.rst | 8 +-- es/15.9/install/upgrade.rst | 67 ++++++++++++++++++++---- fr/15.9/install/install-linux.rst | 64 ++++++++++++----------- fr/15.9/install/install-windows.rst | 34 +++++++------ fr/15.9/install/install.rst | 6 +-- fr/15.9/install/prerequisites.rst | 4 +- fr/15.9/install/run.rst | 10 ++-- fr/15.9/install/troubleshooting.rst | 4 +- fr/15.9/install/uninstall.rst | 8 +-- fr/15.9/install/upgrade.rst | 70 ++++++++++++++++++++++---- ja/15.9/install/install-linux.rst | 62 ++++++++++++----------- ja/15.9/install/install-windows.rst | 32 ++++++------ ja/15.9/install/install.rst | 6 +-- ja/15.9/install/prerequisites.rst | 4 +- ja/15.9/install/run.rst | 10 ++-- ja/15.9/install/troubleshooting.rst | 4 +- ja/15.9/install/uninstall.rst | 8 +-- ja/15.9/install/upgrade.rst | 60 ++++++++++++++++++---- ko/15.9/install/install-linux.rst | 62 ++++++++++++----------- ko/15.9/install/install-windows.rst | 32 ++++++------ ko/15.9/install/install.rst | 6 +-- ko/15.9/install/prerequisites.rst | 4 +- ko/15.9/install/run.rst | 10 ++-- ko/15.9/install/troubleshooting.rst | 4 +- ko/15.9/install/uninstall.rst | 8 +-- ko/15.9/install/upgrade.rst | 58 +++++++++++++++++---- zh-cn/15.9/install/install-linux.rst | 62 ++++++++++++----------- zh-cn/15.9/install/install-windows.rst | 32 ++++++------ zh-cn/15.9/install/install.rst | 6 +-- zh-cn/15.9/install/prerequisites.rst | 4 +- zh-cn/15.9/install/run.rst | 10 ++-- zh-cn/15.9/install/troubleshooting.rst | 4 +- zh-cn/15.9/install/uninstall.rst | 8 +-- zh-cn/15.9/install/upgrade.rst | 54 ++++++++++++++++---- 56 files changed, 850 insertions(+), 490 deletions(-) diff --git a/de/15.9/install/install-linux.rst b/de/15.9/install/install-linux.rst index 9a1537d46..45420cad5 100644 --- a/de/15.9/install/install-linux.rst +++ b/de/15.9/install/install-linux.rst @@ -15,7 +15,7 @@ Voraussetzungen - Die in :doc:`prerequisites` beschriebenen Systemanforderungen sind erfüllt - Java 21 ist installiert -- OpenSearch 3.8.0 ist verfügbar (oder wird neu installiert) +- OpenSearch 3.9.0 ist verfügbar (oder wird neu installiert) Auswahl der Installationsmethode ===================================== @@ -129,14 +129,14 @@ Schritt 1: Installation von OpenSearch :: - $ wget https://artifacts.opensearch.org/releases/bundle/opensearch/3.8.0/opensearch-3.8.0-linux-x64.tar.gz - $ tar -xzf opensearch-3.8.0-linux-x64.tar.gz - $ cd opensearch-3.8.0 + $ wget https://artifacts.opensearch.org/releases/bundle/opensearch/3.9.0/opensearch-3.9.0-linux-x64.tar.gz + $ tar -xzf opensearch-3.9.0-linux-x64.tar.gz + $ cd opensearch-3.9.0 .. note:: - In diesem Beispiel wird OpenSearch 3.8.0 verwendet. - |Fess| 15.9 unterstützt OpenSearch 3.8.0. + In diesem Beispiel wird OpenSearch 3.9.0 verwendet. + |Fess| 15.9 unterstützt OpenSearch 3.9.0. 2. Installation der OpenSearch-Plugins @@ -144,16 +144,20 @@ Schritt 1: Installation von OpenSearch :: - $ cd /path/to/opensearch-3.8.0 - $ ./bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-fess:3.8.0 - $ ./bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-extension:3.8.0 - $ ./bin/opensearch-plugin install org.codelibs.opensearch:opensearch-minhash:3.8.0 - $ ./bin/opensearch-plugin install org.codelibs.opensearch:opensearch-configsync:3.8.0 + $ cd /path/to/opensearch-3.9.0 + $ ./bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-fess/3.9.0/opensearch-analysis-fess-3.9.0.zip + $ ./bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-extension/3.9.0/opensearch-analysis-extension-3.9.0.zip + $ ./bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-minhash/3.9.0/opensearch-minhash-3.9.0.zip + $ ./bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-configsync/3.9.0/opensearch-configsync-3.9.0.zip .. important:: Die Plugin-Version muss mit der OpenSearch-Version übereinstimmen. - Im obigen Beispiel sind alle auf 3.8.0 gesetzt. + Im obigen Beispiel sind alle auf 3.9.0 gesetzt. + + Die vier Plugins für |Fess| werden auf maven.codelibs.org veröffentlicht und daher per URL + installiert. Die Form ``groupId:artifactId:version`` von ``opensearch-plugin install`` sucht + nur in Maven Central. 3. Konfiguration von OpenSearch @@ -162,16 +166,16 @@ Schritt 1: Installation von OpenSearch :: # Pfad für Konfigurationssynchronisation (als absoluter Pfad angeben) - configsync.config_path: /path/to/opensearch-3.8.0/config/dictionary/ + configsync.config_path: /path/to/opensearch-3.9.0/config/dictionary/ # Deaktivierung des Sicherheits-Plugins (nur Entwicklungsumgebung) plugins.security.disabled: true .. important:: - Geben Sie für ``configsync.config_path`` ein Verzeichnis unterhalb des OpenSearch-Konfigurationsverzeichnisses an (in diesem Beispiel ``/path/to/opensearch-3.8.0/config/``). + Geben Sie für ``configsync.config_path`` ein Verzeichnis unterhalb des OpenSearch-Konfigurationsverzeichnisses an (in diesem Beispiel ``/path/to/opensearch-3.9.0/config/``). Ab OpenSearch 3.8.0 wird die Erstellung eines Index verweigert, wenn sich Wörterbuchdateien außerhalb des Konfigurationsverzeichnisses befinden. - Wenn Sie ein Verzeichnis außerhalb des Konfigurationsverzeichnisses angeben, z. B. ``/path/to/opensearch-3.8.0/data/config/``, kann |Fess| seine Indizes nicht erstellen und startet nicht. + Wenn Sie ein Verzeichnis außerhalb des Konfigurationsverzeichnisses angeben, z. B. ``/path/to/opensearch-3.9.0/data/config/``, kann |Fess| seine Indizes nicht erstellen und startet nicht. .. warning:: @@ -243,7 +247,7 @@ Schritt 2: Installation von Fess Nach der Änderung:: SEARCH_ENGINE_HTTP_URL=${SEARCH_ENGINE_HTTP_URL:-http://localhost:9200} - FESS_DICTIONARY_PATH=/path/to/opensearch-3.8.0/config/dictionary/ + FESS_DICTIONARY_PATH=/path/to/opensearch-3.9.0/config/dictionary/ .. note:: @@ -287,8 +291,8 @@ Schritt 1: Installation von OpenSearch :: - $ wget https://artifacts.opensearch.org/releases/bundle/opensearch/3.8.0/opensearch-3.8.0-linux-x64.rpm - $ sudo rpm -ivh opensearch-3.8.0-linux-x64.rpm + $ wget https://artifacts.opensearch.org/releases/bundle/opensearch/3.9.0/opensearch-3.9.0-linux-x64.rpm + $ sudo rpm -ivh opensearch-3.9.0-linux-x64.rpm Alternativ können Sie auch ein Repository hinzufügen und die Installation durchführen. Details finden Sie unter `Installing OpenSearch `__. @@ -297,10 +301,10 @@ Schritt 1: Installation von OpenSearch :: - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-fess:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-extension:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-minhash:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-configsync:3.8.0 + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-fess/3.9.0/opensearch-analysis-fess-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-extension/3.9.0/opensearch-analysis-extension-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-minhash/3.9.0/opensearch-minhash-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-configsync/3.9.0/opensearch-configsync-3.9.0.zip 3. Konfiguration von OpenSearch @@ -397,8 +401,8 @@ Schritt 1: Installation von OpenSearch :: - $ wget https://artifacts.opensearch.org/releases/bundle/opensearch/3.8.0/opensearch-3.8.0-linux-x64.deb - $ sudo dpkg -i opensearch-3.8.0-linux-x64.deb + $ wget https://artifacts.opensearch.org/releases/bundle/opensearch/3.9.0/opensearch-3.9.0-linux-x64.deb + $ sudo dpkg -i opensearch-3.9.0-linux-x64.deb Alternativ können Sie auch ein Repository hinzufügen und die Installation durchführen. Details finden Sie unter `Installing OpenSearch `__. @@ -407,10 +411,10 @@ Schritt 1: Installation von OpenSearch :: - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-fess:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-extension:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-minhash:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-configsync:3.8.0 + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-fess/3.9.0/opensearch-analysis-fess-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-extension/3.9.0/opensearch-analysis-extension-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-minhash/3.9.0/opensearch-minhash-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-configsync/3.9.0/opensearch-configsync-3.9.0.zip 3. Konfiguration von OpenSearch @@ -507,7 +511,7 @@ Die Startanleitung finden Sie unter :doc:`run`. Bei der ZIP-Version:: - $ ls -ld /path/to/opensearch-3.8.0/config/dictionary/ + $ ls -ld /path/to/opensearch-3.9.0/config/dictionary/ Bei der RPM-/DEB-Version:: @@ -545,7 +549,7 @@ F: Funktioniert OpenSearch auch mit anderen Versionen? ----------------------------------------------------------- A: |Fess| hängt von einer bestimmten Version von OpenSearch ab. -Um die Plugin-Kompatibilität zu gewährleisten, wird die Verwendung der empfohlenen Version (3.8.0) dringend empfohlen. +Um die Plugin-Kompatibilität zu gewährleisten, wird die Verwendung der empfohlenen Version (3.9.0) dringend empfohlen. Bei Verwendung anderer Versionen muss auch die Plugin-Version entsprechend angepasst werden. F: Können mehrere Fess-Instanzen denselben OpenSearch teilen? diff --git a/de/15.9/install/install-windows.rst b/de/15.9/install/install-windows.rst index 7bd58eb1e..1956f1929 100644 --- a/de/15.9/install/install-windows.rst +++ b/de/15.9/install/install-windows.rst @@ -15,7 +15,7 @@ Voraussetzungen - Die in :doc:`prerequisites` beschriebenen Systemanforderungen sind erfüllt - Java 21 ist installiert -- OpenSearch 3.8.0 ist verfügbar (oder wird neu installiert) +- OpenSearch 3.9.0 ist verfügbar (oder wird neu installiert) - Die Windows-Umgebungsvariable ``JAVA_HOME`` ist korrekt konfiguriert Überprüfung der Java-Installation @@ -82,7 +82,7 @@ Schritt 1: Installation von OpenSearch Folgen Sie den Schritten unten, um sie einzeln durchzugehen oder ein vorhandenes OpenSearch zu verwenden. Um nur die Plugins in ein vorhandenes OpenSearch zu installieren, verwenden Sie - ``bin\fess-setup install opensearch-plugins --opensearch-home C:\opensearch-3.8.0``. + ``bin\fess-setup install opensearch-plugins --opensearch-home C:\opensearch-3.9.0``. Alle Befehle finden Sie unter :doc:`fess-setup`. Download von OpenSearch @@ -94,7 +94,7 @@ Download von OpenSearch Beispiel:: - C:\opensearch-3.8.0 + C:\opensearch-3.9.0 .. note:: @@ -107,16 +107,20 @@ Installation der OpenSearch-Plugins :: - C:\> cd C:\opensearch-3.8.0 - C:\opensearch-3.8.0> bin\opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-fess:3.8.0 - C:\opensearch-3.8.0> bin\opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-extension:3.8.0 - C:\opensearch-3.8.0> bin\opensearch-plugin install org.codelibs.opensearch:opensearch-minhash:3.8.0 - C:\opensearch-3.8.0> bin\opensearch-plugin install org.codelibs.opensearch:opensearch-configsync:3.8.0 + C:\> cd C:\opensearch-3.9.0 + C:\opensearch-3.9.0> bin\opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-fess/3.9.0/opensearch-analysis-fess-3.9.0.zip + C:\opensearch-3.9.0> bin\opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-extension/3.9.0/opensearch-analysis-extension-3.9.0.zip + C:\opensearch-3.9.0> bin\opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-minhash/3.9.0/opensearch-minhash-3.9.0.zip + C:\opensearch-3.9.0> bin\opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-configsync/3.9.0/opensearch-configsync-3.9.0.zip .. important:: Die Plugin-Version muss mit der OpenSearch-Version übereinstimmen. - Im obigen Beispiel sind alle auf 3.8.0 gesetzt. + Im obigen Beispiel sind alle auf 3.9.0 gesetzt. + + Die vier Plugins für |Fess| werden auf maven.codelibs.org veröffentlicht und daher per URL + installiert. Die Form ``groupId:artifactId:version`` von ``opensearch-plugin install`` sucht nur + in Maven Central. Konfiguration von OpenSearch ----------------------------- @@ -126,7 +130,7 @@ Konfiguration von OpenSearch :: # Pfad für Konfigurationssynchronisation (als absoluter Pfad angeben) - configsync.config_path: C:/opensearch-3.8.0/config/dictionary/ + configsync.config_path: C:/opensearch-3.9.0/config/dictionary/ # Deaktivierung des Sicherheits-Plugins (nur Entwicklungsumgebung) plugins.security.disabled: true @@ -142,13 +146,13 @@ Konfiguration von OpenSearch .. note:: Bei Windows verwenden Sie ``/`` anstelle von ``\`` als Pfadtrennzeichen. - Schreiben Sie ``C:/opensearch-3.8.0/config/dictionary/`` statt ``C:\opensearch-3.8.0\config\dictionary\``. + Schreiben Sie ``C:/opensearch-3.9.0/config/dictionary/`` statt ``C:\opensearch-3.9.0\config\dictionary\``. .. important:: - Geben Sie für ``configsync.config_path`` ein Verzeichnis unterhalb des OpenSearch-Konfigurationsverzeichnisses an (in diesem Beispiel ``C:/opensearch-3.8.0/config/``). + Geben Sie für ``configsync.config_path`` ein Verzeichnis unterhalb des OpenSearch-Konfigurationsverzeichnisses an (in diesem Beispiel ``C:/opensearch-3.9.0/config/``). Ab OpenSearch 3.8.0 wird die Erstellung eines Index verweigert, wenn sich Wörterbuchdateien außerhalb des Konfigurationsverzeichnisses befinden. - Wenn Sie ein Verzeichnis außerhalb des Konfigurationsverzeichnisses angeben, z. B. ``C:/opensearch-3.8.0/data/config/``, kann |Fess| seine Indizes nicht erstellen und startet nicht. + Wenn Sie ein Verzeichnis außerhalb des Konfigurationsverzeichnisses angeben, z. B. ``C:/opensearch-3.9.0/data/config/``, kann |Fess| seine Indizes nicht erstellen und startet nicht. .. tip:: @@ -206,7 +210,7 @@ Zustand nach der Änderung:: REM External opensearch cluster set FESS_JAVA_OPTS=%FESS_JAVA_OPTS% -Dfess.search_engine.http_address=http://localhost:9200 - set FESS_JAVA_OPTS=%FESS_JAVA_OPTS% -Dfess.dictionary.path=C:/opensearch-3.8.0/config/dictionary/ + set FESS_JAVA_OPTS=%FESS_JAVA_OPTS% -Dfess.dictionary.path=C:/opensearch-3.9.0/config/dictionary/ .. note:: @@ -317,7 +321,7 @@ Windows hat eine Pfadlängenbeschränkung. Es wird empfohlen, in einem möglichs Beispiel:: C:\opensearch (empfohlen) - C:\Program Files\opensearch-3.8.0 (nicht empfohlen - Pfad zu lang) + C:\Program Files\opensearch-3.9.0 (nicht empfohlen - Pfad zu lang) Java wird nicht erkannt ----------------------- diff --git a/de/15.9/install/install.rst b/de/15.9/install/install.rst index 8cbc8d4ec..6dda9df19 100644 --- a/de/15.9/install/install.rst +++ b/de/15.9/install/install.rst @@ -126,7 +126,7 @@ Der grundlegende Ablauf ist bei allen Installationsmethoden gleich. Bei anderen Versionen als der Docker-Version muss OpenSearch separat eingerichtet werden. - - Installation von OpenSearch 3.8.0 + - Installation von OpenSearch 3.9.0 - Installation der erforderlichen Plugins - Bearbeitung der Konfigurationsdateien @@ -157,7 +157,7 @@ OpenSearch Verwendet OpenSearch als Suchmaschine. -- **Unterstützte Version**: OpenSearch 3.8.0 +- **Unterstützte Version**: OpenSearch 3.9.0 - **Erforderliche Plugins**: - opensearch-analysis-fess @@ -235,7 +235,7 @@ Versionsinformationen Diese Dokumentation bezieht sich auf folgende Versionen: - **Fess**: 15.9.0 -- **OpenSearch**: 3.8.0 +- **OpenSearch**: 3.9.0 - **Java**: 21 oder höher - **Docker**: 20.10 oder höher - **Docker Compose**: 2.0 oder höher diff --git a/de/15.9/install/prerequisites.rst b/de/15.9/install/prerequisites.rst index f48454758..a434c342a 100644 --- a/de/15.9/install/prerequisites.rst +++ b/de/15.9/install/prerequisites.rst @@ -74,9 +74,9 @@ ZIP/RPM/DEB Version - OpenJDK 21 oder höher - Eclipse Temurin 21 oder höher -- **OpenSearch 3.8.0**: Erforderlich. Mit einer älteren Version als OpenSearch 3 startet |Fess| nicht +- **OpenSearch 3.9.0**: Erforderlich. Mit einer älteren Version als OpenSearch 3 startet |Fess| nicht - - Unterstützte Version: OpenSearch 3.8.0 + - Unterstützte Version: OpenSearch 3.9.0 - Bei anderen Versionen ist auf Plugin-Kompatibilität zu achten Docker Version diff --git a/de/15.9/install/run.rst b/de/15.9/install/run.rst index 1606083ed..8043af65e 100644 --- a/de/15.9/install/run.rst +++ b/de/15.9/install/run.rst @@ -22,7 +22,7 @@ Start von OpenSearch :: - $ cd /path/to/opensearch-3.8.0 + $ cd /path/to/opensearch-3.9.0 $ ./bin/opensearch Für Hintergrundstart:: @@ -31,7 +31,7 @@ Für Hintergrundstart:: .. note:: - ``bin/fess-setup install opensearch`` legt OpenSearch in ``opensearch/opensearch-3.8.0`` im + ``bin/fess-setup install opensearch`` legt OpenSearch in ``opensearch/opensearch-3.9.0`` im |Fess|-Verzeichnis ab. .. important:: @@ -42,7 +42,7 @@ Für Hintergrundstart:: Benutzer schlägt dann mit ``AccessDeniedException`` fehl. Übertragen Sie das OpenSearch-Verzeichnis vor dem nächsten Start wieder an diesen Benutzer, zum Beispiel:: - $ sudo chown -R /path/to/opensearch-3.8.0 + $ sudo chown -R /path/to/opensearch-3.9.0 Start von Fess ~~~~~~~~~~~~~~ @@ -72,8 +72,8 @@ Start von OpenSearch Oder von der Eingabeaufforderung:: - C:\> cd C:\opensearch-3.8.0 - C:\opensearch-3.8.0> bin\opensearch.bat + C:\> cd C:\opensearch-3.9.0 + C:\opensearch-3.9.0> bin\opensearch.bat Start von Fess ~~~~~~~~~~~~~~ diff --git a/de/15.9/install/troubleshooting.rst b/de/15.9/install/troubleshooting.rst index 161c9bf40..fb819c4ac 100644 --- a/de/15.9/install/troubleshooting.rst +++ b/de/15.9/install/troubleshooting.rst @@ -70,7 +70,7 @@ Plugin-Installation schlägt fehl 2. Passen Sie die Plugin-Version an die OpenSearch-Version an:: - $ /path/to/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-fess:3.6.0 + $ /path/to/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-fess/3.9.0/opensearch-analysis-fess-3.9.0.zip 3. Überprüfen Sie Berechtigungen:: @@ -197,7 +197,7 @@ Ab OpenSearch 3.8.0 wird die Erstellung eines Index verweigert, wenn sich Wörte 1. Ändern Sie ``configsync.config_path`` und ``FESS_DICTIONARY_PATH`` auf ein Verzeichnis unterhalb des OpenSearch-Konfigurationsverzeichnisses. - RPM/DEB-Version: ``/etc/opensearch/dictionary/`` - - ZIP-Version: ``/path/to/opensearch-3.8.0/config/dictionary/`` + - ZIP-Version: ``/path/to/opensearch-3.9.0/config/dictionary/`` 2. Wenn bereits Wörterbuchdateien vorhanden sind, kopieren Sie sie in das neue Verzeichnis. 3. Starten Sie zuerst OpenSearch und dann |Fess| neu. diff --git a/de/15.9/install/uninstall.rst b/de/15.9/install/uninstall.rst index 09254f9b4..936762049 100644 --- a/de/15.9/install/uninstall.rst +++ b/de/15.9/install/uninstall.rst @@ -77,13 +77,13 @@ Schritt 2: Löschen von OpenSearch Löschen Sie das OpenSearch-Installationsverzeichnis:: - $ rm -rf /path/to/opensearch-3.8.0 + $ rm -rf /path/to/opensearch-3.9.0 Schritt 3: Löschen des Datenverzeichnisses (Optional) ----------------------------------------------------- Die Indexdaten von |Fess| werden in OpenSearch gespeichert. -Standardmäßig werden sie innerhalb des OpenSearch-Installationsverzeichnisses gespeichert (z. B. ``opensearch-3.8.0/data``). +Standardmäßig werden sie innerhalb des OpenSearch-Installationsverzeichnisses gespeichert (z. B. ``opensearch-3.9.0/data``). Falls Sie mit ``path.data`` einen anderen Speicherort angegeben haben, löschen Sie auch dieses Verzeichnis:: $ rm -rf /path/to/data @@ -94,7 +94,7 @@ Schritt 4: Löschen des Protokollverzeichnisses (Optional) Löschen Sie die Protokolldateien:: $ rm -rf /path/to/fess-15.9.0/logs - $ rm -rf /path/to/opensearch-3.8.0/logs + $ rm -rf /path/to/opensearch-3.9.0/logs Deinstallation der RPM-Version ============================== @@ -310,7 +310,7 @@ Wenn Sie Docker-Images löschen und Festplattenplatz freigeben möchten:: $ docker images | grep fess $ docker rmi ghcr.io/codelibs/fess:15.9.0 - $ docker rmi ghcr.io/codelibs/fess-opensearch:3.8.0 + $ docker rmi ghcr.io/codelibs/fess-opensearch:3.9.0 Schritt 4: Löschen der Compose-Dateien -------------------------------------- diff --git a/de/15.9/install/upgrade.rst b/de/15.9/install/upgrade.rst index d0fd598d1..93deee296 100644 --- a/de/15.9/install/upgrade.rst +++ b/de/15.9/install/upgrade.rst @@ -23,7 +23,7 @@ Dieses Upgrade-Verfahren unterstützt Upgrades zwischen folgenden Versionen: .. important:: - |Fess| 14.x unterstützt OpenSearch der 2.x-Reihe, |Fess| 15.9 unterstützt OpenSearch 3.8.0. + |Fess| 14.x unterstützt OpenSearch der 2.x-Reihe, |Fess| 15.9 unterstützt OpenSearch 3.9.0. Da die OpenSearch-Plugins für |Fess| exakt mit der OpenSearch-Version übereinstimmen müssen, ist beim Upgrade von 14.x auch ein Major-Version-Upgrade von OpenSearch zwingend erforderlich. Siehe :ref:`upgrade-opensearch`. @@ -358,7 +358,7 @@ Docker-Version Schritt 4: Upgrade von OpenSearch ================================= -|Fess| 15.9 unterstützt OpenSearch 3.8.0. Wenn das verbundene OpenSearch älter ist, aktualisieren +|Fess| 15.9 unterstützt OpenSearch 3.9.0. Wenn das verbundene OpenSearch älter ist, aktualisieren Sie es anhand der folgenden Schritte. .. note:: @@ -390,21 +390,29 @@ Sie es anhand der folgenden Schritte. |Fess| 14.x setzt auf OpenSearch der 2.x-Reihe, daher trifft dies bei einem Upgrade von 14.x immer zu. + Ein mit OpenSearch 3.9.0 erstellter Snapshot lässt sich nicht in OpenSearch 3.8.0 oder älter + wiederherstellen. Bewahren Sie den vor dem Upgrade erstellten Snapshot für ein mögliches Rollback + auf. + 1. Installieren Sie die neue Version von OpenSearch 2. Plugins neu installieren:: - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-fess:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-extension:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-minhash:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-configsync:3.8.0 + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-fess/3.9.0/opensearch-analysis-fess-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-extension/3.9.0/opensearch-analysis-extension-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-minhash/3.9.0/opensearch-minhash-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-configsync/3.9.0/opensearch-configsync-3.9.0.zip .. note:: Die Versionen dieser Plugins müssen mit der verwendeten OpenSearch-Version übereinstimmen. - |Fess| 15.9 ist kompatibel mit OpenSearch 3.8.0. Bei Versionsabweichungen schlägt die + |Fess| 15.9 ist kompatibel mit OpenSearch 3.9.0. Bei Versionsabweichungen schlägt die Plugin-Installation fehl. + Die vier Plugins für |Fess| werden auf maven.codelibs.org veröffentlicht und daher per URL + installiert. Die Form ``groupId:artifactId:version`` von ``opensearch-plugin install`` sucht + nur in Maven Central. + 3. Wörterbuchverzeichnis unter das OpenSearch-Konfigurationsverzeichnis verschieben Ab OpenSearch 3.8.0 wird die Erstellung eines Index verweigert, wenn sich Wörterbuchdateien außerhalb des OpenSearch-Konfigurationsverzeichnisses befinden. @@ -500,6 +508,9 @@ Bei Major-Version-Upgrades wird die Neuerstellung des Index empfohlen. die „Neuindizierung" unter „Systeminformationen" → „Wartung" in der Admin-Oberfläche aus. Siehe :ref:`semantic-search-migration` (:doc:`../config/search-semantic`) für Details. + Wenn Sie einen mit 15.8 oder älter erstellten Dokumentindex weiterverwenden, lesen Sie auch + :ref:`upgrade-reindex-new-fields`. + 1. Überprüfen Sie bestehende Crawl-Zeitpläne 2. Führen Sie „Default Crawler" unter „System" → „Scheduler" aus 3. Warten Sie, bis der Crawl abgeschlossen ist @@ -1000,6 +1011,44 @@ setzen Sie ``login.required=true``. Zugriffstoken funktionieren wie bisher: Eine registrierten Zugriffstoken erhält dessen Berechtigungen, eine Anfrage mit einem nicht registrierten oder abgelaufenen Token wird abgelehnt. +.. _upgrade-reindex-new-fields: + +Neue Felder und Kana-Normalisierung auf einen vorhandenen Dokumentindex anwenden +-------------------------------------------------------------------------------- + +Beim Start fügt 15.9 den Konfigurations-, Log- und Benutzerindizes neue Felder hinzu, ändert aber +weder das Mapping noch die Analyseeinstellungen des Dokumentindex. Wenn Sie einen mit 15.8 oder älter +erstellten Dokumentindex weiterverwenden, wirken die folgenden Änderungen von 15.9 nicht. + +- **Eigentümer und letzter Bearbeiter einer Datei** (``owner``, ``last_modifier``): neue Felder, die + beim Crawlen von Dateisystem, SMB und FTP indiziert werden. Der vorhandene Dokumentindex enthält + keine Definition dafür, daher werden sie anhand des ersten gecrawlten Werts dynamisch als ``text`` + gemappt, und Suchen wie ``owner:alice`` oder ``facet.field=owner`` funktionieren nicht wie vorgesehen. +- **Normalisierung von Kana-Varianten und von Strichen anstelle des Dehnungszeichens** (zum Beispiel + wird ``サ―バ－`` als dasselbe Wort wie ``サーバー`` behandelt): Die Regeln stehen in den + Analyseeinstellungen des Dokumentindex und im Wörterbuch ``mapping.txt``, ein vorhandener Index + erhält sie daher nicht. + +Um beides anzuwenden, aktivieren Sie unter „Systeminformationen" → „Wartung" in der +Admin-Oberfläche „Aliase ersetzen" und „Wörterbücher zurücksetzen" und führen die „Neuindizierung" +aus. Die Neuindizierung kopiert die vorhandenen Dokumente in einen neuen Index; ein erneuter Crawl +ist nicht nötig. + +.. warning:: + + „Wörterbücher zurücksetzen" überschreibt die Wörterbücher auf der OpenSearch-Seite mit den + mitgelieferten Wörterbuchdateien. Wenn Sie Synonyme oder andere Wörterbücher unter „Wörterbuch" + in der Admin-Oberfläche bearbeitet haben, laden Sie sie vorher herunter und übernehmen Sie sie + nach der Neuindizierung erneut. + +.. note:: + + Dateien, die mit 15.8 oder älter indiziert wurden, haben keine Werte für Eigentümer und letzten + Bearbeiter. Beim inkrementellen Crawlen werden unveränderte Dateien nicht erneut abgerufen. + Deaktivieren Sie daher vorübergehend „Letzte Änderung prüfen" unter „System" → „Allgemein" und + crawlen Sie, um die Werte zu ergänzen. + + Migrationsaufgaben speziell für 15.9 ==================================== @@ -1344,10 +1393,10 @@ F: Muss auch OpenSearch aktualisiert werden? --------------------------------------------- A: Für jede |Fess|-Version ist eine bestimmte OpenSearch-Version vorgesehen. -|Fess| 15.9 unterstützt OpenSearch 3.8.0. +|Fess| 15.9 unterstützt OpenSearch 3.9.0. Da die |Fess|-spezifischen OpenSearch-Plugins wie ``opensearch-analysis-fess`` exakt mit der OpenSearch-Version übereinstimmen müssen, aktualisieren Sie beim Upgrade von OpenSearch die Plugins -auf die entsprechende Version (3.8.0). +auf die entsprechende Version (3.9.0). |Fess| 15.9 setzt außerdem zwingend das k-NN-Plugin voraus und sendet in den Indexeinstellungen stets ``knn.derived_source.enabled``. Mit einem älteren OpenSearch schlägt die Erstellung neuer @@ -1369,6 +1418,8 @@ In folgenden Fällen ist eine Neuerstellung bzw. Neuindizierung erforderlich: finden Sie unter :ref:`semantic-search-migration` (:doc:`../config/search-semantic`). - **Beim Upgrade von 14.x**: Da OpenSearch dabei ein Major-Version-Upgrade von 2.x auf 3.x durchläuft, wird die Neuerstellung des Index empfohlen. +- **Suche nach Eigentümer oder Kana-Normalisierung mit einem unter 15.8 oder älter erstellten + Dokumentindex**: Eine Neuindizierung ist erforderlich. Siehe :ref:`upgrade-reindex-new-fields`. .. warning:: diff --git a/en/15.9/install/install-linux.rst b/en/15.9/install/install-linux.rst index 955fa53e8..a06440f6b 100644 --- a/en/15.9/install/install-linux.rst +++ b/en/15.9/install/install-linux.rst @@ -15,7 +15,7 @@ Prerequisites - The system requirements described in :doc:`prerequisites` are met - Java 21 is installed -- OpenSearch 3.8.0 is available for use (or is newly installed) +- OpenSearch 3.9.0 is available for use (or is newly installed) Choosing an Installation Method ================================ @@ -126,14 +126,14 @@ Step 1: Install OpenSearch :: - $ wget https://artifacts.opensearch.org/releases/bundle/opensearch/3.8.0/opensearch-3.8.0-linux-x64.tar.gz - $ tar -xzf opensearch-3.8.0-linux-x64.tar.gz - $ cd opensearch-3.8.0 + $ wget https://artifacts.opensearch.org/releases/bundle/opensearch/3.9.0/opensearch-3.9.0-linux-x64.tar.gz + $ tar -xzf opensearch-3.9.0-linux-x64.tar.gz + $ cd opensearch-3.9.0 .. note:: - This example uses OpenSearch 3.8.0. - |Fess| 15.9 supports OpenSearch 3.8.0. + This example uses OpenSearch 3.9.0. + |Fess| 15.9 supports OpenSearch 3.9.0. 2. Install OpenSearch Plugins @@ -141,16 +141,20 @@ Step 1: Install OpenSearch :: - $ cd /path/to/opensearch-3.8.0 - $ ./bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-fess:3.8.0 - $ ./bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-extension:3.8.0 - $ ./bin/opensearch-plugin install org.codelibs.opensearch:opensearch-minhash:3.8.0 - $ ./bin/opensearch-plugin install org.codelibs.opensearch:opensearch-configsync:3.8.0 + $ cd /path/to/opensearch-3.9.0 + $ ./bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-fess/3.9.0/opensearch-analysis-fess-3.9.0.zip + $ ./bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-extension/3.9.0/opensearch-analysis-extension-3.9.0.zip + $ ./bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-minhash/3.9.0/opensearch-minhash-3.9.0.zip + $ ./bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-configsync/3.9.0/opensearch-configsync-3.9.0.zip .. important:: Plugin versions must match the OpenSearch version. - In the example above, all are specified as 3.8.0. + In the example above, all are specified as 3.9.0. + + The four |Fess| plugins are published on maven.codelibs.org, so they are installed by URL. The + ``groupId:artifactId:version`` form of ``opensearch-plugin install`` looks only at Maven + Central. 3. Configure OpenSearch @@ -159,16 +163,16 @@ Step 1: Install OpenSearch :: # Path for configuration synchronization (specify an absolute path) - configsync.config_path: /path/to/opensearch-3.8.0/config/dictionary/ + configsync.config_path: /path/to/opensearch-3.9.0/config/dictionary/ # Disable the security plugin (development environments only) plugins.security.disabled: true .. important:: - Set ``configsync.config_path`` to a directory under the OpenSearch configuration directory (``/path/to/opensearch-3.8.0/config/`` in this example). + Set ``configsync.config_path`` to a directory under the OpenSearch configuration directory (``/path/to/opensearch-3.9.0/config/`` in this example). OpenSearch 3.8.0 and later refuse to create an index when dictionary files are outside the configuration directory. - If you specify a directory outside the configuration directory, such as ``/path/to/opensearch-3.8.0/data/config/``, |Fess| cannot create its indices and does not start. + If you specify a directory outside the configuration directory, such as ``/path/to/opensearch-3.9.0/data/config/``, |Fess| cannot create its indices and does not start. .. warning:: @@ -239,7 +243,7 @@ Step 2: Install Fess After:: SEARCH_ENGINE_HTTP_URL=${SEARCH_ENGINE_HTTP_URL:-http://localhost:9200} - FESS_DICTIONARY_PATH=/path/to/opensearch-3.8.0/config/dictionary/ + FESS_DICTIONARY_PATH=/path/to/opensearch-3.9.0/config/dictionary/ .. note:: @@ -282,8 +286,8 @@ Step 1: Install OpenSearch :: - $ wget https://artifacts.opensearch.org/releases/bundle/opensearch/3.8.0/opensearch-3.8.0-linux-x64.rpm - $ sudo rpm -ivh opensearch-3.8.0-linux-x64.rpm + $ wget https://artifacts.opensearch.org/releases/bundle/opensearch/3.9.0/opensearch-3.9.0-linux-x64.rpm + $ sudo rpm -ivh opensearch-3.9.0-linux-x64.rpm Alternatively, you can add a repository and install from it. For details, refer to `Installing OpenSearch `__. @@ -292,10 +296,10 @@ Step 1: Install OpenSearch :: - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-fess:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-extension:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-minhash:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-configsync:3.8.0 + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-fess/3.9.0/opensearch-analysis-fess-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-extension/3.9.0/opensearch-analysis-extension-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-minhash/3.9.0/opensearch-minhash-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-configsync/3.9.0/opensearch-configsync-3.9.0.zip 3. Configure OpenSearch @@ -392,8 +396,8 @@ Step 1: Install OpenSearch :: - $ wget https://artifacts.opensearch.org/releases/bundle/opensearch/3.8.0/opensearch-3.8.0-linux-x64.deb - $ sudo dpkg -i opensearch-3.8.0-linux-x64.deb + $ wget https://artifacts.opensearch.org/releases/bundle/opensearch/3.9.0/opensearch-3.9.0-linux-x64.deb + $ sudo dpkg -i opensearch-3.9.0-linux-x64.deb Alternatively, you can add a repository and install from it. For details, refer to `Installing OpenSearch `__. @@ -402,10 +406,10 @@ Step 1: Install OpenSearch :: - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-fess:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-extension:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-minhash:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-configsync:3.8.0 + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-fess/3.9.0/opensearch-analysis-fess-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-extension/3.9.0/opensearch-analysis-extension-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-minhash/3.9.0/opensearch-minhash-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-configsync/3.9.0/opensearch-configsync-3.9.0.zip 3. Configure OpenSearch @@ -502,7 +506,7 @@ After the installation is complete, verify the following: For the ZIP version:: - $ ls -ld /path/to/opensearch-3.8.0/config/dictionary/ + $ ls -ld /path/to/opensearch-3.9.0/config/dictionary/ For the RPM/DEB versions:: @@ -540,7 +544,7 @@ Q: Will other versions of OpenSearch work? --------------------------------------------- A: |Fess| depends on a specific version of OpenSearch. -To ensure plugin compatibility, it is strongly recommended to use the recommended version (3.8.0). +To ensure plugin compatibility, it is strongly recommended to use the recommended version (3.9.0). If you use a different version, you must also adjust the plugin versions appropriately. Q: Can multiple Fess instances share the same OpenSearch? diff --git a/en/15.9/install/install-windows.rst b/en/15.9/install/install-windows.rst index 4d1e2a5c2..d40b89ba6 100644 --- a/en/15.9/install/install-windows.rst +++ b/en/15.9/install/install-windows.rst @@ -15,7 +15,7 @@ Prerequisites - System requirements described in :doc:`prerequisites` are met - Java 21 is installed -- OpenSearch 3.8.0 is available (or new installation) +- OpenSearch 3.9.0 is available (or new installation) - Windows environment variable ``JAVA_HOME`` is configured appropriately Verify Java Installation @@ -80,7 +80,7 @@ Step 1: Install OpenSearch Follow the steps below to work through them individually, or when using an OpenSearch you already have. To install only the plugins into an existing OpenSearch, use - ``bin\fess-setup install opensearch-plugins --opensearch-home C:\opensearch-3.8.0``. + ``bin\fess-setup install opensearch-plugins --opensearch-home C:\opensearch-3.9.0``. See :doc:`fess-setup` for all commands. Download OpenSearch @@ -92,7 +92,7 @@ Download OpenSearch Example:: - C:\opensearch-3.8.0 + C:\opensearch-3.9.0 .. note:: @@ -105,16 +105,19 @@ Open Command Prompt **with administrator privileges** and execute the following :: - C:\> cd C:\opensearch-3.8.0 - C:\opensearch-3.8.0> bin\opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-fess:3.8.0 - C:\opensearch-3.8.0> bin\opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-extension:3.8.0 - C:\opensearch-3.8.0> bin\opensearch-plugin install org.codelibs.opensearch:opensearch-minhash:3.8.0 - C:\opensearch-3.8.0> bin\opensearch-plugin install org.codelibs.opensearch:opensearch-configsync:3.8.0 + C:\> cd C:\opensearch-3.9.0 + C:\opensearch-3.9.0> bin\opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-fess/3.9.0/opensearch-analysis-fess-3.9.0.zip + C:\opensearch-3.9.0> bin\opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-extension/3.9.0/opensearch-analysis-extension-3.9.0.zip + C:\opensearch-3.9.0> bin\opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-minhash/3.9.0/opensearch-minhash-3.9.0.zip + C:\opensearch-3.9.0> bin\opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-configsync/3.9.0/opensearch-configsync-3.9.0.zip .. important:: Plugin versions must match the OpenSearch version. - In the example above, all are specified as 3.8.0. + In the example above, all are specified as 3.9.0. + + The four |Fess| plugins are published on maven.codelibs.org, so they are installed by URL. The + ``groupId:artifactId:version`` form of ``opensearch-plugin install`` looks only at Maven Central. Configure OpenSearch -------------------- @@ -124,7 +127,7 @@ Open ``config\opensearch.yml`` with a text editor and add the following settings :: # Configuration synchronization path (specify absolute path) - configsync.config_path: C:/opensearch-3.8.0/config/dictionary/ + configsync.config_path: C:/opensearch-3.9.0/config/dictionary/ # Disable security plugin (development environment only) plugins.security.disabled: true @@ -140,13 +143,13 @@ Open ``config\opensearch.yml`` with a text editor and add the following settings .. note:: On Windows, use ``/`` instead of ``\`` for path separators. - Write ``C:/opensearch-3.8.0/config/dictionary/`` instead of ``C:\opensearch-3.8.0\config\dictionary\``. + Write ``C:/opensearch-3.9.0/config/dictionary/`` instead of ``C:\opensearch-3.9.0\config\dictionary\``. .. important:: - Set ``configsync.config_path`` to a directory under the OpenSearch configuration directory (``C:/opensearch-3.8.0/config/`` in this example). + Set ``configsync.config_path`` to a directory under the OpenSearch configuration directory (``C:/opensearch-3.9.0/config/`` in this example). OpenSearch 3.8.0 and later refuse to create an index when dictionary files are outside the configuration directory. - If you specify a directory outside the configuration directory, such as ``C:/opensearch-3.8.0/data/config/``, |Fess| cannot create its indices and does not start. + If you specify a directory outside the configuration directory, such as ``C:/opensearch-3.9.0/data/config/``, |Fess| cannot create its indices and does not start. .. tip:: @@ -203,7 +206,7 @@ After:: REM External opensearch cluster set FESS_JAVA_OPTS=%FESS_JAVA_OPTS% -Dfess.search_engine.http_address=http://localhost:9200 - set FESS_JAVA_OPTS=%FESS_JAVA_OPTS% -Dfess.dictionary.path=C:/opensearch-3.8.0/config/dictionary/ + set FESS_JAVA_OPTS=%FESS_JAVA_OPTS% -Dfess.dictionary.path=C:/opensearch-3.9.0/config/dictionary/ .. note:: @@ -314,7 +317,7 @@ Windows has a path length limitation. It is recommended to install in a path as Example:: C:\opensearch (recommended) - C:\Program Files\opensearch-3.8.0 (not recommended - path is too long) + C:\Program Files\opensearch-3.9.0 (not recommended - path is too long) Java Not Recognized ------------------- diff --git a/en/15.9/install/install.rst b/en/15.9/install/install.rst index da9934c5c..daafda6f8 100644 --- a/en/15.9/install/install.rst +++ b/en/15.9/install/install.rst @@ -126,7 +126,7 @@ The basic flow is the same for all installation methods. For non-Docker versions, OpenSearch must be set up separately. - - Install OpenSearch 3.8.0 + - Install OpenSearch 3.9.0 - Install required plugins - Edit configuration files @@ -157,7 +157,7 @@ OpenSearch OpenSearch is used as the search engine. -- **Supported Version**: OpenSearch 3.8.0 +- **Supported Version**: OpenSearch 3.9.0 - **Required Plugins**: - opensearch-analysis-fess @@ -235,7 +235,7 @@ Version Information This document covers the following versions: - **Fess**: 15.9.0 -- **OpenSearch**: 3.8.0 +- **OpenSearch**: 3.9.0 - **Java**: 21 or later - **Docker**: 20.10 or later - **Docker Compose**: 2.0 or later diff --git a/en/15.9/install/prerequisites.rst b/en/15.9/install/prerequisites.rst index 73c48f022..18ffdf858 100644 --- a/en/15.9/install/prerequisites.rst +++ b/en/15.9/install/prerequisites.rst @@ -74,9 +74,9 @@ ZIP/RPM/DEB Versions - OpenJDK 21 or later - Eclipse Temurin 21 or later -- **OpenSearch 3.8.0**: Required. |Fess| refuses to start against an engine older than OpenSearch 3 +- **OpenSearch 3.9.0**: Required. |Fess| refuses to start against an engine older than OpenSearch 3 - - Supported Version: OpenSearch 3.8.0 + - Supported Version: OpenSearch 3.9.0 - Compatibility with plugins must be considered for other versions Docker Version diff --git a/en/15.9/install/run.rst b/en/15.9/install/run.rst index c640ca563..20a560454 100644 --- a/en/15.9/install/run.rst +++ b/en/15.9/install/run.rst @@ -22,7 +22,7 @@ Start OpenSearch :: - $ cd /path/to/opensearch-3.8.0 + $ cd /path/to/opensearch-3.9.0 $ ./bin/opensearch To start in the background:: @@ -31,7 +31,7 @@ To start in the background:: .. note:: - ``bin/fess-setup install opensearch`` puts OpenSearch in ``opensearch/opensearch-3.8.0`` in the + ``bin/fess-setup install opensearch`` puts OpenSearch in ``opensearch/opensearch-3.9.0`` in the |Fess| directory. .. important:: @@ -42,7 +42,7 @@ To start in the background:: fails with ``AccessDeniedException``. Give the OpenSearch directory back to that user before starting it again, for example:: - $ sudo chown -R /path/to/opensearch-3.8.0 + $ sudo chown -R /path/to/opensearch-3.9.0 Start Fess ~~~~~~~~~~ @@ -72,8 +72,8 @@ Start OpenSearch Or from Command Prompt:: - C:\> cd C:\opensearch-3.8.0 - C:\opensearch-3.8.0> bin\opensearch.bat + C:\> cd C:\opensearch-3.9.0 + C:\opensearch-3.9.0> bin\opensearch.bat Start Fess ~~~~~~~~~~ diff --git a/en/15.9/install/troubleshooting.rst b/en/15.9/install/troubleshooting.rst index 490d15c8d..ddb020b54 100644 --- a/en/15.9/install/troubleshooting.rst +++ b/en/15.9/install/troubleshooting.rst @@ -70,7 +70,7 @@ Plugin Installation Fails 2. Match plugin version to OpenSearch version:: - $ /path/to/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-fess:3.6.0 + $ /path/to/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-fess/3.9.0/opensearch-analysis-fess-3.9.0.zip 3. Verify permissions:: @@ -196,7 +196,7 @@ OpenSearch 3.8.0 and later refuse to create an index when dictionary files are o 1. Change ``configsync.config_path`` and ``FESS_DICTIONARY_PATH`` to a directory under the OpenSearch configuration directory. - RPM/DEB version: ``/etc/opensearch/dictionary/`` - - ZIP version: ``/path/to/opensearch-3.8.0/config/dictionary/`` + - ZIP version: ``/path/to/opensearch-3.9.0/config/dictionary/`` 2. If you have existing dictionary files, copy them to the new directory. 3. Restart OpenSearch, then |Fess|. diff --git a/en/15.9/install/uninstall.rst b/en/15.9/install/uninstall.rst index 64c0f9bd5..cca0666f6 100644 --- a/en/15.9/install/uninstall.rst +++ b/en/15.9/install/uninstall.rst @@ -77,13 +77,13 @@ Step 2: Remove OpenSearch Delete the OpenSearch installation directory:: - $ rm -rf /path/to/opensearch-3.8.0 + $ rm -rf /path/to/opensearch-3.9.0 Step 3: Delete the Data Directory (Optional) -------------------------------------------- |Fess|'s index data is stored in OpenSearch. -By default it is stored inside the OpenSearch installation directory (such as ``opensearch-3.8.0/data``), +By default it is stored inside the OpenSearch installation directory (such as ``opensearch-3.9.0/data``), but if you have specified a different location with ``path.data``, delete that directory as well:: $ rm -rf /path/to/data @@ -94,7 +94,7 @@ Step 4: Delete the Log Directory (Optional) Delete the log files:: $ rm -rf /path/to/fess-15.9.0/logs - $ rm -rf /path/to/opensearch-3.8.0/logs + $ rm -rf /path/to/opensearch-3.9.0/logs Uninstalling the RPM Version ============================ @@ -310,7 +310,7 @@ To remove the Docker images and free up disk space:: $ docker images | grep fess $ docker rmi ghcr.io/codelibs/fess:15.9.0 - $ docker rmi ghcr.io/codelibs/fess-opensearch:3.8.0 + $ docker rmi ghcr.io/codelibs/fess-opensearch:3.9.0 Step 4: Remove Compose Files ---------------------------- diff --git a/en/15.9/install/upgrade.rst b/en/15.9/install/upgrade.rst index 26b741032..e0834c6b5 100644 --- a/en/15.9/install/upgrade.rst +++ b/en/15.9/install/upgrade.rst @@ -23,7 +23,7 @@ This upgrade procedure supports upgrades between the following versions: .. important:: - |Fess| 14.x supports the OpenSearch 2.x series, while |Fess| 15.9 supports OpenSearch 3.8.0. + |Fess| 14.x supports the OpenSearch 2.x series, while |Fess| 15.9 supports OpenSearch 3.9.0. Because the OpenSearch plugins for |Fess| must exactly match the OpenSearch version, upgrading from 14.x also requires a major version upgrade of OpenSearch. See :ref:`upgrade-opensearch` for details. @@ -351,7 +351,7 @@ Docker Version Step 4: Upgrade OpenSearch ========================== -|Fess| 15.9 supports OpenSearch 3.8.0. If the OpenSearch you connect to is older than that, +|Fess| 15.9 supports OpenSearch 3.9.0. If the OpenSearch you connect to is older than that, upgrade it using the following procedure. .. note:: @@ -383,19 +383,26 @@ upgrade it using the following procedure. |Fess| 14.x uses the OpenSearch 2.x series, so upgrading from 14.x always falls into this case. + A snapshot taken on OpenSearch 3.9.0 cannot be restored to OpenSearch 3.8.0 or earlier. Keep the + snapshot you took before the upgrade in case you need to roll back. + 1. Install the new version of OpenSearch 2. Reinstall plugins:: - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-fess:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-extension:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-minhash:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-configsync:3.8.0 + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-fess/3.9.0/opensearch-analysis-fess-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-extension/3.9.0/opensearch-analysis-extension-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-minhash/3.9.0/opensearch-minhash-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-configsync/3.9.0/opensearch-configsync-3.9.0.zip .. note:: The version of these plugins must match the version of OpenSearch you use. |Fess| 15.9 - supports OpenSearch 3.8.0. Installation fails if the versions do not match. + supports OpenSearch 3.9.0. Installation fails if the versions do not match. + + The four |Fess| plugins are published on maven.codelibs.org, so they are installed by URL. The + ``groupId:artifactId:version`` form of ``opensearch-plugin install`` looks only at Maven + Central. 3. Move the dictionary directory under the OpenSearch configuration directory @@ -492,6 +499,9 @@ For major version upgrades, it is recommended to recreate the index. the admin UI. See :ref:`semantic-search-migration` (in :doc:`../config/search-semantic`) for details. + If you keep a document index created by 15.8 or earlier, also see + :ref:`upgrade-reindex-new-fields`. + 1. Verify existing crawl schedules 2. Execute "Default Crawler" from "System" → "Scheduler" 3. Wait for crawl to complete @@ -962,6 +972,41 @@ guest roles, as it does the search screen. To keep anonymous users from searchin ``login.required=true``. Access tokens work as before: a request with a registered access token is given the token's permissions, and a request with an unregistered or expired token is refused. +.. _upgrade-reindex-new-fields: + +Applying New Fields and Kana Normalization to an Existing Document Index +------------------------------------------------------------------------ + +At startup 15.9 adds new fields to the configuration, log and user indices, but it does not change +the mapping or the analysis settings of the document index. If you keep using a document index +created by 15.8 or earlier, the following 15.9 changes do not take effect. + +- **File owner and last modifier** (``owner``, ``last_modifier``): new fields indexed by file + system, SMB and FTP crawls. The existing document index has no definition for them, so the first + crawled value maps them dynamically as ``text``, and searches such as ``owner:alice`` or + ``facet.field=owner`` do not work as intended. +- **Normalization of kana variants and of dashes written in place of the long vowel mark** (for + example, ``サ―バ－`` is treated as the same word as ``サーバー``): the rules live in the analysis + settings of the document index and in the ``mapping.txt`` dictionary, so an existing index does + not get them. + +To apply both, enable "Replace Aliases" and "Reset Dictionaries" under "System Info" → "Maintenance" +in the admin UI and run "Re-indexing". Re-indexing copies the existing documents into a new index, so +you do not need to crawl again. + +.. warning:: + + "Reset Dictionaries" overwrites the dictionaries on the OpenSearch side with the bundled + dictionary files. If you have edited synonyms or other dictionaries under "Dictionary" in the + admin UI, download them first and apply them again after re-indexing. + +.. note:: + + Files indexed by 15.8 or earlier have no owner or last modifier values. Incremental crawling does + not fetch unchanged files again, so to add the values, temporarily disable "Check Last Modified" + under "System" → "General" and crawl. + + 15.9-Specific Migration Tasks ============================= @@ -1279,10 +1324,10 @@ Q: Do I need to upgrade OpenSearch too? ---------------------------------------- A: Each version of |Fess| requires a specific version of OpenSearch. -|Fess| 15.9 requires OpenSearch 3.8.0. +|Fess| 15.9 requires OpenSearch 3.9.0. The |Fess| OpenSearch plugins such as ``opensearch-analysis-fess`` must exactly match the OpenSearch version, so if you upgrade OpenSearch, also update the plugins to the corresponding -version (3.8.0). +version (3.9.0). Also, |Fess| 15.9 requires the k-NN plugin and always sends ``knn.derived_source.enabled`` in the index settings. With an older OpenSearch, creating a new index fails, so upgrading OpenSearch is @@ -1302,6 +1347,8 @@ Recreation and re-indexing are required in the following cases: :doc:`../config/search-semantic`) for details. - **Upgrading from 14.x**: Because OpenSearch undergoes a major version upgrade from 2.x to 3.x, recreating the index is recommended. +- **Using owner search or the kana normalization with a document index created by 15.8 or earlier**: + a re-index is needed. See :ref:`upgrade-reindex-new-fields` for details. .. warning:: diff --git a/es/15.9/install/install-linux.rst b/es/15.9/install/install-linux.rst index 1bf6216d5..fc9f7eafc 100644 --- a/es/15.9/install/install-linux.rst +++ b/es/15.9/install/install-linux.rst @@ -15,7 +15,7 @@ Requisitos Previos - Cumplir con los requisitos del sistema descritos en :doc:`prerequisites` - Java 21 instalado -- OpenSearch 3.8.0 disponible (o nueva instalación) +- OpenSearch 3.9.0 disponible (o nueva instalación) Selección del Método de Instalación ===================================== @@ -130,14 +130,14 @@ Paso 1: Instalación de OpenSearch :: - $ wget https://artifacts.opensearch.org/releases/bundle/opensearch/3.8.0/opensearch-3.8.0-linux-x64.tar.gz - $ tar -xzf opensearch-3.8.0-linux-x64.tar.gz - $ cd opensearch-3.8.0 + $ wget https://artifacts.opensearch.org/releases/bundle/opensearch/3.9.0/opensearch-3.9.0-linux-x64.tar.gz + $ tar -xzf opensearch-3.9.0-linux-x64.tar.gz + $ cd opensearch-3.9.0 .. note:: - En este ejemplo se utiliza OpenSearch 3.8.0. - |Fess| 15.9 es compatible con OpenSearch 3.8.0. + En este ejemplo se utiliza OpenSearch 3.9.0. + |Fess| 15.9 es compatible con OpenSearch 3.9.0. 2. Instalación de plugins de OpenSearch @@ -145,16 +145,20 @@ Paso 1: Instalación de OpenSearch :: - $ cd /path/to/opensearch-3.8.0 - $ ./bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-fess:3.8.0 - $ ./bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-extension:3.8.0 - $ ./bin/opensearch-plugin install org.codelibs.opensearch:opensearch-minhash:3.8.0 - $ ./bin/opensearch-plugin install org.codelibs.opensearch:opensearch-configsync:3.8.0 + $ cd /path/to/opensearch-3.9.0 + $ ./bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-fess/3.9.0/opensearch-analysis-fess-3.9.0.zip + $ ./bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-extension/3.9.0/opensearch-analysis-extension-3.9.0.zip + $ ./bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-minhash/3.9.0/opensearch-minhash-3.9.0.zip + $ ./bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-configsync/3.9.0/opensearch-configsync-3.9.0.zip .. important:: Las versiones de los plugins deben coincidir con la versión de OpenSearch. - En el ejemplo anterior, se especifica 3.8.0 para todos. + En el ejemplo anterior, se especifica 3.9.0 para todos. + + Los cuatro plugins de |Fess| se publican en maven.codelibs.org, por lo que se instalan + mediante su URL. La forma ``groupId:artifactId:version`` de ``opensearch-plugin install`` solo + busca en Maven Central. 3. Configuración de OpenSearch @@ -163,16 +167,16 @@ Paso 1: Instalación de OpenSearch :: # Ruta para sincronización de configuración (especificar ruta absoluta) - configsync.config_path: /path/to/opensearch-3.8.0/config/dictionary/ + configsync.config_path: /path/to/opensearch-3.9.0/config/dictionary/ # Desactivación del plugin de seguridad (solo entorno de desarrollo) plugins.security.disabled: true .. important:: - Especifique en ``configsync.config_path`` un directorio dentro del directorio de configuración de OpenSearch (``/path/to/opensearch-3.8.0/config/`` en este ejemplo). + Especifique en ``configsync.config_path`` un directorio dentro del directorio de configuración de OpenSearch (``/path/to/opensearch-3.9.0/config/`` en este ejemplo). OpenSearch 3.8.0 y versiones posteriores rechazan la creación de índices cuando los archivos de diccionario están fuera del directorio de configuración. - Si especifica un directorio fuera del directorio de configuración, como ``/path/to/opensearch-3.8.0/data/config/``, |Fess| no puede crear sus índices y no se inicia. + Si especifica un directorio fuera del directorio de configuración, como ``/path/to/opensearch-3.9.0/data/config/``, |Fess| no puede crear sus índices y no se inicia. .. warning:: @@ -243,7 +247,7 @@ Paso 2: Instalación de Fess Después del cambio:: SEARCH_ENGINE_HTTP_URL=${SEARCH_ENGINE_HTTP_URL:-http://localhost:9200} - FESS_DICTIONARY_PATH=/path/to/opensearch-3.8.0/config/dictionary/ + FESS_DICTIONARY_PATH=/path/to/opensearch-3.9.0/config/dictionary/ .. note:: @@ -287,8 +291,8 @@ Paso 1: Instalación de OpenSearch :: - $ wget https://artifacts.opensearch.org/releases/bundle/opensearch/3.8.0/opensearch-3.8.0-linux-x64.rpm - $ sudo rpm -ivh opensearch-3.8.0-linux-x64.rpm + $ wget https://artifacts.opensearch.org/releases/bundle/opensearch/3.9.0/opensearch-3.9.0-linux-x64.rpm + $ sudo rpm -ivh opensearch-3.9.0-linux-x64.rpm Alternativamente, también puede agregar un repositorio para instalarlo. Para más detalles, consulte `Installing OpenSearch `__. @@ -297,10 +301,10 @@ Paso 1: Instalación de OpenSearch :: - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-fess:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-extension:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-minhash:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-configsync:3.8.0 + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-fess/3.9.0/opensearch-analysis-fess-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-extension/3.9.0/opensearch-analysis-extension-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-minhash/3.9.0/opensearch-minhash-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-configsync/3.9.0/opensearch-configsync-3.9.0.zip 3. Configuración de OpenSearch @@ -397,8 +401,8 @@ Paso 1: Instalación de OpenSearch :: - $ wget https://artifacts.opensearch.org/releases/bundle/opensearch/3.8.0/opensearch-3.8.0-linux-x64.deb - $ sudo dpkg -i opensearch-3.8.0-linux-x64.deb + $ wget https://artifacts.opensearch.org/releases/bundle/opensearch/3.9.0/opensearch-3.9.0-linux-x64.deb + $ sudo dpkg -i opensearch-3.9.0-linux-x64.deb Alternativamente, también puede agregar un repositorio para instalarlo. Para más detalles, consulte `Installing OpenSearch `__. @@ -407,10 +411,10 @@ Paso 1: Instalación de OpenSearch :: - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-fess:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-extension:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-minhash:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-configsync:3.8.0 + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-fess/3.9.0/opensearch-analysis-fess-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-extension/3.9.0/opensearch-analysis-extension-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-minhash/3.9.0/opensearch-minhash-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-configsync/3.9.0/opensearch-configsync-3.9.0.zip 3. Configuración de OpenSearch @@ -507,7 +511,7 @@ Después de completar la instalación, verifique lo siguiente: Para la versión ZIP:: - $ ls -ld /path/to/opensearch-3.8.0/config/dictionary/ + $ ls -ld /path/to/opensearch-3.9.0/config/dictionary/ Para las versiones RPM/DEB:: @@ -545,7 +549,7 @@ P: ¿Funciona con otras versiones de OpenSearch? -------------------------------------------------- R: |Fess| depende de una versión específica de OpenSearch. -Para garantizar la compatibilidad de los plugins, se recomienda encarecidamente utilizar la versión recomendada (3.8.0). +Para garantizar la compatibilidad de los plugins, se recomienda encarecidamente utilizar la versión recomendada (3.9.0). Si utiliza otra versión, también deberá ajustar adecuadamente las versiones de los plugins. P: ¿Se puede compartir el mismo OpenSearch entre varias instancias de Fess? diff --git a/es/15.9/install/install-windows.rst b/es/15.9/install/install-windows.rst index dc318237e..1a5515f32 100644 --- a/es/15.9/install/install-windows.rst +++ b/es/15.9/install/install-windows.rst @@ -15,7 +15,7 @@ Requisitos Previos - Cumplir con los requisitos del sistema descritos en :doc:`prerequisites` - Java 21 instalado -- OpenSearch 3.8.0 disponible (o nueva instalación) +- OpenSearch 3.9.0 disponible (o nueva instalación) - Variable de entorno ``JAVA_HOME`` de Windows configurada apropiadamente Verificación de la Instalación de Java @@ -82,7 +82,7 @@ Paso 1: Instalación de OpenSearch Siga los pasos siguientes para revisarlos uno a uno, o cuando utilice un OpenSearch que ya tenga. Para instalar únicamente los plugins en un OpenSearch existente, utilice - ``bin\fess-setup install opensearch-plugins --opensearch-home C:\opensearch-3.8.0``. + ``bin\fess-setup install opensearch-plugins --opensearch-home C:\opensearch-3.9.0``. Consulte :doc:`fess-setup` para ver todos los comandos. Descarga de OpenSearch @@ -94,7 +94,7 @@ Descarga de OpenSearch Ejemplo:: - C:\opensearch-3.8.0 + C:\opensearch-3.9.0 .. note:: @@ -107,16 +107,20 @@ Abra el Símbolo del sistema **con privilegios de administrador** y ejecute los :: - C:\> cd C:\opensearch-3.8.0 - C:\opensearch-3.8.0> bin\opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-fess:3.8.0 - C:\opensearch-3.8.0> bin\opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-extension:3.8.0 - C:\opensearch-3.8.0> bin\opensearch-plugin install org.codelibs.opensearch:opensearch-minhash:3.8.0 - C:\opensearch-3.8.0> bin\opensearch-plugin install org.codelibs.opensearch:opensearch-configsync:3.8.0 + C:\> cd C:\opensearch-3.9.0 + C:\opensearch-3.9.0> bin\opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-fess/3.9.0/opensearch-analysis-fess-3.9.0.zip + C:\opensearch-3.9.0> bin\opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-extension/3.9.0/opensearch-analysis-extension-3.9.0.zip + C:\opensearch-3.9.0> bin\opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-minhash/3.9.0/opensearch-minhash-3.9.0.zip + C:\opensearch-3.9.0> bin\opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-configsync/3.9.0/opensearch-configsync-3.9.0.zip .. important:: Las versiones de los plugins deben coincidir con la versión de OpenSearch. - En el ejemplo anterior, se especifica 3.8.0 para todos. + En el ejemplo anterior, se especifica 3.9.0 para todos. + + Los cuatro plugins de |Fess| se publican en maven.codelibs.org, por lo que se instalan mediante + su URL. La forma ``groupId:artifactId:version`` de ``opensearch-plugin install`` solo busca en + Maven Central. Configuración de OpenSearch ----------------------------- @@ -126,7 +130,7 @@ Abra ``config\opensearch.yml`` con un editor de texto y agregue la siguiente con :: # Ruta para sincronización de configuración (especificar ruta absoluta) - configsync.config_path: C:/opensearch-3.8.0/config/dictionary/ + configsync.config_path: C:/opensearch-3.9.0/config/dictionary/ # Desactivación del plugin de seguridad (solo entorno de desarrollo) plugins.security.disabled: true @@ -142,13 +146,13 @@ Abra ``config\opensearch.yml`` con un editor de texto y agregue la siguiente con .. note:: En Windows, use ``/`` en lugar de ``\`` como separador de ruta. - Escriba ``C:/opensearch-3.8.0/config/dictionary/`` en lugar de ``C:\opensearch-3.8.0\config\dictionary\``. + Escriba ``C:/opensearch-3.9.0/config/dictionary/`` en lugar de ``C:\opensearch-3.9.0\config\dictionary\``. .. important:: - Especifique en ``configsync.config_path`` un directorio dentro del directorio de configuración de OpenSearch (``C:/opensearch-3.8.0/config/`` en este ejemplo). + Especifique en ``configsync.config_path`` un directorio dentro del directorio de configuración de OpenSearch (``C:/opensearch-3.9.0/config/`` en este ejemplo). OpenSearch 3.8.0 y versiones posteriores rechazan la creación de índices cuando los archivos de diccionario están fuera del directorio de configuración. - Si especifica un directorio fuera del directorio de configuración, como ``C:/opensearch-3.8.0/data/config/``, |Fess| no puede crear sus índices y no se inicia. + Si especifica un directorio fuera del directorio de configuración, como ``C:/opensearch-3.9.0/data/config/``, |Fess| no puede crear sus índices y no se inicia. .. tip:: @@ -206,7 +210,7 @@ Estado después del cambio:: REM External opensearch cluster set FESS_JAVA_OPTS=%FESS_JAVA_OPTS% -Dfess.search_engine.http_address=http://localhost:9200 - set FESS_JAVA_OPTS=%FESS_JAVA_OPTS% -Dfess.dictionary.path=C:/opensearch-3.8.0/config/dictionary/ + set FESS_JAVA_OPTS=%FESS_JAVA_OPTS% -Dfess.dictionary.path=C:/opensearch-3.9.0/config/dictionary/ .. note:: @@ -317,7 +321,7 @@ En Windows, existe una limitación en la longitud de la ruta. Se recomienda inst Ejemplo:: C:\opensearch (recomendado) - C:\Program Files\opensearch-3.8.0 (no recomendado - ruta larga) + C:\Program Files\opensearch-3.9.0 (no recomendado - ruta larga) Java no Reconocido ------------------ diff --git a/es/15.9/install/install.rst b/es/15.9/install/install.rst index 9d56b475f..8a6dad941 100644 --- a/es/15.9/install/install.rst +++ b/es/15.9/install/install.rst @@ -126,7 +126,7 @@ El flujo básico es el mismo para todos los métodos de instalación. Para versiones que no sean Docker, debe configurar OpenSearch por separado. - - Instalación de OpenSearch 3.8.0 + - Instalación de OpenSearch 3.9.0 - Instalación de plugins requeridos - Edición de archivos de configuración @@ -157,7 +157,7 @@ OpenSearch Se utiliza OpenSearch como motor de búsqueda. -- **Versión Compatible**: OpenSearch 3.8.0 +- **Versión Compatible**: OpenSearch 3.9.0 - **Plugins Requeridos**: - opensearch-analysis-fess @@ -235,7 +235,7 @@ Información de Versión Este documento está dirigido a las siguientes versiones: - **Fess**: 15.9.0 -- **OpenSearch**: 3.8.0 +- **OpenSearch**: 3.9.0 - **Java**: 21 o posterior - **Docker**: 20.10 o posterior - **Docker Compose**: 2.0 o posterior diff --git a/es/15.9/install/prerequisites.rst b/es/15.9/install/prerequisites.rst index 19893757f..3a6ceaf34 100644 --- a/es/15.9/install/prerequisites.rst +++ b/es/15.9/install/prerequisites.rst @@ -74,9 +74,9 @@ Versión ZIP/RPM/DEB - OpenJDK 21 o posterior - Eclipse Temurin 21 o posterior -- **OpenSearch 3.8.0**: Obligatorio. |Fess| no se inicia con un motor anterior a OpenSearch 3 +- **OpenSearch 3.9.0**: Obligatorio. |Fess| no se inicia con un motor anterior a OpenSearch 3 - - Versión compatible: OpenSearch 3.8.0 + - Versión compatible: OpenSearch 3.9.0 - Tenga cuidado con la compatibilidad de plugins en otras versiones Versión Docker diff --git a/es/15.9/install/run.rst b/es/15.9/install/run.rst index 05d8bea6d..fed477d8f 100644 --- a/es/15.9/install/run.rst +++ b/es/15.9/install/run.rst @@ -22,7 +22,7 @@ Inicio de OpenSearch :: - $ cd /path/to/opensearch-3.8.0 + $ cd /path/to/opensearch-3.9.0 $ ./bin/opensearch Para iniciar en segundo plano:: @@ -31,7 +31,7 @@ Para iniciar en segundo plano:: .. note:: - ``bin/fess-setup install opensearch`` coloca OpenSearch en ``opensearch/opensearch-3.8.0`` + ``bin/fess-setup install opensearch`` coloca OpenSearch en ``opensearch/opensearch-3.9.0`` dentro del directorio de |Fess|. .. important:: @@ -42,7 +42,7 @@ Para iniciar en segundo plano:: usuario normal falla con ``AccessDeniedException``. Devuelva el directorio de OpenSearch a ese usuario antes de volver a iniciarlo, por ejemplo:: - $ sudo chown -R /path/to/opensearch-3.8.0 + $ sudo chown -R /path/to/opensearch-3.9.0 Inicio de Fess ~~~~~~~~~~~~~~ @@ -72,8 +72,8 @@ Inicio de OpenSearch O desde el Símbolo del sistema:: - C:\> cd C:\opensearch-3.8.0 - C:\opensearch-3.8.0> bin\opensearch.bat + C:\> cd C:\opensearch-3.9.0 + C:\opensearch-3.9.0> bin\opensearch.bat Inicio de Fess ~~~~~~~~~~~~~~ diff --git a/es/15.9/install/troubleshooting.rst b/es/15.9/install/troubleshooting.rst index 6f212e25a..c23a87696 100644 --- a/es/15.9/install/troubleshooting.rst +++ b/es/15.9/install/troubleshooting.rst @@ -70,7 +70,7 @@ Falla la Instalación de Plugin 2. Hacer coincidir la versión del plugin con la versión de OpenSearch:: - $ /path/to/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-fess:3.6.0 + $ /path/to/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-fess/3.9.0/opensearch-analysis-fess-3.9.0.zip 3. Verificar permisos:: @@ -197,7 +197,7 @@ OpenSearch 3.8.0 y versiones posteriores rechazan la creación de índices cuand 1. Cambie ``configsync.config_path`` y ``FESS_DICTIONARY_PATH`` a un directorio dentro del directorio de configuración de OpenSearch. - Versión RPM/DEB: ``/etc/opensearch/dictionary/`` - - Versión ZIP: ``/path/to/opensearch-3.8.0/config/dictionary/`` + - Versión ZIP: ``/path/to/opensearch-3.9.0/config/dictionary/`` 2. Si tiene archivos de diccionario existentes, cópielos al nuevo directorio. 3. Reinicie OpenSearch y, a continuación, |Fess|. diff --git a/es/15.9/install/uninstall.rst b/es/15.9/install/uninstall.rst index ea66c210b..59ab6183a 100644 --- a/es/15.9/install/uninstall.rst +++ b/es/15.9/install/uninstall.rst @@ -77,13 +77,13 @@ Paso 2: Eliminación de OpenSearch Elimine el directorio de instalación de OpenSearch:: - $ rm -rf /path/to/opensearch-3.8.0 + $ rm -rf /path/to/opensearch-3.9.0 Paso 3: Eliminación del Directorio de Datos (Opcional) ------------------------------------------------------ Los datos del índice de |Fess| se almacenan en OpenSearch. -Por defecto se guardan dentro del directorio de instalación de OpenSearch (por ejemplo, ``opensearch-3.8.0/data``), +Por defecto se guardan dentro del directorio de instalación de OpenSearch (por ejemplo, ``opensearch-3.9.0/data``), pero si ha especificado otra ubicación con ``path.data``, elimine también ese directorio:: $ rm -rf /path/to/data @@ -94,7 +94,7 @@ Paso 4: Eliminación del Directorio de Registros (Opcional) Elimine los archivos de registro:: $ rm -rf /path/to/fess-15.9.0/logs - $ rm -rf /path/to/opensearch-3.8.0/logs + $ rm -rf /path/to/opensearch-3.9.0/logs Desinstalación de Versión RPM ============================= @@ -310,7 +310,7 @@ Si desea eliminar las imágenes Docker para liberar espacio en disco:: $ docker images | grep fess $ docker rmi ghcr.io/codelibs/fess:15.9.0 - $ docker rmi ghcr.io/codelibs/fess-opensearch:3.8.0 + $ docker rmi ghcr.io/codelibs/fess-opensearch:3.9.0 Paso 4: Eliminación de Archivos Compose --------------------------------------- diff --git a/es/15.9/install/upgrade.rst b/es/15.9/install/upgrade.rst index 78dffff26..3de45c1c1 100644 --- a/es/15.9/install/upgrade.rst +++ b/es/15.9/install/upgrade.rst @@ -24,7 +24,7 @@ Estos procedimientos de actualización son compatibles con actualizaciones entre .. important:: |Fess| 14.x es compatible con la serie OpenSearch 2.x, mientras que |Fess| 15.9 es compatible - con OpenSearch 3.8.0. Los plugins de OpenSearch para |Fess| deben coincidir exactamente con la + con OpenSearch 3.9.0. Los plugins de OpenSearch para |Fess| deben coincidir exactamente con la versión de OpenSearch, por lo que si actualiza desde la versión 14.x también es obligatorio actualizar la versión principal de OpenSearch. Consulte :ref:`upgrade-opensearch`. @@ -357,7 +357,7 @@ Versión Docker Paso 4: Actualización de OpenSearch ==================================== -|Fess| 15.9 es compatible con OpenSearch 3.8.0. Si el OpenSearch al que se conecta es una versión +|Fess| 15.9 es compatible con OpenSearch 3.9.0. Si el OpenSearch al que se conecta es una versión anterior, actualícelo siguiendo estos procedimientos. .. note:: @@ -389,21 +389,28 @@ anterior, actualícelo siguiendo estos procedimientos. |Fess| 14.x utiliza la serie OpenSearch 2.x, por lo que una actualización desde 14.x siempre corresponde a este caso. + Una instantánea tomada con OpenSearch 3.9.0 no se puede restaurar en OpenSearch 3.8.0 o anterior. + Conserve la instantánea tomada antes de la actualización por si necesita revertirla. + 1. Instale la nueva versión de OpenSearch 2. Reinstale los plugins:: - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-fess:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-extension:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-minhash:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-configsync:3.8.0 + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-fess/3.9.0/opensearch-analysis-fess-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-extension/3.9.0/opensearch-analysis-extension-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-minhash/3.9.0/opensearch-minhash-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-configsync/3.9.0/opensearch-configsync-3.9.0.zip .. note:: La versión de estos plugins debe coincidir con la versión de OpenSearch que se utiliza. - |Fess| 15.9 es compatible con OpenSearch 3.8.0. Si las versiones no coinciden, + |Fess| 15.9 es compatible con OpenSearch 3.9.0. Si las versiones no coinciden, la instalación de los plugins fallará. + Los cuatro plugins de |Fess| se publican en maven.codelibs.org, por lo que se instalan + mediante su URL. La forma ``groupId:artifactId:version`` de ``opensearch-plugin install`` solo + busca en Maven Central. + 3. Mueva el directorio de diccionarios dentro del directorio de configuración de OpenSearch OpenSearch 3.8.0 y versiones posteriores rechazan la creación de índices cuando los archivos de diccionario están fuera del directorio de configuración de OpenSearch. @@ -500,6 +507,9 @@ Para actualizaciones de versión principal, se recomienda recrear el índice. administración. Consulte :ref:`semantic-search-migration` (:doc:`../config/search-semantic`) para más detalles. + Si sigue usando un índice de documentos creado con 15.8 o anterior, consulte también + :ref:`upgrade-reindex-new-fields`. + 1. Verifique los programas de rastreo existentes 2. Ejecute "Default Crawler" desde "Sistema" → "Programador" 3. Espere hasta que se complete el rastreo @@ -1001,6 +1011,43 @@ usuarios anónimos busquen, establezca ``login.required=true``. Los tokens de ac antes: una solicitud con un token de acceso registrado recibe los permisos de ese token, y una solicitud con un token no registrado o caducado se rechaza. +.. _upgrade-reindex-new-fields: + +Aplicar los nuevos campos y la normalización de kana a un índice de documentos existente +---------------------------------------------------------------------------------------- + +Al iniciarse, 15.9 añade campos nuevos a los índices de configuración, de registros y de usuarios, +pero no cambia el mapeo ni la configuración de análisis del índice de documentos. Si sigue usando un +índice de documentos creado con 15.8 o anterior, los siguientes cambios de 15.9 no tienen efecto. + +- **Propietario y último modificador de un archivo** (``owner``, ``last_modifier``): campos nuevos + que indexan los rastreos del sistema de archivos, SMB y FTP. El índice de documentos existente no + los define, por lo que el primer valor rastreado los mapea dinámicamente como ``text`` y las + búsquedas como ``owner:alice`` o ``facet.field=owner`` no funcionan como se espera. +- **Normalización de variantes de kana y de guiones escritos en lugar de la marca de vocal larga** + (por ejemplo, ``サ―バ－`` se trata como la misma palabra que ``サーバー``): las reglas están en la + configuración de análisis del índice de documentos y en el diccionario ``mapping.txt``, por lo que + un índice existente no las recibe. + +Para aplicar ambos, habilite "Actualizar alias" y "Restablecer diccionarios" en "Información del +sistema" → "Mantenimiento" en la interfaz de administración y ejecute la "Reindexación". La +reindexación copia los documentos existentes a un índice nuevo, por lo que no es necesario volver a +rastrear. + +.. warning:: + + "Restablecer diccionarios" sobrescribe los diccionarios del lado de OpenSearch con los archivos de + diccionario incluidos. Si ha editado sinónimos u otros diccionarios en "Diccionario" de la + interfaz de administración, descárguelos antes y vuelva a aplicarlos después de la reindexación. + +.. note:: + + Los archivos indexados con 15.8 o anterior no tienen valores de propietario ni de último + modificador. El rastreo incremental no vuelve a obtener los archivos sin cambios, así que, para + añadir los valores, deshabilite temporalmente "Comprobar fecha de última modificación" en + "Sistema" → "General" y rastree. + + Migración Específica de 15.9 ============================== @@ -1342,10 +1389,10 @@ P: ¿Es necesario actualizar también OpenSearch? ------------------------------------------------ R: Cada versión de |Fess| requiere una versión específica de OpenSearch. -|Fess| 15.9 es compatible con OpenSearch 3.8.0. +|Fess| 15.9 es compatible con OpenSearch 3.9.0. Los plugins de OpenSearch para |Fess|, como ``opensearch-analysis-fess``, deben coincidir exactamente con la versión de OpenSearch; por lo tanto, si actualiza OpenSearch, actualice también los plugins a la -versión correspondiente (3.8.0). +versión correspondiente (3.9.0). Tenga en cuenta que |Fess| 15.9 requiere el plugin k-NN y siempre envía ``knn.derived_source.enabled`` en la configuración del índice. Con un OpenSearch antiguo, la @@ -1367,6 +1414,8 @@ En los siguientes casos sí es necesario recrear el índice y reindexar: detalles, consulte :ref:`semantic-search-migration` (:doc:`../config/search-semantic`). - **Si actualiza desde 14.x**: dado que OpenSearch pasa de la serie 2.x a la 3.x (actualización de versión principal), se recomienda recrear el índice. +- **Si usa la búsqueda por propietario o la normalización de kana con un índice de documentos creado + con 15.8 o anterior**: se necesita una reindexación. Consulte :ref:`upgrade-reindex-new-fields`. .. warning:: diff --git a/fr/15.9/install/install-linux.rst b/fr/15.9/install/install-linux.rst index f0791eff4..967fafbb0 100644 --- a/fr/15.9/install/install-linux.rst +++ b/fr/15.9/install/install-linux.rst @@ -15,7 +15,7 @@ Prérequis - La configuration requise décrite dans :doc:`prerequisites` doit être satisfaite - Java 21 doit être installé -- OpenSearch 3.8.0 doit être disponible (ou nouvelle installation) +- OpenSearch 3.9.0 doit être disponible (ou nouvelle installation) Choix de la méthode d'installation =================================== @@ -129,14 +129,14 @@ Installation avec la version ZIP :: - $ wget https://artifacts.opensearch.org/releases/bundle/opensearch/3.8.0/opensearch-3.8.0-linux-x64.tar.gz - $ tar -xzf opensearch-3.8.0-linux-x64.tar.gz - $ cd opensearch-3.8.0 + $ wget https://artifacts.opensearch.org/releases/bundle/opensearch/3.9.0/opensearch-3.9.0-linux-x64.tar.gz + $ tar -xzf opensearch-3.9.0-linux-x64.tar.gz + $ cd opensearch-3.9.0 .. note:: - Cet exemple utilise OpenSearch 3.8.0. - |Fess| 15.9 est compatible avec OpenSearch 3.8.0. + Cet exemple utilise OpenSearch 3.9.0. + |Fess| 15.9 est compatible avec OpenSearch 3.9.0. 2. Installation des plugins OpenSearch @@ -144,16 +144,20 @@ Installation avec la version ZIP :: - $ cd /path/to/opensearch-3.8.0 - $ ./bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-fess:3.8.0 - $ ./bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-extension:3.8.0 - $ ./bin/opensearch-plugin install org.codelibs.opensearch:opensearch-minhash:3.8.0 - $ ./bin/opensearch-plugin install org.codelibs.opensearch:opensearch-configsync:3.8.0 + $ cd /path/to/opensearch-3.9.0 + $ ./bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-fess/3.9.0/opensearch-analysis-fess-3.9.0.zip + $ ./bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-extension/3.9.0/opensearch-analysis-extension-3.9.0.zip + $ ./bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-minhash/3.9.0/opensearch-minhash-3.9.0.zip + $ ./bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-configsync/3.9.0/opensearch-configsync-3.9.0.zip .. important:: Les versions des plugins doivent correspondre à la version d'OpenSearch. - Dans l'exemple ci-dessus, toutes sont spécifiées en 3.8.0. + Dans l'exemple ci-dessus, toutes sont spécifiées en 3.9.0. + + Les quatre plugins de |Fess| sont publiés sur maven.codelibs.org ; ils s'installent donc par + leur URL. La forme ``groupId:artifactId:version`` de ``opensearch-plugin install`` ne cherche + que dans Maven Central. 3. Configuration d'OpenSearch @@ -162,16 +166,16 @@ Installation avec la version ZIP :: # Chemin pour la synchronisation de configuration (spécifier en chemin absolu) - configsync.config_path: /path/to/opensearch-3.8.0/config/dictionary/ + configsync.config_path: /path/to/opensearch-3.9.0/config/dictionary/ # Désactivation du plugin de sécurité (environnement de développement uniquement) plugins.security.disabled: true .. important:: - Indiquez pour ``configsync.config_path`` un répertoire situé sous le répertoire de configuration d'OpenSearch (``/path/to/opensearch-3.8.0/config/`` dans cet exemple). + Indiquez pour ``configsync.config_path`` un répertoire situé sous le répertoire de configuration d'OpenSearch (``/path/to/opensearch-3.9.0/config/`` dans cet exemple). À partir d'OpenSearch 3.8.0, la création d'un index est refusée si les fichiers de dictionnaire se trouvent en dehors du répertoire de configuration. - Si vous indiquez un emplacement situé en dehors du répertoire de configuration, comme ``/path/to/opensearch-3.8.0/data/config/``, |Fess| ne peut pas créer ses index et ne démarre pas. + Si vous indiquez un emplacement situé en dehors du répertoire de configuration, comme ``/path/to/opensearch-3.9.0/data/config/``, |Fess| ne peut pas créer ses index et ne démarre pas. .. warning:: @@ -234,7 +238,7 @@ Installation avec la version ZIP Après modification :: SEARCH_ENGINE_HTTP_URL=${SEARCH_ENGINE_HTTP_URL:-http://localhost:9200} - FESS_DICTIONARY_PATH=/path/to/opensearch-3.8.0/config/dictionary/ + FESS_DICTIONARY_PATH=/path/to/opensearch-3.9.0/config/dictionary/ .. note:: @@ -275,8 +279,8 @@ La version RPM est utilisée sur les distributions Linux basées sur RPM telles :: - $ wget https://artifacts.opensearch.org/releases/bundle/opensearch/3.8.0/opensearch-3.8.0-linux-x64.rpm - $ sudo rpm -ivh opensearch-3.8.0-linux-x64.rpm + $ wget https://artifacts.opensearch.org/releases/bundle/opensearch/3.9.0/opensearch-3.9.0-linux-x64.rpm + $ sudo rpm -ivh opensearch-3.9.0-linux-x64.rpm Vous pouvez également ajouter un dépôt pour l'installation. Pour plus de détails, consultez `Installing OpenSearch `__. @@ -285,10 +289,10 @@ La version RPM est utilisée sur les distributions Linux basées sur RPM telles :: - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-fess:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-extension:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-minhash:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-configsync:3.8.0 + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-fess/3.9.0/opensearch-analysis-fess-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-extension/3.9.0/opensearch-analysis-extension-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-minhash/3.9.0/opensearch-minhash-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-configsync/3.9.0/opensearch-configsync-3.9.0.zip 3. Configuration d'OpenSearch @@ -385,8 +389,8 @@ La version DEB est utilisée sur les distributions Linux basées sur DEB telles :: - $ wget https://artifacts.opensearch.org/releases/bundle/opensearch/3.8.0/opensearch-3.8.0-linux-x64.deb - $ sudo dpkg -i opensearch-3.8.0-linux-x64.deb + $ wget https://artifacts.opensearch.org/releases/bundle/opensearch/3.9.0/opensearch-3.9.0-linux-x64.deb + $ sudo dpkg -i opensearch-3.9.0-linux-x64.deb Vous pouvez également ajouter un dépôt pour l'installation. Pour plus de détails, consultez `Installing OpenSearch `__. @@ -395,10 +399,10 @@ La version DEB est utilisée sur les distributions Linux basées sur DEB telles :: - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-fess:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-extension:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-minhash:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-configsync:3.8.0 + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-fess/3.9.0/opensearch-analysis-fess-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-extension/3.9.0/opensearch-analysis-extension-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-minhash/3.9.0/opensearch-minhash-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-configsync/3.9.0/opensearch-configsync-3.9.0.zip 3. Configuration d'OpenSearch @@ -495,7 +499,7 @@ Une fois l'installation terminée, veuillez vérifier les éléments suivants : Pour la version ZIP :: - $ ls -ld /path/to/opensearch-3.8.0/config/dictionary/ + $ ls -ld /path/to/opensearch-3.9.0/config/dictionary/ Pour les versions RPM/DEB :: @@ -533,7 +537,7 @@ Q : D'autres versions d'OpenSearch fonctionnent-elles ? ------------------------------------------------------------------ R : |Fess| dépend d'une version spécifique d'OpenSearch. -Pour garantir la compatibilité des plugins, il est fortement recommandé d'utiliser la version recommandée (3.8.0). +Pour garantir la compatibilité des plugins, il est fortement recommandé d'utiliser la version recommandée (3.9.0). Si vous utilisez une autre version, vous devrez également ajuster les versions des plugins de manière appropriée. Q : Peut-on partager le même OpenSearch avec plusieurs instances Fess ? diff --git a/fr/15.9/install/install-windows.rst b/fr/15.9/install/install-windows.rst index 247a3d322..062592e70 100644 --- a/fr/15.9/install/install-windows.rst +++ b/fr/15.9/install/install-windows.rst @@ -15,7 +15,7 @@ Prérequis - La configuration requise décrite dans :doc:`prerequisites` doit être satisfaite - Java 21 doit être installé -- OpenSearch 3.8.0 doit être disponible (ou nouvelle installation) +- OpenSearch 3.9.0 doit être disponible (ou nouvelle installation) - La variable d'environnement Windows ``JAVA_HOME`` doit être configurée de manière appropriée Vérification de l'installation de Java @@ -82,7 +82,7 @@ Configuration des variables d'environnement Suivez les étapes ci-dessous pour les dérouler une à une, ou lorsque vous utilisez un OpenSearch existant. Pour n'installer que les plugins dans un OpenSearch existant, utilisez - ``bin\fess-setup install opensearch-plugins --opensearch-home C:\opensearch-3.8.0``. + ``bin\fess-setup install opensearch-plugins --opensearch-home C:\opensearch-3.9.0``. Consultez :doc:`fess-setup` pour toutes les commandes. Téléchargement d'OpenSearch @@ -94,7 +94,7 @@ Téléchargement d'OpenSearch Exemple :: - C:\opensearch-3.8.0 + C:\opensearch-3.9.0 .. note:: @@ -107,16 +107,20 @@ Ouvrez l'invite de commandes **avec des privilèges d'administrateur** et exécu :: - C:\> cd C:\opensearch-3.8.0 - C:\opensearch-3.8.0> bin\opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-fess:3.8.0 - C:\opensearch-3.8.0> bin\opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-extension:3.8.0 - C:\opensearch-3.8.0> bin\opensearch-plugin install org.codelibs.opensearch:opensearch-minhash:3.8.0 - C:\opensearch-3.8.0> bin\opensearch-plugin install org.codelibs.opensearch:opensearch-configsync:3.8.0 + C:\> cd C:\opensearch-3.9.0 + C:\opensearch-3.9.0> bin\opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-fess/3.9.0/opensearch-analysis-fess-3.9.0.zip + C:\opensearch-3.9.0> bin\opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-extension/3.9.0/opensearch-analysis-extension-3.9.0.zip + C:\opensearch-3.9.0> bin\opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-minhash/3.9.0/opensearch-minhash-3.9.0.zip + C:\opensearch-3.9.0> bin\opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-configsync/3.9.0/opensearch-configsync-3.9.0.zip .. important:: Les versions des plugins doivent correspondre à la version d'OpenSearch. - Dans l'exemple ci-dessus, toutes sont spécifiées en 3.8.0. + Dans l'exemple ci-dessus, toutes sont spécifiées en 3.9.0. + + Les quatre plugins de |Fess| sont publiés sur maven.codelibs.org ; ils s'installent donc par leur + URL. La forme ``groupId:artifactId:version`` de ``opensearch-plugin install`` ne cherche que dans + Maven Central. Configuration d'OpenSearch --------------------------- @@ -126,7 +130,7 @@ Ouvrez ``config\opensearch.yml`` avec un éditeur de texte et ajoutez les param :: # Chemin pour la synchronisation de configuration (spécifier en chemin absolu) - configsync.config_path: C:/opensearch-3.8.0/config/dictionary/ + configsync.config_path: C:/opensearch-3.9.0/config/dictionary/ # Désactivation du plugin de sécurité (environnement de développement uniquement) plugins.security.disabled: true @@ -142,13 +146,13 @@ Ouvrez ``config\opensearch.yml`` avec un éditeur de texte et ajoutez les param .. note:: Sous Windows, utilisez ``/`` plutôt que ``\`` comme séparateur de chemin. - Écrivez ``C:/opensearch-3.8.0/config/dictionary/`` plutôt que ``C:\opensearch-3.8.0\config\dictionary\``. + Écrivez ``C:/opensearch-3.9.0/config/dictionary/`` plutôt que ``C:\opensearch-3.9.0\config\dictionary\``. .. important:: - Indiquez pour ``configsync.config_path`` un répertoire situé sous le répertoire de configuration d'OpenSearch (``C:/opensearch-3.8.0/config/`` dans cet exemple). + Indiquez pour ``configsync.config_path`` un répertoire situé sous le répertoire de configuration d'OpenSearch (``C:/opensearch-3.9.0/config/`` dans cet exemple). À partir d'OpenSearch 3.8.0, la création d'un index est refusée si les fichiers de dictionnaire se trouvent en dehors du répertoire de configuration. - Si vous indiquez un emplacement situé en dehors du répertoire de configuration, comme ``C:/opensearch-3.8.0/data/config/``, |Fess| ne peut pas créer ses index et ne démarre pas. + Si vous indiquez un emplacement situé en dehors du répertoire de configuration, comme ``C:/opensearch-3.9.0/data/config/``, |Fess| ne peut pas créer ses index et ne démarre pas. .. tip:: @@ -206,7 +210,7 @@ Après modification :: REM External opensearch cluster set FESS_JAVA_OPTS=%FESS_JAVA_OPTS% -Dfess.search_engine.http_address=http://localhost:9200 - set FESS_JAVA_OPTS=%FESS_JAVA_OPTS% -Dfess.dictionary.path=C:/opensearch-3.8.0/config/dictionary/ + set FESS_JAVA_OPTS=%FESS_JAVA_OPTS% -Dfess.dictionary.path=C:/opensearch-3.9.0/config/dictionary/ .. note:: @@ -317,7 +321,7 @@ Sous Windows, il existe une limitation de la longueur des chemins. Nous recomman Exemple :: C:\opensearch (recommandé) - C:\Program Files\opensearch-3.8.0 (non recommandé - chemin trop long) + C:\Program Files\opensearch-3.9.0 (non recommandé - chemin trop long) Java n'est pas reconnu ----------------------- diff --git a/fr/15.9/install/install.rst b/fr/15.9/install/install.rst index 47103fdc4..6e08dfcd4 100644 --- a/fr/15.9/install/install.rst +++ b/fr/15.9/install/install.rst @@ -126,7 +126,7 @@ Pour toutes les méthodes d'installation, le flux de base est le même. Pour les versions autres que Docker, vous devez configurer OpenSearch séparément. - - Installation d'OpenSearch 3.8.0 + - Installation d'OpenSearch 3.9.0 - Installation des plugins requis - Modification des fichiers de configuration @@ -157,7 +157,7 @@ OpenSearch OpenSearch est utilisé comme moteur de recherche. -- **Version compatible** : OpenSearch 3.8.0 +- **Version compatible** : OpenSearch 3.9.0 - **Plugins requis** : - opensearch-analysis-fess @@ -235,7 +235,7 @@ Informations de version Cette documentation concerne les versions suivantes : - **Fess** : 15.9.0 -- **OpenSearch** : 3.8.0 +- **OpenSearch** : 3.9.0 - **Java** : 21 ou ultérieur - **Docker** : 20.10 ou ultérieur - **Docker Compose** : 2.0 ou ultérieur diff --git a/fr/15.9/install/prerequisites.rst b/fr/15.9/install/prerequisites.rst index 7a7ee7413..3a1713e0d 100644 --- a/fr/15.9/install/prerequisites.rst +++ b/fr/15.9/install/prerequisites.rst @@ -74,9 +74,9 @@ Version ZIP/RPM/DEB - OpenJDK 21 ou ultérieur - Eclipse Temurin 21 ou ultérieur -- **OpenSearch 3.8.0** : Obligatoire. |Fess| ne démarre pas avec un moteur antérieur à OpenSearch 3 +- **OpenSearch 3.9.0** : Obligatoire. |Fess| ne démarre pas avec un moteur antérieur à OpenSearch 3 - - Version compatible : OpenSearch 3.8.0 + - Version compatible : OpenSearch 3.9.0 - Attention à la compatibilité des plugins avec les autres versions Version Docker diff --git a/fr/15.9/install/run.rst b/fr/15.9/install/run.rst index 817337102..31c2b42d6 100644 --- a/fr/15.9/install/run.rst +++ b/fr/15.9/install/run.rst @@ -22,7 +22,7 @@ Démarrage d'OpenSearch :: - $ cd /path/to/opensearch-3.8.0 + $ cd /path/to/opensearch-3.9.0 $ ./bin/opensearch Pour un démarrage en arrière-plan :: @@ -31,7 +31,7 @@ Pour un démarrage en arrière-plan :: .. note:: - ``bin/fess-setup install opensearch`` place OpenSearch dans ``opensearch/opensearch-3.8.0`` du + ``bin/fess-setup install opensearch`` place OpenSearch dans ``opensearch/opensearch-3.9.0`` du répertoire de |Fess|. .. important:: @@ -42,7 +42,7 @@ Pour un démarrage en arrière-plan :: avec un utilisateur ordinaire échoue alors avec ``AccessDeniedException``. Rendez le répertoire d'OpenSearch à cet utilisateur avant de le démarrer à nouveau, par exemple :: - $ sudo chown -R /path/to/opensearch-3.8.0 + $ sudo chown -R /path/to/opensearch-3.9.0 Démarrage de Fess ~~~~~~~~~~~~~~~~~ @@ -72,8 +72,8 @@ Démarrage d'OpenSearch Ou depuis l'invite de commandes :: - C:\> cd C:\opensearch-3.8.0 - C:\opensearch-3.8.0> bin\opensearch.bat + C:\> cd C:\opensearch-3.9.0 + C:\opensearch-3.9.0> bin\opensearch.bat Démarrage de Fess ~~~~~~~~~~~~~~~~~ diff --git a/fr/15.9/install/troubleshooting.rst b/fr/15.9/install/troubleshooting.rst index a30478775..a0024c150 100644 --- a/fr/15.9/install/troubleshooting.rst +++ b/fr/15.9/install/troubleshooting.rst @@ -70,7 +70,7 @@ Java n'est pas installé, ou la variable d'environnement PATH n'est pas correcte 2. Adaptez la version du plugin à celle d'OpenSearch :: - $ /path/to/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-fess:3.6.0 + $ /path/to/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-fess/3.9.0/opensearch-analysis-fess-3.9.0.zip 3. Vérifiez les permissions :: @@ -197,7 +197,7 @@ L'accès à |Fess| renvoie une erreur HTTP 404 et l'erreur suivante est enregist 1. Modifiez ``configsync.config_path`` et ``FESS_DICTIONARY_PATH`` pour qu'ils pointent vers un répertoire situé sous le répertoire de configuration d'OpenSearch. - Version RPM/DEB : ``/etc/opensearch/dictionary/`` - - Version ZIP : ``/path/to/opensearch-3.8.0/config/dictionary/`` + - Version ZIP : ``/path/to/opensearch-3.9.0/config/dictionary/`` 2. Si des fichiers de dictionnaire existent déjà, copiez-les dans le nouveau répertoire. 3. Redémarrez OpenSearch, puis |Fess|. diff --git a/fr/15.9/install/uninstall.rst b/fr/15.9/install/uninstall.rst index 814b38e9e..817ad0243 100644 --- a/fr/15.9/install/uninstall.rst +++ b/fr/15.9/install/uninstall.rst @@ -77,13 +77,13 @@ Supprimez le répertoire d'installation :: Supprimez le répertoire d'installation d'OpenSearch :: - $ rm -rf /path/to/opensearch-3.8.0 + $ rm -rf /path/to/opensearch-3.9.0 Étape 3 : Suppression du répertoire de données (optionnel) ---------------------------------------------------------- Les données d'index de |Fess| sont stockées dans OpenSearch. -Par défaut, elles sont stockées dans le répertoire d'installation d'OpenSearch (``opensearch-3.8.0/data``, etc.), +Par défaut, elles sont stockées dans le répertoire d'installation d'OpenSearch (``opensearch-3.9.0/data``, etc.), mais si vous avez spécifié un autre emplacement avec ``path.data``, supprimez également ce répertoire :: $ rm -rf /path/to/data @@ -94,7 +94,7 @@ mais si vous avez spécifié un autre emplacement avec ``path.data``, supprimez Supprimez les fichiers journaux :: $ rm -rf /path/to/fess-15.9.0/logs - $ rm -rf /path/to/opensearch-3.8.0/logs + $ rm -rf /path/to/opensearch-3.9.0/logs Désinstallation de la version RPM ================================= @@ -311,7 +311,7 @@ Pour supprimer les images Docker et libérer de l'espace disque :: $ docker images | grep fess $ docker rmi ghcr.io/codelibs/fess:15.9.0 - $ docker rmi ghcr.io/codelibs/fess-opensearch:3.8.0 + $ docker rmi ghcr.io/codelibs/fess-opensearch:3.9.0 Étape 4 : Suppression des fichiers Compose ------------------------------------------ diff --git a/fr/15.9/install/upgrade.rst b/fr/15.9/install/upgrade.rst index 772be8cfb..35405ec5a 100644 --- a/fr/15.9/install/upgrade.rst +++ b/fr/15.9/install/upgrade.rst @@ -24,7 +24,7 @@ Cette procédure de mise à niveau est compatible avec les mises à niveau entre .. important:: |Fess| 14.x est compatible avec la série OpenSearch 2.x, tandis que |Fess| 15.9 est compatible - avec OpenSearch 3.8.0. Les plugins OpenSearch pour |Fess| doivent correspondre exactement à la + avec OpenSearch 3.9.0. Les plugins OpenSearch pour |Fess| doivent correspondre exactement à la version d'OpenSearch ; une mise à niveau depuis la 14.x implique donc obligatoirement une mise à niveau majeure d'OpenSearch également. Voir :ref:`upgrade-opensearch`. @@ -360,7 +360,7 @@ Version Docker Étape 4 : Mise à niveau d'OpenSearch ==================================== -|Fess| 15.9 est compatible avec OpenSearch 3.8.0. Si l'OpenSearch auquel vous vous connectez est +|Fess| 15.9 est compatible avec OpenSearch 3.9.0. Si l'OpenSearch auquel vous vous connectez est antérieur à cette version, effectuez la mise à niveau en suivant la procédure ci-dessous. .. note:: @@ -393,21 +393,29 @@ antérieur à cette version, effectuez la mise à niveau en suivant la procédur |Fess| 14.x utilise la série OpenSearch 2.x ; une mise à niveau depuis la 14.x correspond donc toujours à ce cas de figure. + Un snapshot pris avec OpenSearch 3.9.0 ne peut pas être restauré dans OpenSearch 3.8.0 ou + antérieur. Conservez le snapshot pris avant la mise à niveau au cas où vous devriez revenir en + arrière. + 1. Installez la nouvelle version d'OpenSearch 2. Réinstallez les plugins :: - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-fess:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-extension:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-minhash:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-configsync:3.8.0 + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-fess/3.9.0/opensearch-analysis-fess-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-extension/3.9.0/opensearch-analysis-extension-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-minhash/3.9.0/opensearch-minhash-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-configsync/3.9.0/opensearch-configsync-3.9.0.zip .. note:: La version de ces plugins doit correspondre à la version d'OpenSearch utilisée. - |Fess| 15.9 est compatible avec OpenSearch 3.8.0. Si les versions ne correspondent pas, + |Fess| 15.9 est compatible avec OpenSearch 3.9.0. Si les versions ne correspondent pas, l'installation du plugin échouera. + Les quatre plugins de |Fess| sont publiés sur maven.codelibs.org ; ils s'installent donc par + leur URL. La forme ``groupId:artifactId:version`` de ``opensearch-plugin install`` ne cherche + que dans Maven Central. + 3. Déplacez le répertoire des dictionnaires sous le répertoire de configuration d'OpenSearch À partir d'OpenSearch 3.8.0, la création d'un index est refusée si les fichiers de dictionnaire se trouvent en dehors du répertoire de configuration d'OpenSearch. @@ -504,6 +512,9 @@ En cas de mise à niveau majeure, il est recommandé de recréer l'index. « Maintenance » dans l'interface d'administration. Voir :ref:`semantic-search-migration` (:doc:`../config/search-semantic`) pour plus de détails. + Si vous conservez un index de documents créé avec la 15.8 ou antérieure, consultez aussi + :ref:`upgrade-reindex-new-fields`. + 1. Vérifiez la planification d'exploration existante 2. Exécutez « Default Crawler » depuis « Système » → « Planificateur » 3. Attendez la fin de l'exploration @@ -1010,6 +1021,45 @@ anonymes de rechercher, définissez ``login.required=true``. Les jetons d'accès avant : une requête munie d'un jeton d'accès enregistré reçoit les permissions de ce jeton, et une requête munie d'un jeton non enregistré ou expiré est refusée. +.. _upgrade-reindex-new-fields: + +Appliquer les nouveaux champs et la normalisation des kana à un index de documents existant +------------------------------------------------------------------------------------------- + +Au démarrage, la 15.9 ajoute de nouveaux champs aux index de configuration, de journaux et +d'utilisateurs, mais ne modifie ni le mapping ni les paramètres d'analyse de l'index de documents. +Si vous conservez un index de documents créé avec la 15.8 ou antérieure, les changements suivants de +la 15.9 ne prennent pas effet. + +- **Propriétaire et dernier modificateur d'un fichier** (``owner``, ``last_modifier``) : nouveaux + champs indexés par les crawls du système de fichiers, SMB et FTP. L'index de documents existant ne + les définit pas ; la première valeur crawlée les mappe donc dynamiquement en ``text``, et les + recherches comme ``owner:alice`` ou ``facet.field=owner`` ne fonctionnent pas comme prévu. +- **Normalisation des variantes de kana et des tirets écrits à la place de la marque de voyelle + longue** (par exemple, ``サ―バ－`` est traité comme le même mot que ``サーバー``) : les règles se + trouvent dans les paramètres d'analyse de l'index de documents et dans le dictionnaire + ``mapping.txt`` ; un index existant ne les reçoit donc pas. + +Pour appliquer les deux, activez « Remplacer les alias » et « Réinitialiser les dictionnaires » sous +« Informations système » → « Maintenance » dans l'interface d'administration, puis lancez la +« Réindexation ». La réindexation copie les documents existants dans un nouvel index ; il n'est pas +nécessaire de recrawler. + +.. warning:: + + « Réinitialiser les dictionnaires » écrase les dictionnaires côté OpenSearch avec les fichiers de + dictionnaire fournis. Si vous avez modifié des synonymes ou d'autres dictionnaires sous + « Dictionnaire » dans l'interface d'administration, téléchargez-les d'abord et réappliquez-les + après la réindexation. + +.. note:: + + Les fichiers indexés avec la 15.8 ou antérieure n'ont pas de valeur de propriétaire ni de dernier + modificateur. Le crawl incrémental ne récupère pas à nouveau les fichiers inchangés ; pour ajouter + les valeurs, désactivez temporairement « Vérifier la dernière modification » sous « Système » → + « Général » et lancez un crawl. + + Migrations spécifiques à la 15.9 ================================ @@ -1352,9 +1402,9 @@ Q : Est-il nécessaire de mettre à niveau OpenSearch également ? ---------------------------------------------------------------- R : La version d'OpenSearch compatible est déterminée pour chaque version de |Fess|. -|Fess| 15.9 est compatible avec OpenSearch 3.8.0. +|Fess| 15.9 est compatible avec OpenSearch 3.9.0. Les plugins OpenSearch pour |Fess| tels que ``opensearch-analysis-fess`` doivent correspondre exactement à la version d'OpenSearch ; -si vous mettez à niveau OpenSearch, mettez également à jour les plugins vers la version correspondante (3.8.0). +si vous mettez à niveau OpenSearch, mettez également à jour les plugins vers la version correspondante (3.9.0). Notez par ailleurs que |Fess| 15.9 rend le plugin k-NN obligatoire et envoie toujours ``knn.derived_source.enabled`` dans les réglages de l'index. Avec un OpenSearch ancien, la @@ -1376,6 +1426,8 @@ Une recréation et une réindexation sont nécessaires dans les cas suivants : :ref:`semantic-search-migration` (:doc:`../config/search-semantic`) pour plus de détails. - **Mise à niveau depuis la 14.x** : OpenSearch passant de la série 2.x à la série 3.x (mise à niveau majeure), la recréation de l'index est recommandée. +- **Recherche par propriétaire ou normalisation des kana avec un index de documents créé avec la 15.8 + ou antérieure** : une réindexation est nécessaire. Voir :ref:`upgrade-reindex-new-fields`. .. warning:: diff --git a/ja/15.9/install/install-linux.rst b/ja/15.9/install/install-linux.rst index 5c01c46de..9d5fbb958 100644 --- a/ja/15.9/install/install-linux.rst +++ b/ja/15.9/install/install-linux.rst @@ -15,7 +15,7 @@ ZIP、RPM、DEB の各パッケージ形式に対応しています。 - :doc:`prerequisites` に記載されているシステム要件を満たしていること - Java 21 がインストールされていること -- OpenSearch 3.8.0 を利用可能な状態にすること（または新規インストール） +- OpenSearch 3.9.0 を利用可能な状態にすること（または新規インストール） インストール方法の選択 ====================== @@ -114,14 +114,14 @@ ZIP 版でのインストール :: - $ wget https://artifacts.opensearch.org/releases/bundle/opensearch/3.8.0/opensearch-3.8.0-linux-x64.tar.gz - $ tar -xzf opensearch-3.8.0-linux-x64.tar.gz - $ cd opensearch-3.8.0 + $ wget https://artifacts.opensearch.org/releases/bundle/opensearch/3.9.0/opensearch-3.9.0-linux-x64.tar.gz + $ tar -xzf opensearch-3.9.0-linux-x64.tar.gz + $ cd opensearch-3.9.0 .. note:: - この例では OpenSearch 3.8.0 を使用しています。 - |Fess| 15.9 は OpenSearch 3.8.0 に対応しています。 + この例では OpenSearch 3.9.0 を使用しています。 + |Fess| 15.9 は OpenSearch 3.9.0 に対応しています。 2. OpenSearch プラグインのインストール @@ -129,16 +129,18 @@ ZIP 版でのインストール :: - $ cd /path/to/opensearch-3.8.0 - $ ./bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-fess:3.8.0 - $ ./bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-extension:3.8.0 - $ ./bin/opensearch-plugin install org.codelibs.opensearch:opensearch-minhash:3.8.0 - $ ./bin/opensearch-plugin install org.codelibs.opensearch:opensearch-configsync:3.8.0 + $ cd /path/to/opensearch-3.9.0 + $ ./bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-fess/3.9.0/opensearch-analysis-fess-3.9.0.zip + $ ./bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-extension/3.9.0/opensearch-analysis-extension-3.9.0.zip + $ ./bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-minhash/3.9.0/opensearch-minhash-3.9.0.zip + $ ./bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-configsync/3.9.0/opensearch-configsync-3.9.0.zip .. important:: プラグインのバージョンは OpenSearch のバージョンと一致させる必要があります。 - 上記の例では、すべて 3.8.0 を指定しています。 + 上記の例では、すべて 3.9.0 を指定しています。 + + |Fess| 用の 4 つのプラグインは maven.codelibs.org で公開しているため、URL で指定します。 ``opensearch-plugin install`` の ``groupId:artifactId:version`` 形式は Maven Central だけを参照します。 3. OpenSearch の設定 @@ -147,16 +149,16 @@ ZIP 版でのインストール :: # 設定同期用のパス（絶対パスで指定） - configsync.config_path: /path/to/opensearch-3.8.0/config/dictionary/ + configsync.config_path: /path/to/opensearch-3.9.0/config/dictionary/ # セキュリティプラグインの無効化（開発環境のみ） plugins.security.disabled: true .. important:: - ``configsync.config_path`` には、OpenSearch の設定ディレクトリ（この例では ``/path/to/opensearch-3.8.0/config/``）の下のディレクトリを指定してください。 + ``configsync.config_path`` には、OpenSearch の設定ディレクトリ（この例では ``/path/to/opensearch-3.9.0/config/``）の下のディレクトリを指定してください。 OpenSearch 3.8.0 以降は、辞書ファイルが設定ディレクトリの外にあるとインデックスの作成を拒否します。 - ``/path/to/opensearch-3.8.0/data/config/`` など設定ディレクトリの外を指定すると、 |Fess| はインデックスを作成できず、起動しません。 + ``/path/to/opensearch-3.9.0/data/config/`` など設定ディレクトリの外を指定すると、 |Fess| はインデックスを作成できず、起動しません。 .. warning:: @@ -219,7 +221,7 @@ ZIP 版でのインストール 変更後:: SEARCH_ENGINE_HTTP_URL=${SEARCH_ENGINE_HTTP_URL:-http://localhost:9200} - FESS_DICTIONARY_PATH=/path/to/opensearch-3.8.0/config/dictionary/ + FESS_DICTIONARY_PATH=/path/to/opensearch-3.9.0/config/dictionary/ .. note:: @@ -260,8 +262,8 @@ RPM 版は、Red Hat Enterprise Linux、CentOS、Fedora などの RPM ベース :: - $ wget https://artifacts.opensearch.org/releases/bundle/opensearch/3.8.0/opensearch-3.8.0-linux-x64.rpm - $ sudo rpm -ivh opensearch-3.8.0-linux-x64.rpm + $ wget https://artifacts.opensearch.org/releases/bundle/opensearch/3.9.0/opensearch-3.9.0-linux-x64.rpm + $ sudo rpm -ivh opensearch-3.9.0-linux-x64.rpm または、リポジトリを追加してインストールすることもできます。 詳細は `Installing OpenSearch `__ を参照してください。 @@ -270,10 +272,10 @@ RPM 版は、Red Hat Enterprise Linux、CentOS、Fedora などの RPM ベース :: - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-fess:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-extension:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-minhash:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-configsync:3.8.0 + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-fess/3.9.0/opensearch-analysis-fess-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-extension/3.9.0/opensearch-analysis-extension-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-minhash/3.9.0/opensearch-minhash-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-configsync/3.9.0/opensearch-configsync-3.9.0.zip 3. OpenSearch の設定 @@ -370,8 +372,8 @@ DEB 版は、Debian、Ubuntu などの DEB ベースの Linux ディストリビ :: - $ wget https://artifacts.opensearch.org/releases/bundle/opensearch/3.8.0/opensearch-3.8.0-linux-x64.deb - $ sudo dpkg -i opensearch-3.8.0-linux-x64.deb + $ wget https://artifacts.opensearch.org/releases/bundle/opensearch/3.9.0/opensearch-3.9.0-linux-x64.deb + $ sudo dpkg -i opensearch-3.9.0-linux-x64.deb または、リポジトリを追加してインストールすることもできます。 詳細は `Installing OpenSearch `__ を参照してください。 @@ -380,10 +382,10 @@ DEB 版は、Debian、Ubuntu などの DEB ベースの Linux ディストリビ :: - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-fess:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-extension:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-minhash:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-configsync:3.8.0 + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-fess/3.9.0/opensearch-analysis-fess-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-extension/3.9.0/opensearch-analysis-extension-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-minhash/3.9.0/opensearch-minhash-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-configsync/3.9.0/opensearch-configsync-3.9.0.zip 3. OpenSearch の設定 @@ -480,7 +482,7 @@ DEB 版は、Debian、Ubuntu などの DEB ベースの Linux ディストリビ ZIP 版の場合:: - $ ls -ld /path/to/opensearch-3.8.0/config/dictionary/ + $ ls -ld /path/to/opensearch-3.9.0/config/dictionary/ RPM/DEB 版の場合:: @@ -518,7 +520,7 @@ Q: OpenSearch のバージョンは他のバージョンでも動作しますか ------------------------------------------------------------------ A: |Fess| は特定のバージョンの OpenSearch に依存しています。 -プラグインの互換性を確保するため、推奨されるバージョン（3.8.0）を使用することを強く推奨します。 +プラグインの互換性を確保するため、推奨されるバージョン（3.9.0）を使用することを強く推奨します。 他のバージョンを使用する場合は、プラグインのバージョンも適切に調整する必要があります。 Q: 複数の Fess インスタンスで同じ OpenSearch を共有できますか？ diff --git a/ja/15.9/install/install-windows.rst b/ja/15.9/install/install-windows.rst index 0dac1fa41..ccd17d8df 100644 --- a/ja/15.9/install/install-windows.rst +++ b/ja/15.9/install/install-windows.rst @@ -15,7 +15,7 @@ ZIP パッケージを使用したインストール方法について記載し - :doc:`prerequisites` に記載されているシステム要件を満たしていること - Java 21 がインストールされていること -- OpenSearch 3.8.0 を利用可能な状態にすること（または新規インストール） +- OpenSearch 3.9.0 を利用可能な状態にすること（または新規インストール） - Windows の環境変数 ``JAVA_HOME`` が適切に設定されていること Java のインストール確認 @@ -73,7 +73,7 @@ Java 21 以降が表示されることを確認してください。 手順を個別に確認したい場合や、既存の OpenSearch を使う場合は、以下に従ってください。 既存の OpenSearch にプラグインだけを入れる場合は - ``bin\fess-setup install opensearch-plugins --opensearch-home C:\opensearch-3.8.0`` を使用します。 + ``bin\fess-setup install opensearch-plugins --opensearch-home C:\opensearch-3.9.0`` を使用します。 すべてのコマンドについては :doc:`fess-setup` を参照してください。 OpenSearch のダウンロード @@ -85,7 +85,7 @@ OpenSearch のダウンロード 例:: - C:\opensearch-3.8.0 + C:\opensearch-3.9.0 .. note:: @@ -98,16 +98,18 @@ OpenSearch プラグインのインストール :: - C:\> cd C:\opensearch-3.8.0 - C:\opensearch-3.8.0> bin\opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-fess:3.8.0 - C:\opensearch-3.8.0> bin\opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-extension:3.8.0 - C:\opensearch-3.8.0> bin\opensearch-plugin install org.codelibs.opensearch:opensearch-minhash:3.8.0 - C:\opensearch-3.8.0> bin\opensearch-plugin install org.codelibs.opensearch:opensearch-configsync:3.8.0 + C:\> cd C:\opensearch-3.9.0 + C:\opensearch-3.9.0> bin\opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-fess/3.9.0/opensearch-analysis-fess-3.9.0.zip + C:\opensearch-3.9.0> bin\opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-extension/3.9.0/opensearch-analysis-extension-3.9.0.zip + C:\opensearch-3.9.0> bin\opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-minhash/3.9.0/opensearch-minhash-3.9.0.zip + C:\opensearch-3.9.0> bin\opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-configsync/3.9.0/opensearch-configsync-3.9.0.zip .. important:: プラグインのバージョンは OpenSearch のバージョンと一致させる必要があります。 - 上記の例では、すべて 3.8.0 を指定しています。 + 上記の例では、すべて 3.9.0 を指定しています。 + + |Fess| 用の 4 つのプラグインは maven.codelibs.org で公開しているため、URL で指定します。 ``opensearch-plugin install`` の ``groupId:artifactId:version`` 形式は Maven Central だけを参照します。 OpenSearch の設定 --------------- @@ -117,7 +119,7 @@ OpenSearch の設定 :: # 設定同期用のパス（絶対パスで指定） - configsync.config_path: C:/opensearch-3.8.0/config/dictionary/ + configsync.config_path: C:/opensearch-3.9.0/config/dictionary/ # セキュリティプラグインの無効化（開発環境のみ） plugins.security.disabled: true @@ -133,13 +135,13 @@ OpenSearch の設定 .. note:: Windows の場合、パスの区切り文字は ``\`` ではなく ``/`` を使用してください。 - ``C:\opensearch-3.8.0\config\dictionary\`` ではなく ``C:/opensearch-3.8.0/config/dictionary/`` と記述します。 + ``C:\opensearch-3.9.0\config\dictionary\`` ではなく ``C:/opensearch-3.9.0/config/dictionary/`` と記述します。 .. important:: - ``configsync.config_path`` には、OpenSearch の設定ディレクトリ（この例では ``C:/opensearch-3.8.0/config/``）の下のディレクトリを指定してください。 + ``configsync.config_path`` には、OpenSearch の設定ディレクトリ（この例では ``C:/opensearch-3.9.0/config/``）の下のディレクトリを指定してください。 OpenSearch 3.8.0 以降は、辞書ファイルが設定ディレクトリの外にあるとインデックスの作成を拒否します。 - ``C:/opensearch-3.8.0/data/config/`` など設定ディレクトリの外を指定すると、 |Fess| はインデックスを作成できず、起動しません。 + ``C:/opensearch-3.9.0/data/config/`` など設定ディレクトリの外を指定すると、 |Fess| はインデックスを作成できず、起動しません。 .. tip:: @@ -193,7 +195,7 @@ Fess の設定 REM External opensearch cluster set FESS_JAVA_OPTS=%FESS_JAVA_OPTS% -Dfess.search_engine.http_address=http://localhost:9200 - set FESS_JAVA_OPTS=%FESS_JAVA_OPTS% -Dfess.dictionary.path=C:/opensearch-3.8.0/config/dictionary/ + set FESS_JAVA_OPTS=%FESS_JAVA_OPTS% -Dfess.dictionary.path=C:/opensearch-3.9.0/config/dictionary/ .. note:: @@ -304,7 +306,7 @@ Windows では、パスの長さに制限があります。可能な限り短い 例:: C:\opensearch (推奨) - C:\Program Files\opensearch-3.8.0 (非推奨 - パスが長い) + C:\Program Files\opensearch-3.9.0 (非推奨 - パスが長い) Java が認識されない ----------------- diff --git a/ja/15.9/install/install.rst b/ja/15.9/install/install.rst index 87d72b3f0..b7ba8fe55 100644 --- a/ja/15.9/install/install.rst +++ b/ja/15.9/install/install.rst @@ -126,7 +126,7 @@ Windows 版 (ZIP) Docker 版以外の場合、OpenSearch を個別にセットアップする必要があります。 - - OpenSearch 3.8.0 のインストール + - OpenSearch 3.9.0 のインストール - 必須プラグインのインストール - 設定ファイルの編集 @@ -157,7 +157,7 @@ OpenSearch 検索エンジンとして OpenSearch を使用します。 -- **対応バージョン**: OpenSearch 3.8.0 +- **対応バージョン**: OpenSearch 3.9.0 - **必須プラグイン**: - opensearch-analysis-fess @@ -235,7 +235,7 @@ A: はい、可能です。Fess と OpenSearch を別々のサーバーで実行 このドキュメントは、以下のバージョンを対象としています： - **Fess**: 15.9.0 -- **OpenSearch**: 3.8.0 +- **OpenSearch**: 3.9.0 - **Java**: 21 以降 - **Docker**: 20.10 以降 - **Docker Compose**: 2.0 以降 diff --git a/ja/15.9/install/prerequisites.rst b/ja/15.9/install/prerequisites.rst index 8a005d42c..ebd1a9252 100644 --- a/ja/15.9/install/prerequisites.rst +++ b/ja/15.9/install/prerequisites.rst @@ -74,9 +74,9 @@ ZIP/RPM/DEB 版 - OpenJDK 21 以降 - Eclipse Temurin 21 以降 -- **OpenSearch 3.8.0**: 必須。OpenSearch 3 より前のバージョンでは |Fess| は起動しません +- **OpenSearch 3.9.0**: 必須。OpenSearch 3 より前のバージョンでは |Fess| は起動しません - - 対応バージョン: OpenSearch 3.8.0 + - 対応バージョン: OpenSearch 3.9.0 - その他のバージョンではプラグインの互換性に注意が必要 Docker 版 diff --git a/ja/15.9/install/run.rst b/ja/15.9/install/run.rst index da02ef321..be63d45e0 100644 --- a/ja/15.9/install/run.rst +++ b/ja/15.9/install/run.rst @@ -22,7 +22,7 @@ OpenSearch の起動 :: - $ cd /path/to/opensearch-3.8.0 + $ cd /path/to/opensearch-3.9.0 $ ./bin/opensearch バックグラウンドで起動する場合:: @@ -31,13 +31,13 @@ OpenSearch の起動 .. note:: - ``bin/fess-setup install opensearch`` で導入した OpenSearch は、 |Fess| のディレクトリの ``opensearch/opensearch-3.8.0`` にあります。 + ``bin/fess-setup install opensearch`` で導入した OpenSearch は、 |Fess| のディレクトリの ``opensearch/opensearch-3.9.0`` にあります。 .. important:: OpenSearch は一般ユーザーで起動してください。 ``root`` で起動すると ``can not run opensearch as root`` と表示して終了します。拒否された起動でも ``config/opensearch.keystore`` などのファイルが ``root`` の所有で残り、次に一般ユーザーで起動すると ``AccessDeniedException`` で失敗します。再度起動する前に、OpenSearch のディレクトリの所有者をそのユーザーに戻してください。例:: - $ sudo chown -R /path/to/opensearch-3.8.0 + $ sudo chown -R /path/to/opensearch-3.9.0 Fess の起動 ~~~~~~~~~~ @@ -67,8 +67,8 @@ OpenSearch の起動 または、コマンドプロンプトから:: - C:\> cd C:\opensearch-3.8.0 - C:\opensearch-3.8.0> bin\opensearch.bat + C:\> cd C:\opensearch-3.9.0 + C:\opensearch-3.9.0> bin\opensearch.bat Fess の起動 ~~~~~~~~~~ diff --git a/ja/15.9/install/troubleshooting.rst b/ja/15.9/install/troubleshooting.rst index c0ad33c10..9eea726b6 100644 --- a/ja/15.9/install/troubleshooting.rst +++ b/ja/15.9/install/troubleshooting.rst @@ -70,7 +70,7 @@ Java がインストールされていない、またはPATH環境変数が正 2. プラグインのバージョンを OpenSearch のバージョンに合わせる:: - $ /path/to/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-fess:3.6.0 + $ /path/to/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-fess/3.9.0/opensearch-analysis-fess-3.9.0.zip 3. 権限を確認:: @@ -194,7 +194,7 @@ OpenSearch 3.8.0 以降は、辞書ファイルが OpenSearch の設定ディレ 1. ``configsync.config_path`` と ``FESS_DICTIONARY_PATH`` を、OpenSearch の設定ディレクトリの下のディレクトリに変更します。 - RPM/DEB 版: ``/etc/opensearch/dictionary/`` - - ZIP 版: ``/path/to/opensearch-3.8.0/config/dictionary/`` + - ZIP 版: ``/path/to/opensearch-3.9.0/config/dictionary/`` 2. 既存の辞書ファイルがある場合は、新しいディレクトリへコピーします。 3. OpenSearch、 |Fess| の順に再起動します。 diff --git a/ja/15.9/install/uninstall.rst b/ja/15.9/install/uninstall.rst index 59cafc302..9aa7d6aa2 100644 --- a/ja/15.9/install/uninstall.rst +++ b/ja/15.9/install/uninstall.rst @@ -77,13 +77,13 @@ ZIP 版のアンインストール OpenSearch のインストールディレクトリを削除します:: - $ rm -rf /path/to/opensearch-3.8.0 + $ rm -rf /path/to/opensearch-3.9.0 ステップ 3: データディレクトリの削除（オプション） ------------------------------------------- |Fess| のインデックスデータは OpenSearch に保存されます。 -デフォルトでは OpenSearch のインストールディレクトリ内（``opensearch-3.8.0/data`` など）に保存されますが、 +デフォルトでは OpenSearch のインストールディレクトリ内（``opensearch-3.9.0/data`` など）に保存されますが、 ``path.data`` で別の場所を指定している場合は、そのディレクトリも削除してください:: $ rm -rf /path/to/data @@ -94,7 +94,7 @@ OpenSearch のインストールディレクトリを削除します:: ログファイルを削除します:: $ rm -rf /path/to/fess-15.9.0/logs - $ rm -rf /path/to/opensearch-3.8.0/logs + $ rm -rf /path/to/opensearch-3.9.0/logs RPM 版のアンインストール ====================== @@ -310,7 +310,7 @@ Docker イメージを削除してディスクスペースを解放する場合: $ docker images | grep fess $ docker rmi ghcr.io/codelibs/fess:15.9.0 - $ docker rmi ghcr.io/codelibs/fess-opensearch:3.8.0 + $ docker rmi ghcr.io/codelibs/fess-opensearch:3.9.0 ステップ 4: Compose ファイルの削除 -------------------------------- diff --git a/ja/15.9/install/upgrade.rst b/ja/15.9/install/upgrade.rst index a241d1475..9eb4a6620 100644 --- a/ja/15.9/install/upgrade.rst +++ b/ja/15.9/install/upgrade.rst @@ -23,7 +23,7 @@ .. important:: - |Fess| 14.x は OpenSearch 2.x 系、\ |Fess| 15.9 は OpenSearch 3.8.0 に対応しています。 + |Fess| 14.x は OpenSearch 2.x 系、\ |Fess| 15.9 は OpenSearch 3.9.0 に対応しています。 |Fess| 用の OpenSearch プラグインは OpenSearch のバージョンと完全に一致している必要があるため、 14.x からアップグレードする場合は OpenSearch のメジャーバージョンアップも必須です。 :ref:`upgrade-opensearch` を参照してください。 @@ -350,7 +350,7 @@ Docker 版 ステップ 4: OpenSearch のアップグレード ======================================= -|Fess| 15.9 は OpenSearch 3.8.0 に対応しています。接続先の OpenSearch がこれより古い場合は、 +|Fess| 15.9 は OpenSearch 3.9.0 に対応しています。接続先の OpenSearch がこれより古い場合は、 以下の手順でアップグレードしてください。 .. note:: @@ -378,21 +378,25 @@ Docker 版 インデックスの互換性に問題が発生する可能性があります。 |Fess| 14.x は OpenSearch 2.x 系のため、14.x からのアップグレードでは必ずこのケースに該当します。 + OpenSearch 3.9.0 で取得したスナップショットは、3.8.0 以前の OpenSearch には復元できません。切り戻しに備えて、アップグレード前に取得したスナップショットを残しておいてください。 + 1. 新しいバージョンの OpenSearch をインストール 2. プラグインを再インストール:: - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-fess:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-extension:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-minhash:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-configsync:3.8.0 + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-fess/3.9.0/opensearch-analysis-fess-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-extension/3.9.0/opensearch-analysis-extension-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-minhash/3.9.0/opensearch-minhash-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-configsync/3.9.0/opensearch-configsync-3.9.0.zip .. note:: これらのプラグインのバージョンは、使用する OpenSearch のバージョンと一致させる必要があります。 - |Fess| 15.9 は OpenSearch 3.8.0 に対応しています。バージョンが一致しない場合、 + |Fess| 15.9 は OpenSearch 3.9.0 に対応しています。バージョンが一致しない場合、 プラグインのインストールに失敗します。 + |Fess| 用の 4 つのプラグインは maven.codelibs.org で公開しているため、URL で指定します。 ``opensearch-plugin install`` の ``groupId:artifactId:version`` 形式は Maven Central だけを参照します。 + 3. 辞書ディレクトリを OpenSearch の設定ディレクトリの下へ移動 OpenSearch 3.8.0 以降は、辞書ファイルが OpenSearch の設定ディレクトリの外にあるとインデックスの作成を拒否します。 @@ -488,6 +492,8 @@ Docker 版:: :ref:`semantic-search-migration`\ （:doc:`../config/search-semantic`）を 参照してください。 + 15.8 以前で作成した文書インデックスを引き続き使う場合は、 :ref:`upgrade-reindex-new-fields` も参照してください。 + 1. 既存のクロールスケジュールを確認 2. 「システム」→「スケジューラ」から「Default Crawler」を実行 3. クロールが完了するまで待機 @@ -956,6 +962,40 @@ jcifs の既定値のままになります。 アクセストークンの動作は変わりません。登録済みのアクセストークンを付けたリクエストにはそのトークンの 権限が与えられ、未登録または期限切れのトークンを付けたリクエストは拒否されます。 +.. _upgrade-reindex-new-fields: + +既存の文書インデックスへの新しいフィールドとかなの正規化の反映 +-------------------------------------------------------------- + +15.9 は起動時に、設定・ログ・ユーザーのインデックスへ新しいフィールドを追加しますが、文書の +インデックスのマッピングと解析の設定は変更しません。15.8 以前で作成した文書インデックスを +そのまま使うと、次の 15.9 の変更が効きません。 + +- **ファイルの所有者と最終更新者**\ （\ ``owner``\ ・\ ``last_modifier``\ ）: ファイルシステム・SMB・FTP の + クロールで新たに索引されるフィールドです。既存の文書インデックスには定義がないため、最初に + クロールした値から ``text`` 型として自動でマッピングされ、\ ``owner:alice`` のような検索や + ``facet.field=owner`` が期待どおりに動きません。 +- **かなの表記ゆれと、長音符の代わりに書かれたダッシュの正規化**\ （例: ``サ―バ－`` を ``サーバー`` と + 同じ語として扱う）: 規則は文書インデックスの解析の設定と辞書 ``mapping.txt`` にあるため、 + 既存のインデックスには反映されません。 + +両方を反映するには、管理画面の「システム情報」→「メンテナンス」で「エイリアスの更新」と +「辞書の初期化」を有効にして「再インデクシング」を実行します。再インデクシングは既存の文書を +新しいインデックスへコピーするため、クロールし直す必要はありません。 + +.. warning:: + + 「辞書の初期化」は、同梱の辞書ファイルで OpenSearch 側の辞書を上書きします。管理画面の「辞書」で + 同義語などを編集している場合は、事前にダウンロードしておき、再インデクシングの後に反映し直して + ください。 + +.. note:: + + 15.8 以前に索引したファイルには、所有者と最終更新者の値がありません。差分クロールでは変更のない + ファイルは取得し直されないため、値を付けるには「システム」→「全般」の「最終更新日時の確認」を + 一時的に無効にしてクロールしてください。 + + 15.9 固有の移行作業 =================== @@ -1276,10 +1316,10 @@ Q: OpenSearch もアップグレードする必要がありますか？ ---------------------------------------------------- A: |Fess| のバージョンごとに対応する OpenSearch のバージョンが決まっています。 -|Fess| 15.9 は OpenSearch 3.8.0 に対応しています。 +|Fess| 15.9 は OpenSearch 3.9.0 に対応しています。 ``opensearch-analysis-fess`` などの |Fess| 用 OpenSearch プラグインは OpenSearch のバージョンと 完全に一致している必要があるため、OpenSearch をアップグレードする場合は、 -対応するバージョン（3.8.0）のプラグインに更新してください。 +対応するバージョン（3.9.0）のプラグインに更新してください。 なお |Fess| 15.9 は k-NN プラグインを必須とし、インデックス設定に ``knn.derived_source.enabled`` を常に送信します。古い OpenSearch のままでは新しいインデックスの作成に失敗するため、 @@ -1299,6 +1339,8 @@ A: |Fess| のマイナーバージョンアップ（15.x → 15.9）で、チャ :ref:`semantic-search-migration`\ （:doc:`../config/search-semantic`）を参照してください。 - **14.x からアップグレードする場合**: OpenSearch が 2.x から 3.x へメジャーバージョンアップ するため、インデックスの再作成を推奨します。 +- **15.8 以前で作成した文書インデックスで、所有者での検索やかなの正規化を使う場合**: 再インデクシングが + 必要です。詳細は :ref:`upgrade-reindex-new-fields` を参照してください。 .. warning:: diff --git a/ko/15.9/install/install-linux.rst b/ko/15.9/install/install-linux.rst index 07829ad57..c3e263f71 100644 --- a/ko/15.9/install/install-linux.rst +++ b/ko/15.9/install/install-linux.rst @@ -15,7 +15,7 @@ ZIP, RPM, DEB 각 패키지 형식에 대응합니다. - :doc:`prerequisites` 에 기재된 시스템 요구사항을 충족할 것 - Java 21이 설치되어 있을 것 -- OpenSearch 3.8.0을 사용 가능한 상태로 할 것(또는 신규 설치) +- OpenSearch 3.9.0을 사용 가능한 상태로 할 것(또는 신규 설치) 설치 방법 선택 ============== @@ -114,14 +114,14 @@ ZIP 버전 설치 :: - $ wget https://artifacts.opensearch.org/releases/bundle/opensearch/3.8.0/opensearch-3.8.0-linux-x64.tar.gz - $ tar -xzf opensearch-3.8.0-linux-x64.tar.gz - $ cd opensearch-3.8.0 + $ wget https://artifacts.opensearch.org/releases/bundle/opensearch/3.9.0/opensearch-3.9.0-linux-x64.tar.gz + $ tar -xzf opensearch-3.9.0-linux-x64.tar.gz + $ cd opensearch-3.9.0 .. note:: - 이 예제에서는 OpenSearch 3.8.0을 사용하고 있습니다. - |Fess| 15.9은 OpenSearch 3.8.0에 대응합니다. + 이 예제에서는 OpenSearch 3.9.0을 사용하고 있습니다. + |Fess| 15.9은 OpenSearch 3.9.0에 대응합니다. 2. OpenSearch 플러그인 설치 @@ -129,16 +129,18 @@ ZIP 버전 설치 :: - $ cd /path/to/opensearch-3.8.0 - $ ./bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-fess:3.8.0 - $ ./bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-extension:3.8.0 - $ ./bin/opensearch-plugin install org.codelibs.opensearch:opensearch-minhash:3.8.0 - $ ./bin/opensearch-plugin install org.codelibs.opensearch:opensearch-configsync:3.8.0 + $ cd /path/to/opensearch-3.9.0 + $ ./bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-fess/3.9.0/opensearch-analysis-fess-3.9.0.zip + $ ./bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-extension/3.9.0/opensearch-analysis-extension-3.9.0.zip + $ ./bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-minhash/3.9.0/opensearch-minhash-3.9.0.zip + $ ./bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-configsync/3.9.0/opensearch-configsync-3.9.0.zip .. important:: 플러그인 버전은 OpenSearch 버전과 일치시켜야 합니다. - 위의 예제에서는 모두 3.8.0을 지정하고 있습니다. + 위의 예제에서는 모두 3.9.0을 지정하고 있습니다. + + |Fess| 용 플러그인 4개는 maven.codelibs.org 에 공개되어 있으므로 URL로 지정합니다. ``opensearch-plugin install`` 의 ``groupId:artifactId:version`` 형식은 Maven Central만 참조합니다. 3. OpenSearch 설정 @@ -147,16 +149,16 @@ ZIP 버전 설치 :: # 설정 동기화용 경로(절대 경로로 지정) - configsync.config_path: /path/to/opensearch-3.8.0/config/dictionary/ + configsync.config_path: /path/to/opensearch-3.9.0/config/dictionary/ # 보안 플러그인 비활성화(개발 환경 전용) plugins.security.disabled: true .. important:: - ``configsync.config_path`` 에는 OpenSearch 설정 디렉터리(이 예에서는 ``/path/to/opensearch-3.8.0/config/``) 아래의 디렉터리를 지정하십시오. + ``configsync.config_path`` 에는 OpenSearch 설정 디렉터리(이 예에서는 ``/path/to/opensearch-3.9.0/config/``) 아래의 디렉터리를 지정하십시오. OpenSearch 3.8.0 이상에서는 사전 파일이 설정 디렉터리 밖에 있으면 인덱스 생성을 거부합니다. - ``/path/to/opensearch-3.8.0/data/config/`` 등 설정 디렉터리 밖을 지정하면 |Fess| 는 인덱스를 생성할 수 없어 시작되지 않습니다. + ``/path/to/opensearch-3.9.0/data/config/`` 등 설정 디렉터리 밖을 지정하면 |Fess| 는 인덱스를 생성할 수 없어 시작되지 않습니다. .. warning:: @@ -219,7 +221,7 @@ ZIP 버전 설치 변경 후:: SEARCH_ENGINE_HTTP_URL=${SEARCH_ENGINE_HTTP_URL:-http://localhost:9200} - FESS_DICTIONARY_PATH=/path/to/opensearch-3.8.0/config/dictionary/ + FESS_DICTIONARY_PATH=/path/to/opensearch-3.9.0/config/dictionary/ .. note:: @@ -260,8 +262,8 @@ RPM 버전은 Red Hat Enterprise Linux, CentOS, Fedora 등 RPM 기반 Linux 배 :: - $ wget https://artifacts.opensearch.org/releases/bundle/opensearch/3.8.0/opensearch-3.8.0-linux-x64.rpm - $ sudo rpm -ivh opensearch-3.8.0-linux-x64.rpm + $ wget https://artifacts.opensearch.org/releases/bundle/opensearch/3.9.0/opensearch-3.9.0-linux-x64.rpm + $ sudo rpm -ivh opensearch-3.9.0-linux-x64.rpm 또는 리포지토리를 추가하여 설치할 수도 있습니다. 자세한 내용은 `Installing OpenSearch `__ 를 참조하십시오. @@ -270,10 +272,10 @@ RPM 버전은 Red Hat Enterprise Linux, CentOS, Fedora 등 RPM 기반 Linux 배 :: - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-fess:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-extension:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-minhash:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-configsync:3.8.0 + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-fess/3.9.0/opensearch-analysis-fess-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-extension/3.9.0/opensearch-analysis-extension-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-minhash/3.9.0/opensearch-minhash-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-configsync/3.9.0/opensearch-configsync-3.9.0.zip 3. OpenSearch 설정 @@ -370,8 +372,8 @@ DEB 버전은 Debian, Ubuntu 등 DEB 기반 Linux 배포판에서 사용합니 :: - $ wget https://artifacts.opensearch.org/releases/bundle/opensearch/3.8.0/opensearch-3.8.0-linux-x64.deb - $ sudo dpkg -i opensearch-3.8.0-linux-x64.deb + $ wget https://artifacts.opensearch.org/releases/bundle/opensearch/3.9.0/opensearch-3.9.0-linux-x64.deb + $ sudo dpkg -i opensearch-3.9.0-linux-x64.deb 또는 리포지토리를 추가하여 설치할 수도 있습니다. 자세한 내용은 `Installing OpenSearch `__ 를 참조하십시오. @@ -380,10 +382,10 @@ DEB 버전은 Debian, Ubuntu 등 DEB 기반 Linux 배포판에서 사용합니 :: - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-fess:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-extension:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-minhash:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-configsync:3.8.0 + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-fess/3.9.0/opensearch-analysis-fess-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-extension/3.9.0/opensearch-analysis-extension-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-minhash/3.9.0/opensearch-minhash-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-configsync/3.9.0/opensearch-configsync-3.9.0.zip 3. OpenSearch 설정 @@ -480,7 +482,7 @@ DEB 버전은 Debian, Ubuntu 등 DEB 기반 Linux 배포판에서 사용합니 ZIP 버전의 경우:: - $ ls -ld /path/to/opensearch-3.8.0/config/dictionary/ + $ ls -ld /path/to/opensearch-3.9.0/config/dictionary/ RPM/DEB 버전의 경우:: @@ -518,7 +520,7 @@ Q: OpenSearch 버전은 다른 버전에서도 작동합니까? ------------------------------------------------ A: |Fess| 는 특정 버전의 OpenSearch에 의존합니다. -플러그인 호환성을 보장하기 위해 권장 버전(3.8.0)을 사용할 것을 강력히 권장합니다. +플러그인 호환성을 보장하기 위해 권장 버전(3.9.0)을 사용할 것을 강력히 권장합니다. 다른 버전을 사용하는 경우 플러그인 버전도 적절히 조정해야 합니다. Q: 여러 Fess 인스턴스에서 동일한 OpenSearch를 공유할 수 있습니까? diff --git a/ko/15.9/install/install-windows.rst b/ko/15.9/install/install-windows.rst index fed67c671..1edebc71d 100644 --- a/ko/15.9/install/install-windows.rst +++ b/ko/15.9/install/install-windows.rst @@ -15,7 +15,7 @@ ZIP 패키지를 사용한 설치 방법에 대해 기재하고 있습니다. - :doc:`prerequisites` 에 기재된 시스템 요구사항을 충족할 것 - Java 21이 설치되어 있을 것 -- OpenSearch 3.8.0을 사용 가능한 상태로 할 것(또는 신규 설치) +- OpenSearch 3.9.0을 사용 가능한 상태로 할 것(또는 신규 설치) - Windows 환경 변수 ``JAVA_HOME`` 이 적절히 설정되어 있을 것 Java 설치 확인 @@ -73,7 +73,7 @@ Java 21 이상이 표시되는지 확인하십시오. 절차를 하나씩 확인하려는 경우나 기존 OpenSearch 를 사용하는 경우에는 아래를 따르십시오. 기존 OpenSearch 에 플러그인만 설치하려면 - ``bin\fess-setup install opensearch-plugins --opensearch-home C:\opensearch-3.8.0`` 을 사용합니다. + ``bin\fess-setup install opensearch-plugins --opensearch-home C:\opensearch-3.9.0`` 을 사용합니다. 모든 명령에 대해서는 :doc:`fess-setup` 을 참조하십시오. OpenSearch 다운로드 @@ -85,7 +85,7 @@ OpenSearch 다운로드 예:: - C:\opensearch-3.8.0 + C:\opensearch-3.9.0 .. note:: @@ -98,16 +98,18 @@ OpenSearch 플러그인 설치 :: - C:\> cd C:\opensearch-3.8.0 - C:\opensearch-3.8.0> bin\opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-fess:3.8.0 - C:\opensearch-3.8.0> bin\opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-extension:3.8.0 - C:\opensearch-3.8.0> bin\opensearch-plugin install org.codelibs.opensearch:opensearch-minhash:3.8.0 - C:\opensearch-3.8.0> bin\opensearch-plugin install org.codelibs.opensearch:opensearch-configsync:3.8.0 + C:\> cd C:\opensearch-3.9.0 + C:\opensearch-3.9.0> bin\opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-fess/3.9.0/opensearch-analysis-fess-3.9.0.zip + C:\opensearch-3.9.0> bin\opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-extension/3.9.0/opensearch-analysis-extension-3.9.0.zip + C:\opensearch-3.9.0> bin\opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-minhash/3.9.0/opensearch-minhash-3.9.0.zip + C:\opensearch-3.9.0> bin\opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-configsync/3.9.0/opensearch-configsync-3.9.0.zip .. important:: 플러그인 버전은 OpenSearch 버전과 일치시켜야 합니다. - 위의 예제에서는 모두 3.8.0을 지정하고 있습니다. + 위의 예제에서는 모두 3.9.0을 지정하고 있습니다. + + |Fess| 용 플러그인 4개는 maven.codelibs.org 에 공개되어 있으므로 URL로 지정합니다. ``opensearch-plugin install`` 의 ``groupId:artifactId:version`` 형식은 Maven Central만 참조합니다. OpenSearch 설정 --------------- @@ -117,7 +119,7 @@ OpenSearch 설정 :: # 설정 동기화용 경로(절대 경로로 지정) - configsync.config_path: C:/opensearch-3.8.0/config/dictionary/ + configsync.config_path: C:/opensearch-3.9.0/config/dictionary/ # 보안 플러그인 비활성화(개발 환경 전용) plugins.security.disabled: true @@ -133,13 +135,13 @@ OpenSearch 설정 .. note:: Windows의 경우 경로 구분 문자는 ``\`` 가 아닌 ``/`` 를 사용하십시오. - ``C:\opensearch-3.8.0\config\dictionary\`` 가 아니라 ``C:/opensearch-3.8.0/config/dictionary/`` 로 기술합니다. + ``C:\opensearch-3.9.0\config\dictionary\`` 가 아니라 ``C:/opensearch-3.9.0/config/dictionary/`` 로 기술합니다. .. important:: - ``configsync.config_path`` 에는 OpenSearch 설정 디렉터리(이 예에서는 ``C:/opensearch-3.8.0/config/``) 아래의 디렉터리를 지정하십시오. + ``configsync.config_path`` 에는 OpenSearch 설정 디렉터리(이 예에서는 ``C:/opensearch-3.9.0/config/``) 아래의 디렉터리를 지정하십시오. OpenSearch 3.8.0 이상에서는 사전 파일이 설정 디렉터리 밖에 있으면 인덱스 생성을 거부합니다. - ``C:/opensearch-3.8.0/data/config/`` 등 설정 디렉터리 밖을 지정하면 |Fess| 는 인덱스를 생성할 수 없어 시작되지 않습니다. + ``C:/opensearch-3.9.0/data/config/`` 등 설정 디렉터리 밖을 지정하면 |Fess| 는 인덱스를 생성할 수 없어 시작되지 않습니다. .. tip:: @@ -193,7 +195,7 @@ Fess 설정 REM External opensearch cluster set FESS_JAVA_OPTS=%FESS_JAVA_OPTS% -Dfess.search_engine.http_address=http://localhost:9200 - set FESS_JAVA_OPTS=%FESS_JAVA_OPTS% -Dfess.dictionary.path=C:/opensearch-3.8.0/config/dictionary/ + set FESS_JAVA_OPTS=%FESS_JAVA_OPTS% -Dfess.dictionary.path=C:/opensearch-3.9.0/config/dictionary/ .. note:: @@ -304,7 +306,7 @@ Windows에서는 경로 길이에 제한이 있습니다. 가능한 한 짧은 예:: C:\opensearch (권장) - C:\Program Files\opensearch-3.8.0 (비권장 - 경로가 김) + C:\Program Files\opensearch-3.9.0 (비권장 - 경로가 김) Java가 인식되지 않음 -------------------- diff --git a/ko/15.9/install/install.rst b/ko/15.9/install/install.rst index b0c07408e..9c01ff262 100644 --- a/ko/15.9/install/install.rst +++ b/ko/15.9/install/install.rst @@ -126,7 +126,7 @@ Windows 버전 (ZIP) Docker 버전 이외의 경우 OpenSearch를 별도로 설정해야 합니다. - - OpenSearch 3.8.0 설치 + - OpenSearch 3.9.0 설치 - 필수 플러그인 설치 - 설정 파일 편집 @@ -157,7 +157,7 @@ OpenSearch 검색 엔진으로 OpenSearch를 사용합니다. -- **지원 버전**: OpenSearch 3.8.0 +- **지원 버전**: OpenSearch 3.9.0 - **필수 플러그인**: - opensearch-analysis-fess @@ -235,7 +235,7 @@ A: 예, 가능합니다. Fess와 OpenSearch를 별도의 서버에서 실행할 이 문서는 다음 버전을 대상으로 합니다: - **Fess**: 15.9.0 -- **OpenSearch**: 3.8.0 +- **OpenSearch**: 3.9.0 - **Java**: 21 이상 - **Docker**: 20.10 이상 - **Docker Compose**: 2.0 이상 diff --git a/ko/15.9/install/prerequisites.rst b/ko/15.9/install/prerequisites.rst index 2780605d7..2a47901e4 100644 --- a/ko/15.9/install/prerequisites.rst +++ b/ko/15.9/install/prerequisites.rst @@ -74,9 +74,9 @@ ZIP/RPM/DEB 버전 - OpenJDK 21 이상 - Eclipse Temurin 21 이상 -- **OpenSearch 3.8.0**: 필수입니다. OpenSearch 3 이전 버전에서는 |Fess| 가 시작되지 않습니다 +- **OpenSearch 3.9.0**: 필수입니다. OpenSearch 3 이전 버전에서는 |Fess| 가 시작되지 않습니다 - - 지원 버전: OpenSearch 3.8.0 + - 지원 버전: OpenSearch 3.9.0 - 기타 버전에서는 플러그인 호환성에 주의 필요 Docker 버전 diff --git a/ko/15.9/install/run.rst b/ko/15.9/install/run.rst index 4ba6e8b1c..cc57ee690 100644 --- a/ko/15.9/install/run.rst +++ b/ko/15.9/install/run.rst @@ -22,7 +22,7 @@ OpenSearch 시작 :: - $ cd /path/to/opensearch-3.8.0 + $ cd /path/to/opensearch-3.9.0 $ ./bin/opensearch 백그라운드에서 시작하는 경우:: @@ -31,13 +31,13 @@ OpenSearch 시작 .. note:: - ``bin/fess-setup install opensearch`` 로 설치한 OpenSearch 는 |Fess| 디렉터리의 ``opensearch/opensearch-3.8.0`` 에 있습니다. + ``bin/fess-setup install opensearch`` 로 설치한 OpenSearch 는 |Fess| 디렉터리의 ``opensearch/opensearch-3.9.0`` 에 있습니다. .. important:: OpenSearch 는 일반 사용자로 시작하십시오. ``root`` 로 시작하면 ``can not run opensearch as root`` 를 표시하고 종료합니다. 거부된 시작에서도 ``config/opensearch.keystore`` 등의 파일이 ``root`` 소유로 남으며, 다음에 일반 사용자로 시작하면 ``AccessDeniedException`` 으로 실패합니다. 다시 시작하기 전에 OpenSearch 디렉터리의 소유자를 그 사용자로 되돌리십시오. 예:: - $ sudo chown -R /path/to/opensearch-3.8.0 + $ sudo chown -R /path/to/opensearch-3.9.0 Fess 시작 ~~~~~~~~~~ @@ -67,8 +67,8 @@ OpenSearch 시작 또는 명령 프롬프트에서:: - C:\> cd C:\opensearch-3.8.0 - C:\opensearch-3.8.0> bin\opensearch.bat + C:\> cd C:\opensearch-3.9.0 + C:\opensearch-3.9.0> bin\opensearch.bat Fess 시작 ~~~~~~~~~~ diff --git a/ko/15.9/install/troubleshooting.rst b/ko/15.9/install/troubleshooting.rst index 728bbd225..6952b1c27 100644 --- a/ko/15.9/install/troubleshooting.rst +++ b/ko/15.9/install/troubleshooting.rst @@ -70,7 +70,7 @@ Java가 설치되어 있지 않거나 PATH 환경 변수가 올바르게 설정 2. 플러그인 버전을 OpenSearch 버전에 맞춤:: - $ /path/to/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-fess:3.6.0 + $ /path/to/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-fess/3.9.0/opensearch-analysis-fess-3.9.0.zip 3. 권한 확인:: @@ -194,7 +194,7 @@ OpenSearch 3.8.0 이상에서는 사전 파일이 OpenSearch 설정 디렉터리 1. ``configsync.config_path`` 와 ``FESS_DICTIONARY_PATH`` 를 OpenSearch 설정 디렉터리 아래의 디렉터리로 변경합니다. - RPM/DEB 버전: ``/etc/opensearch/dictionary/`` - - ZIP 버전: ``/path/to/opensearch-3.8.0/config/dictionary/`` + - ZIP 버전: ``/path/to/opensearch-3.9.0/config/dictionary/`` 2. 기존 사전 파일이 있는 경우 새 디렉터리로 복사합니다. 3. OpenSearch, |Fess| 순서로 재시작합니다. diff --git a/ko/15.9/install/uninstall.rst b/ko/15.9/install/uninstall.rst index 3bf763051..ec08f9d7f 100644 --- a/ko/15.9/install/uninstall.rst +++ b/ko/15.9/install/uninstall.rst @@ -77,13 +77,13 @@ ZIP 버전 제거 OpenSearch 설치 디렉터리를 삭제합니다:: - $ rm -rf /path/to/opensearch-3.8.0 + $ rm -rf /path/to/opensearch-3.9.0 단계 3: 데이터 디렉터리 삭제(옵션) ------------------------------------------- |Fess| 의 인덱스 데이터는 OpenSearch 에 저장됩니다. -기본적으로 OpenSearch 의 설치 디렉터리 내(``opensearch-3.8.0/data`` 등)에 저장되지만, +기본적으로 OpenSearch 의 설치 디렉터리 내(``opensearch-3.9.0/data`` 등)에 저장되지만, ``path.data`` 로 다른 위치를 지정한 경우 해당 디렉터리도 삭제하십시오:: $ rm -rf /path/to/data @@ -94,7 +94,7 @@ OpenSearch 설치 디렉터리를 삭제합니다:: 로그 파일을 삭제합니다:: $ rm -rf /path/to/fess-15.9.0/logs - $ rm -rf /path/to/opensearch-3.8.0/logs + $ rm -rf /path/to/opensearch-3.9.0/logs RPM 버전 제거 ====================== @@ -310,7 +310,7 @@ Docker 이미지를 삭제하여 디스크 공간을 확보하는 경우:: $ docker images | grep fess $ docker rmi ghcr.io/codelibs/fess:15.9.0 - $ docker rmi ghcr.io/codelibs/fess-opensearch:3.8.0 + $ docker rmi ghcr.io/codelibs/fess-opensearch:3.9.0 단계 4: Compose 파일 삭제 -------------------------------- diff --git a/ko/15.9/install/upgrade.rst b/ko/15.9/install/upgrade.rst index e846efb22..8eb66ca76 100644 --- a/ko/15.9/install/upgrade.rst +++ b/ko/15.9/install/upgrade.rst @@ -23,7 +23,7 @@ .. important:: - |Fess| 14.x는 OpenSearch 2.x 계열, |Fess| 15.9은 OpenSearch 3.8.0에 대응합니다. + |Fess| 14.x는 OpenSearch 2.x 계열, |Fess| 15.9은 OpenSearch 3.9.0에 대응합니다. |Fess| 용 OpenSearch 플러그인은 OpenSearch 버전과 완전히 일치해야 하므로, 14.x에서 업그레이드하는 경우 OpenSearch의 메이저 버전 업그레이드도 필수입니다. :ref:`upgrade-opensearch` 를 참조하십시오. @@ -349,7 +349,7 @@ Docker 버전 단계 4: OpenSearch 업그레이드 ==================================== -|Fess| 15.9은 OpenSearch 3.8.0에 대응합니다. 연결 대상 OpenSearch가 이보다 오래된 경우 +|Fess| 15.9은 OpenSearch 3.9.0에 대응합니다. 연결 대상 OpenSearch가 이보다 오래된 경우 다음 절차에 따라 업그레이드하십시오. .. note:: @@ -378,21 +378,25 @@ Docker 버전 인덱스 호환성에 문제가 발생할 수 있습니다. |Fess| 14.x는 OpenSearch 2.x 계열이므로, 14.x에서의 업그레이드는 반드시 이 경우에 해당합니다. + OpenSearch 3.9.0에서 생성한 스냅샷은 OpenSearch 3.8.0 이하로 복원할 수 없습니다. 롤백에 대비하여 업그레이드 전에 생성한 스냅샷을 보관해 두십시오. + 1. 새 버전의 OpenSearch 설치 2. 플러그인 재설치:: - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-fess:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-extension:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-minhash:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-configsync:3.8.0 + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-fess/3.9.0/opensearch-analysis-fess-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-extension/3.9.0/opensearch-analysis-extension-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-minhash/3.9.0/opensearch-minhash-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-configsync/3.9.0/opensearch-configsync-3.9.0.zip .. note:: 이러한 플러그인의 버전은 사용하는 OpenSearch의 버전과 일치시켜야 합니다. - |Fess| 15.9은 OpenSearch 3.8.0에 대응합니다. 버전이 일치하지 않으면 + |Fess| 15.9은 OpenSearch 3.9.0에 대응합니다. 버전이 일치하지 않으면 플러그인 설치에 실패합니다. + |Fess| 용 플러그인 4개는 maven.codelibs.org 에 공개되어 있으므로 URL로 지정합니다. ``opensearch-plugin install`` 의 ``groupId:artifactId:version`` 형식은 Maven Central만 참조합니다. + 3. 사전 디렉터리를 OpenSearch 설정 디렉터리 아래로 이동 OpenSearch 3.8.0 이상에서는 사전 파일이 OpenSearch 설정 디렉터리 밖에 있으면 인덱스 생성을 거부합니다. @@ -487,6 +491,8 @@ Docker 버전:: 실행하세요. 자세한 내용은 :ref:`semantic-search-migration`\ (:doc:`../config/search-semantic`)\ 을 참조하세요. + 15.8 이전에 생성한 문서 인덱스를 계속 사용하는 경우에는 :ref:`upgrade-reindex-new-fields` 도 참조하십시오. + 1. 기존 크롤 일정 확인 2. 「시스템」→「스케줄러」에서 "Default Crawler" 실행 3. 크롤이 완료될 때까지 대기 @@ -959,6 +965,38 @@ API 가 호출될 때 로그에 기록됩니다. JavaScript 를 실행하지 않 동작은 변경되지 않았습니다. 등록된 액세스 토큰이 있는 요청에는 해당 토큰의 권한이 부여되고, 등록되지 않았거나 만료된 토큰이 있는 요청은 거부됩니다. +.. _upgrade-reindex-new-fields: + +기존 문서 인덱스에 새 필드와 가나 정규화 반영 +--------------------------------------------- + +15.9는 시작할 때 설정·로그·사용자 인덱스에 새 필드를 추가하지만, 문서 인덱스의 매핑과 분석 설정은 +변경하지 않습니다. 15.8 이전에 생성한 문서 인덱스를 그대로 사용하면 다음 15.9 변경 사항이 적용되지 +않습니다. + +- **파일의 소유자와 최종 수정자** (``owner``, ``last_modifier``): 파일 시스템·SMB·FTP 크롤에서 새로 + 색인되는 필드입니다. 기존 문서 인덱스에는 정의가 없으므로 처음 크롤한 값에 따라 ``text`` 형으로 + 자동 매핑되어, ``owner:alice`` 와 같은 검색이나 ``facet.field=owner`` 가 의도대로 동작하지 않습니다. +- **가나 표기 차이와 장음 기호 대신 쓰인 대시의 정규화** (예: ``サ―バ－`` 를 ``サーバー`` 와 같은 + 단어로 취급): 규칙이 문서 인덱스의 분석 설정과 사전 ``mapping.txt`` 에 있으므로 기존 인덱스에는 + 반영되지 않습니다. + +두 가지를 모두 반영하려면 관리 화면의 「시스템 정보」→「유지보수」에서 「에일리어스 갱신」과 +「사전 초기화」를 활성화하고 「재인덱싱」을 실행합니다. 재인덱싱은 기존 문서를 새 인덱스로 복사하므로 +다시 크롤할 필요가 없습니다. + +.. warning:: + + 「사전 초기화」는 동봉된 사전 파일로 OpenSearch 측 사전을 덮어씁니다. 관리 화면의 「사전」에서 + 동의어 등을 편집한 경우에는 미리 다운로드해 두고, 재인덱싱 후에 다시 반영하십시오. + +.. note:: + + 15.8 이전에 색인된 파일에는 소유자와 최종 수정자 값이 없습니다. 차분 크롤에서는 변경되지 않은 + 파일을 다시 가져오지 않으므로, 값을 추가하려면 「시스템」→「일반」의 「최종 갱신 일시 확인」을 + 일시적으로 비활성화하고 크롤하십시오. + + 15.9 전용 마이그레이션 작업 =========================== @@ -1272,10 +1310,10 @@ Q: OpenSearch도 업그레이드해야 합니까? ------------------------------------------------- A: |Fess| 버전마다 대응하는 OpenSearch 버전이 정해져 있습니다. -|Fess| 15.9은 OpenSearch 3.8.0에 대응합니다. +|Fess| 15.9은 OpenSearch 3.9.0에 대응합니다. ``opensearch-analysis-fess`` 등의 |Fess| 용 OpenSearch 플러그인은 OpenSearch 버전과 완전히 일치해야 하므로, OpenSearch를 업그레이드하는 경우 -대응하는 버전(3.8.0)의 플러그인으로 업데이트하십시오. +대응하는 버전(3.9.0)의 플러그인으로 업데이트하십시오. 또한 |Fess| 15.9은 k-NN 플러그인을 필수로 하며, 인덱스 설정에 ``knn.derived_source.enabled`` 를 항상 전송합니다. 오래된 OpenSearch를 그대로 사용하면 새 인덱스 생성에 실패하므로 @@ -1295,6 +1333,8 @@ A: |Fess| 의 마이너 버전 업그레이드(15.x → 15.9)에서 청크 벡 :ref:`semantic-search-migration` (:doc:`../config/search-semantic`)를 참조하십시오. - **14.x에서 업그레이드하는 경우**: OpenSearch가 2.x에서 3.x로 메이저 버전 업그레이드 되므로 인덱스 재작성을 권장합니다. +- **15.8 이전에 생성한 문서 인덱스에서 소유자 검색이나 가나 정규화를 사용하는 경우**: 재인덱싱이 + 필요합니다. 자세한 내용은 :ref:`upgrade-reindex-new-fields` 를 참조하십시오. .. warning:: diff --git a/zh-cn/15.9/install/install-linux.rst b/zh-cn/15.9/install/install-linux.rst index 3eec0b6de..79444e516 100644 --- a/zh-cn/15.9/install/install-linux.rst +++ b/zh-cn/15.9/install/install-linux.rst @@ -15,7 +15,7 @@ - 满足 :doc:`prerequisites` 中描述的系统要求 - 已安装 Java 21 -- OpenSearch 3.8.0 可用（或新安装） +- OpenSearch 3.9.0 可用（或新安装） 选择安装方法 ================ @@ -114,14 +114,14 @@ :: - $ wget https://artifacts.opensearch.org/releases/bundle/opensearch/3.8.0/opensearch-3.8.0-linux-x64.tar.gz - $ tar -xzf opensearch-3.8.0-linux-x64.tar.gz - $ cd opensearch-3.8.0 + $ wget https://artifacts.opensearch.org/releases/bundle/opensearch/3.9.0/opensearch-3.9.0-linux-x64.tar.gz + $ tar -xzf opensearch-3.9.0-linux-x64.tar.gz + $ cd opensearch-3.9.0 .. note:: - 此示例使用 OpenSearch 3.8.0。 - |Fess| 15.9 支持 OpenSearch 3.8.0。 + 此示例使用 OpenSearch 3.9.0。 + |Fess| 15.9 支持 OpenSearch 3.9.0。 2. 安装 OpenSearch 插件 @@ -129,16 +129,18 @@ :: - $ cd /path/to/opensearch-3.8.0 - $ ./bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-fess:3.8.0 - $ ./bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-extension:3.8.0 - $ ./bin/opensearch-plugin install org.codelibs.opensearch:opensearch-minhash:3.8.0 - $ ./bin/opensearch-plugin install org.codelibs.opensearch:opensearch-configsync:3.8.0 + $ cd /path/to/opensearch-3.9.0 + $ ./bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-fess/3.9.0/opensearch-analysis-fess-3.9.0.zip + $ ./bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-extension/3.9.0/opensearch-analysis-extension-3.9.0.zip + $ ./bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-minhash/3.9.0/opensearch-minhash-3.9.0.zip + $ ./bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-configsync/3.9.0/opensearch-configsync-3.9.0.zip .. important:: 插件版本必须与 OpenSearch 版本一致。 - 在上述示例中，所有版本都指定为 3.8.0。 + 在上述示例中，所有版本都指定为 3.9.0。 + + |Fess| 的 4 个插件发布在 maven.codelibs.org 上，因此通过 URL 指定。 ``opensearch-plugin install`` 的 ``groupId:artifactId:version`` 形式只查找 Maven Central。 3. 配置 OpenSearch @@ -147,16 +149,16 @@ :: # 配置同步路径（使用绝对路径指定） - configsync.config_path: /path/to/opensearch-3.8.0/config/dictionary/ + configsync.config_path: /path/to/opensearch-3.9.0/config/dictionary/ # 禁用安全插件（仅限开发环境） plugins.security.disabled: true .. important:: - ``configsync.config_path`` 请指定 OpenSearch 配置目录（本例中为 ``/path/to/opensearch-3.8.0/config/``\ ）下的目录。 + ``configsync.config_path`` 请指定 OpenSearch 配置目录（本例中为 ``/path/to/opensearch-3.9.0/config/``\ ）下的目录。 从 OpenSearch 3.8.0 开始，如果词典文件位于配置目录之外，OpenSearch 会拒绝创建索引。 - 如果指定 ``/path/to/opensearch-3.8.0/data/config/`` 等配置目录之外的位置，|Fess| 将无法创建索引，也无法启动。 + 如果指定 ``/path/to/opensearch-3.9.0/data/config/`` 等配置目录之外的位置，|Fess| 将无法创建索引，也无法启动。 .. warning:: @@ -219,7 +221,7 @@ 修改后:: SEARCH_ENGINE_HTTP_URL=${SEARCH_ENGINE_HTTP_URL:-http://localhost:9200} - FESS_DICTIONARY_PATH=/path/to/opensearch-3.8.0/config/dictionary/ + FESS_DICTIONARY_PATH=/path/to/opensearch-3.9.0/config/dictionary/ .. note:: @@ -260,8 +262,8 @@ RPM 版用于 Red Hat Enterprise Linux、CentOS、Fedora 等基于 RPM 的 Linux :: - $ wget https://artifacts.opensearch.org/releases/bundle/opensearch/3.8.0/opensearch-3.8.0-linux-x64.rpm - $ sudo rpm -ivh opensearch-3.8.0-linux-x64.rpm + $ wget https://artifacts.opensearch.org/releases/bundle/opensearch/3.9.0/opensearch-3.9.0-linux-x64.rpm + $ sudo rpm -ivh opensearch-3.9.0-linux-x64.rpm 或者，也可以添加仓库后进行安装。 详情请参阅 `Installing OpenSearch `__\ 。 @@ -270,10 +272,10 @@ RPM 版用于 Red Hat Enterprise Linux、CentOS、Fedora 等基于 RPM 的 Linux :: - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-fess:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-extension:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-minhash:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-configsync:3.8.0 + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-fess/3.9.0/opensearch-analysis-fess-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-extension/3.9.0/opensearch-analysis-extension-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-minhash/3.9.0/opensearch-minhash-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-configsync/3.9.0/opensearch-configsync-3.9.0.zip 3. 配置 OpenSearch @@ -370,8 +372,8 @@ DEB 版用于 Debian、Ubuntu 等基于 DEB 的 Linux 发行版。 :: - $ wget https://artifacts.opensearch.org/releases/bundle/opensearch/3.8.0/opensearch-3.8.0-linux-x64.deb - $ sudo dpkg -i opensearch-3.8.0-linux-x64.deb + $ wget https://artifacts.opensearch.org/releases/bundle/opensearch/3.9.0/opensearch-3.9.0-linux-x64.deb + $ sudo dpkg -i opensearch-3.9.0-linux-x64.deb 或者，也可以添加仓库后进行安装。 详情请参阅 `Installing OpenSearch `__\ 。 @@ -380,10 +382,10 @@ DEB 版用于 Debian、Ubuntu 等基于 DEB 的 Linux 发行版。 :: - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-fess:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-extension:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-minhash:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-configsync:3.8.0 + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-fess/3.9.0/opensearch-analysis-fess-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-extension/3.9.0/opensearch-analysis-extension-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-minhash/3.9.0/opensearch-minhash-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-configsync/3.9.0/opensearch-configsync-3.9.0.zip 3. 配置 OpenSearch @@ -480,7 +482,7 @@ DEB 版用于 Debian、Ubuntu 等基于 DEB 的 Linux 发行版。 ZIP 版的情况:: - $ ls -ld /path/to/opensearch-3.8.0/config/dictionary/ + $ ls -ld /path/to/opensearch-3.9.0/config/dictionary/ RPM/DEB 版的情况:: @@ -518,7 +520,7 @@ Q: OpenSearch 的其他版本也能工作吗？ ---------------------------------------- A: |Fess| 依赖于特定版本的 OpenSearch。 -为了确保插件兼容性，强烈建议使用推荐版本（3.8.0）。 +为了确保插件兼容性，强烈建议使用推荐版本（3.9.0）。 如果使用其他版本，需要适当调整插件版本。 Q: 多个 Fess 实例可以共享同一个 OpenSearch 吗？ diff --git a/zh-cn/15.9/install/install-windows.rst b/zh-cn/15.9/install/install-windows.rst index 926667d05..8747d67c1 100644 --- a/zh-cn/15.9/install/install-windows.rst +++ b/zh-cn/15.9/install/install-windows.rst @@ -15,7 +15,7 @@ - 满足 :doc:`prerequisites` 中描述的系统要求 - 已安装 Java 21 -- OpenSearch 3.8.0 可用（或新安装） +- OpenSearch 3.9.0 可用（或新安装） - 已适当设置 Windows 环境变量 ``JAVA_HOME`` 确认 Java 安装 @@ -73,7 +73,7 @@ PowerShell 的情况:: 如果想逐步确认，或者要使用已有的 OpenSearch，请按照下面的步骤操作。 若只需向已有的 OpenSearch 安装插件，请使用 - ``bin\fess-setup install opensearch-plugins --opensearch-home C:\opensearch-3.8.0``\ 。 + ``bin\fess-setup install opensearch-plugins --opensearch-home C:\opensearch-3.9.0``\ 。 所有命令请参阅 :doc:`fess-setup`\ 。 下载 OpenSearch @@ -85,7 +85,7 @@ PowerShell 的情况:: 例:: - C:\opensearch-3.8.0 + C:\opensearch-3.9.0 .. note:: @@ -98,16 +98,18 @@ PowerShell 的情况:: :: - C:\> cd C:\opensearch-3.8.0 - C:\opensearch-3.8.0> bin\opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-fess:3.8.0 - C:\opensearch-3.8.0> bin\opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-extension:3.8.0 - C:\opensearch-3.8.0> bin\opensearch-plugin install org.codelibs.opensearch:opensearch-minhash:3.8.0 - C:\opensearch-3.8.0> bin\opensearch-plugin install org.codelibs.opensearch:opensearch-configsync:3.8.0 + C:\> cd C:\opensearch-3.9.0 + C:\opensearch-3.9.0> bin\opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-fess/3.9.0/opensearch-analysis-fess-3.9.0.zip + C:\opensearch-3.9.0> bin\opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-extension/3.9.0/opensearch-analysis-extension-3.9.0.zip + C:\opensearch-3.9.0> bin\opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-minhash/3.9.0/opensearch-minhash-3.9.0.zip + C:\opensearch-3.9.0> bin\opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-configsync/3.9.0/opensearch-configsync-3.9.0.zip .. important:: 插件版本必须与 OpenSearch 版本一致。 - 在上述示例中，所有版本都指定为 3.8.0。 + 在上述示例中，所有版本都指定为 3.9.0。 + + |Fess| 的 4 个插件发布在 maven.codelibs.org 上，因此通过 URL 指定。 ``opensearch-plugin install`` 的 ``groupId:artifactId:version`` 形式只查找 Maven Central。 配置 OpenSearch --------------- @@ -117,7 +119,7 @@ PowerShell 的情况:: :: # 配置同步路径（使用绝对路径指定） - configsync.config_path: C:/opensearch-3.8.0/config/dictionary/ + configsync.config_path: C:/opensearch-3.9.0/config/dictionary/ # 禁用安全插件（仅限开发环境） plugins.security.disabled: true @@ -133,13 +135,13 @@ PowerShell 的情况:: .. note:: 在 Windows 中，路径分隔符请使用 ``/`` 而不是 ``\``\ 。 - 应写为 ``C:/opensearch-3.8.0/config/dictionary/`` 而不是 ``C:\opensearch-3.8.0\config\dictionary\``\ 。 + 应写为 ``C:/opensearch-3.9.0/config/dictionary/`` 而不是 ``C:\opensearch-3.9.0\config\dictionary\``\ 。 .. important:: - ``configsync.config_path`` 请指定 OpenSearch 配置目录（本例中为 ``C:/opensearch-3.8.0/config/``\ ）下的目录。 + ``configsync.config_path`` 请指定 OpenSearch 配置目录（本例中为 ``C:/opensearch-3.9.0/config/``\ ）下的目录。 从 OpenSearch 3.8.0 开始，如果词典文件位于配置目录之外，OpenSearch 会拒绝创建索引。 - 如果指定 ``C:/opensearch-3.8.0/data/config/`` 等配置目录之外的位置，|Fess| 将无法创建索引，也无法启动。 + 如果指定 ``C:/opensearch-3.9.0/data/config/`` 等配置目录之外的位置，|Fess| 将无法创建索引，也无法启动。 .. tip:: @@ -193,7 +195,7 @@ PowerShell 的情况:: REM External opensearch cluster set FESS_JAVA_OPTS=%FESS_JAVA_OPTS% -Dfess.search_engine.http_address=http://localhost:9200 - set FESS_JAVA_OPTS=%FESS_JAVA_OPTS% -Dfess.dictionary.path=C:/opensearch-3.8.0/config/dictionary/ + set FESS_JAVA_OPTS=%FESS_JAVA_OPTS% -Dfess.dictionary.path=C:/opensearch-3.9.0/config/dictionary/ .. note:: @@ -304,7 +306,7 @@ Windows 对路径长度有限制。建议安装到尽可能短的路径。 例:: C:\opensearch (推荐) - C:\Program Files\opensearch-3.8.0 (不推荐 - 路径过长) + C:\Program Files\opensearch-3.9.0 (不推荐 - 路径过长) Java 未被识别 ------------- diff --git a/zh-cn/15.9/install/install.rst b/zh-cn/15.9/install/install.rst index 646c9bc82..1a236250a 100644 --- a/zh-cn/15.9/install/install.rst +++ b/zh-cn/15.9/install/install.rst @@ -126,7 +126,7 @@ Windows 版 (ZIP) Docker 版以外的情况下，需要单独设置 OpenSearch。 - - 安装 OpenSearch 3.8.0 + - 安装 OpenSearch 3.9.0 - 安装必需插件 - 编辑配置文件 @@ -157,7 +157,7 @@ OpenSearch 使用 OpenSearch 作为搜索引擎。 -- **支持版本**: OpenSearch 3.8.0 +- **支持版本**: OpenSearch 3.9.0 - **必需插件**: - opensearch-analysis-fess @@ -235,7 +235,7 @@ A: 可以。Fess 和 OpenSearch 可以在不同的服务器上运行。 本文档适用于以下版本： - **Fess**: 15.9.0 -- **OpenSearch**: 3.8.0 +- **OpenSearch**: 3.9.0 - **Java**: 21 或更高版本 - **Docker**: 20.10 或更高版本 - **Docker Compose**: 2.0 或更高版本 diff --git a/zh-cn/15.9/install/prerequisites.rst b/zh-cn/15.9/install/prerequisites.rst index f254e0f35..be9f88694 100644 --- a/zh-cn/15.9/install/prerequisites.rst +++ b/zh-cn/15.9/install/prerequisites.rst @@ -73,9 +73,9 @@ ZIP/RPM/DEB 版 - OpenJDK 21 或更高版本 - Eclipse Temurin 21 或更高版本 -- **OpenSearch 3.8.0**: 必需。使用早于 OpenSearch 3 的引擎时 |Fess| 无法启动 +- **OpenSearch 3.9.0**: 必需。使用早于 OpenSearch 3 的引擎时 |Fess| 无法启动 - - 支持版本: OpenSearch 3.8.0 + - 支持版本: OpenSearch 3.9.0 - 其他版本需要注意插件兼容性 Docker 版 diff --git a/zh-cn/15.9/install/run.rst b/zh-cn/15.9/install/run.rst index d7c605360..7b5945481 100644 --- a/zh-cn/15.9/install/run.rst +++ b/zh-cn/15.9/install/run.rst @@ -22,7 +22,7 @@ ZIP 版的情况 :: - $ cd /path/to/opensearch-3.8.0 + $ cd /path/to/opensearch-3.9.0 $ ./bin/opensearch 在后台启动:: @@ -31,13 +31,13 @@ ZIP 版的情况 .. note:: - ``bin/fess-setup install opensearch`` 会将 OpenSearch 放在 |Fess| 目录下的 ``opensearch/opensearch-3.8.0`` 中。 + ``bin/fess-setup install opensearch`` 会将 OpenSearch 放在 |Fess| 目录下的 ``opensearch/opensearch-3.9.0`` 中。 .. important:: 请以普通用户启动 OpenSearch。它拒绝以 ``root`` 身份运行，并以 ``can not run opensearch as root`` 结束。被拒绝的启动仍会留下 ``config/opensearch.keystore`` 等归 ``root`` 所有的文件，之后以普通用户启动时会因 ``AccessDeniedException`` 而失败。再次启动之前，请将 OpenSearch 目录的所有者改回该用户，例如:: - $ sudo chown -R /path/to/opensearch-3.8.0 + $ sudo chown -R /path/to/opensearch-3.9.0 启动 Fess ~~~~~~~~~~ @@ -67,8 +67,8 @@ ZIP 版的情况（Windows） 或者，从命令提示符:: - C:\> cd C:\opensearch-3.8.0 - C:\opensearch-3.8.0> bin\opensearch.bat + C:\> cd C:\opensearch-3.9.0 + C:\opensearch-3.9.0> bin\opensearch.bat 启动 Fess ~~~~~~~~~~ diff --git a/zh-cn/15.9/install/troubleshooting.rst b/zh-cn/15.9/install/troubleshooting.rst index fe6ff95b7..92383e75f 100644 --- a/zh-cn/15.9/install/troubleshooting.rst +++ b/zh-cn/15.9/install/troubleshooting.rst @@ -70,7 +70,7 @@ Java 未安装，或 PATH 环境变量未正确设置。 2. 将插件版本与 OpenSearch 版本匹配:: - $ /path/to/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-fess:3.6.0 + $ /path/to/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-fess/3.9.0/opensearch-analysis-fess-3.9.0.zip 3. 确认权限:: @@ -194,7 +194,7 @@ OpenSearch 无法启动 1. 将 ``configsync.config_path`` 和 ``FESS_DICTIONARY_PATH`` 更改为 OpenSearch 配置目录下的目录。 - RPM/DEB 版：``/etc/opensearch/dictionary/`` - - ZIP 版：``/path/to/opensearch-3.8.0/config/dictionary/`` + - ZIP 版：``/path/to/opensearch-3.9.0/config/dictionary/`` 2. 如果已有词典文件，请将其复制到新目录。 3. 按 OpenSearch、|Fess| 的顺序重新启动。 diff --git a/zh-cn/15.9/install/uninstall.rst b/zh-cn/15.9/install/uninstall.rst index 54de574e8..4a9d61cc6 100644 --- a/zh-cn/15.9/install/uninstall.rst +++ b/zh-cn/15.9/install/uninstall.rst @@ -77,13 +77,13 @@ ZIP 版的卸载 删除 OpenSearch 的安装目录:: - $ rm -rf /path/to/opensearch-3.8.0 + $ rm -rf /path/to/opensearch-3.9.0 步骤 3: 删除数据目录（可选） -------------------------- |Fess| 的索引数据保存在 OpenSearch 中。 -默认情况下保存在 OpenSearch 的安装目录内（如 ``opensearch-3.8.0/data``）， +默认情况下保存在 OpenSearch 的安装目录内（如 ``opensearch-3.9.0/data``）， 但如果通过 ``path.data`` 指定了其他位置，请同时删除该目录:: $ rm -rf /path/to/data @@ -94,7 +94,7 @@ ZIP 版的卸载 删除日志文件:: $ rm -rf /path/to/fess-15.9.0/logs - $ rm -rf /path/to/opensearch-3.8.0/logs + $ rm -rf /path/to/opensearch-3.9.0/logs RPM 版的卸载 ============ @@ -309,7 +309,7 @@ Docker 版的卸载 $ docker images | grep fess $ docker rmi ghcr.io/codelibs/fess:15.9.0 - $ docker rmi ghcr.io/codelibs/fess-opensearch:3.8.0 + $ docker rmi ghcr.io/codelibs/fess-opensearch:3.9.0 步骤 4: 删除 Compose 文件 ----------------------- diff --git a/zh-cn/15.9/install/upgrade.rst b/zh-cn/15.9/install/upgrade.rst index 66c32891a..e367ac5dd 100644 --- a/zh-cn/15.9/install/upgrade.rst +++ b/zh-cn/15.9/install/upgrade.rst @@ -23,7 +23,7 @@ .. important:: - |Fess| 14.x 对应 OpenSearch 2.x 系列，\ |Fess| 15.9 对应 OpenSearch 3.8.0。 + |Fess| 14.x 对应 OpenSearch 2.x 系列，\ |Fess| 15.9 对应 OpenSearch 3.9.0。 由于 |Fess| 专用的 OpenSearch 插件必须与 OpenSearch 版本完全一致， 因此从 14.x 升级时，也必须同时对 OpenSearch 进行主版本升级。 请参阅 :ref:`upgrade-opensearch`。 @@ -346,7 +346,7 @@ Docker 版 步骤 4: 升级 OpenSearch ==================================== -|Fess| 15.9 对应 OpenSearch 3.8.0。如果所连接的 OpenSearch 版本比这更旧， +|Fess| 15.9 对应 OpenSearch 3.9.0。如果所连接的 OpenSearch 版本比这更旧， 请按照以下步骤升级。 .. note:: @@ -374,21 +374,25 @@ Docker 版 可能会出现索引兼容性问题。 |Fess| 14.x 对应 OpenSearch 2.x 系列，因此从 14.x 升级时必然属于这种情况。 + 在 OpenSearch 3.9.0 上创建的快照无法恢复到 OpenSearch 3.8.0 及更早版本。请保留升级前创建的快照，以备回滚。 + 1. 安装新版本的 OpenSearch 2. 重新安装插件:: - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-fess:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-analysis-extension:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-minhash:3.8.0 - $ sudo /usr/share/opensearch/bin/opensearch-plugin install org.codelibs.opensearch:opensearch-configsync:3.8.0 + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-fess/3.9.0/opensearch-analysis-fess-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-analysis-extension/3.9.0/opensearch-analysis-extension-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-minhash/3.9.0/opensearch-minhash-3.9.0.zip + $ sudo /usr/share/opensearch/bin/opensearch-plugin install https://maven.codelibs.org/release/org/codelibs/opensearch/opensearch-configsync/3.9.0/opensearch-configsync-3.9.0.zip .. note:: 这些插件的版本必须与所使用的 OpenSearch 版本一致。 - |Fess| 15.9 对应 OpenSearch 3.8.0。如果版本不一致， + |Fess| 15.9 对应 OpenSearch 3.9.0。如果版本不一致， 插件安装将会失败。 + |Fess| 的 4 个插件发布在 maven.codelibs.org 上，因此通过 URL 指定。 ``opensearch-plugin install`` 的 ``groupId:artifactId:version`` 形式只查找 Maven Central。 + 3. 将词典目录移至 OpenSearch 配置目录下 从 OpenSearch 3.8.0 开始，如果词典文件位于 OpenSearch 配置目录之外，OpenSearch 会拒绝创建索引。 @@ -481,6 +485,8 @@ Docker 版:: 索引——例如要新启用分块向量搜索（语义搜索）时——请在管理界面的「系统信息」→「维护」中 单独运行「重新索引」。详情请参阅 :ref:`semantic-search-migration`\ （:doc:`../config/search-semantic`）。 + 如果继续使用由 15.8 或更早版本创建的文档索引，另请参阅 :ref:`upgrade-reindex-new-fields`\ 。 + 1. 确认现有爬取计划 2. 从「系统」→「调度器」执行「Default Crawler」 3. 等待爬取完成 @@ -911,6 +917,34 @@ API 请求。由于搜索界面现在通过 ``/api/v2/search`` 进行搜索， 如需禁止匿名用户搜索，请设置 ``login.required=true`` 。访问令牌的行为不变：带有已注册访问令牌的请求 会获得该令牌的权限，带有未注册或已过期令牌的请求会被拒绝。 +.. _upgrade-reindex-new-fields: + +将新字段和假名规范化应用到现有文档索引 +-------------------------------------- + +15.9 在启动时会向配置、日志和用户索引添加新字段，但不会更改文档索引的映射和分析设置。如果继续使用 +由 15.8 或更早版本创建的文档索引，以下 15.9 的变更不会生效。 + +- **文件的所有者和最后修改者**\ （\ ``owner``\ 、\ ``last_modifier``\ ）: 文件系统、SMB 和 FTP 爬取时新索引的 + 字段。现有文档索引中没有它们的定义，因此会根据首次爬取的值被自动映射为 ``text`` 类型， + ``owner:alice`` 之类的搜索和 ``facet.field=owner`` 无法按预期工作。 +- **假名异体和代替长音符号书写的破折号的规范化**\ （例如将 ``サ―バ－`` 视为与 ``サーバー`` 相同的词）: + 规则位于文档索引的分析设置和词典 ``mapping.txt`` 中，因此不会应用到现有索引。 + +要同时应用两者，请在管理界面的「系统信息」→「维护」中启用「更新别名」和「重置字典」，然后运行 +「重新索引」。重新索引会将现有文档复制到新索引，因此无需重新爬取。 + +.. warning:: + + 「重置字典」会用随附的词典文件覆盖 OpenSearch 端的词典。如果在管理界面的「字典」中编辑过同义词等， + 请事先下载，并在重新索引后重新应用。 + +.. note:: + + 由 15.8 或更早版本索引的文件没有所有者和最后修改者的值。增量爬取不会重新获取未更改的文件， + 因此要添加这些值，请暂时禁用「系统」→「常规」中的「检查上次修改时间」后再进行爬取。 + + 15.9 特有的迁移工作 =================== @@ -1203,9 +1237,9 @@ Q: 需要升级 OpenSearch 吗？ ------------------------------------------------- A: 每个 |Fess| 版本对应特定的 OpenSearch 版本。 -|Fess| 15.9 对应 OpenSearch 3.8.0。 +|Fess| 15.9 对应 OpenSearch 3.9.0。 由于 ``opensearch-analysis-fess`` 等 |Fess| 专用 OpenSearch 插件必须与 OpenSearch 版本完全一致， -因此在升级 OpenSearch 时，请同时将插件更新为对应版本（3.8.0）。 +因此在升级 OpenSearch 时，请同时将插件更新为对应版本（3.9.0）。 另外，|Fess| 15.9 强制要求安装 k-NN 插件，并会在索引设置中始终发送 ``knn.derived_source.enabled``。如果 OpenSearch 版本过旧，会导致新索引创建失败， @@ -1225,6 +1259,8 @@ A: 对于 |Fess| 的小版本升级（15.x → 15.9），如果不使用分块 :ref:`semantic-search-migration`\ （:doc:`../config/search-semantic`）。 - **从 14.x 升级时**: 由于 OpenSearch 会从 2.x 主版本升级到 3.x， 建议重建索引。 +- **在由 15.8 或更早版本创建的文档索引上使用所有者搜索或假名规范化时**: 需要重新索引。 + 详情请参阅 :ref:`upgrade-reindex-new-fields`\ 。 .. warning::