docs(15.9): say that fess-setup install opensearch removes the unused bundled plugins

de/15.9/install/fess-setup.rst

@@ -41,7 +41,7 @@ install opensearch
 
 ::
 
-    $ bin/fess-setup install opensearch [--dest <dir>] [--version <version>]
+    $ bin/fess-setup install opensearch [--dest <dir>] [--version <version>] [--keep-bundled-plugins]
 
 Lädt die von diesem |Fess| unterstützte OpenSearch-Version nach ``opensearch/`` im
 |Fess|-Verzeichnis herunter, installiert die vier von |Fess| benötigten Plugins
@@ -52,6 +52,10 @@ Einstellungen hinzu:
 - ``configsync.config_path``, gesetzt auf das Verzeichnis ``config/dictionary`` dieses OpenSearch
 - ``plugins.security.disabled: true``
 
+Außerdem entfernt der Befehl die mitgelieferten Plugins ``opensearch-security-analytics`` und
+``opensearch-performance-analyzer``, die |Fess| nicht verwendet; auch das OpenSearch im Docker-Image
+enthält sie nicht. Ein Plugin, das im Download nicht enthalten ist, wird übersprungen.
+
 Eine Einstellung, die ``opensearch.yml`` bereits enthält, wird nicht erneut hinzugefügt, und
 ``plugins.security.disabled: true`` wird nicht hinzugefügt, wenn die Datei irgendeine
 ``plugins.security.*``-Einstellung enthält. Existiert das OpenSearch-Verzeichnis bereits, wird der
@@ -78,6 +82,8 @@ Werte für ``SEARCH_ENGINE_HTTP_URL`` und ``FESS_DICTIONARY_PATH`` aus, die zu s
        OpenSearch.
    * - ``--version <version>``
      - Die zu installierende OpenSearch-Version. Die Plugins werden in derselben Version installiert.
+   * - ``--keep-bundled-plugins``
+     - Behält die mitgelieferten Plugins (``opensearch-security-analytics`` und ``opensearch-performance-analyzer``), statt sie zu entfernen, und lässt den Download unverändert.
 
 OpenSearch veröffentlicht offizielle Builds nur für Linux und Windows. Auf anderen Plattformen wie
 macOS beendet sich der Befehl vor jedem Download mit dem Exit-Code ``1`` und schlägt vor, OpenSearch

en/15.9/install/fess-setup.rst

@@ -39,7 +39,7 @@ install opensearch
 
 ::
 
-    $ bin/fess-setup install opensearch [--dest <dir>] [--version <version>]
+    $ bin/fess-setup install opensearch [--dest <dir>] [--version <version>] [--keep-bundled-plugins]
 
 Downloads the OpenSearch version this |Fess| supports into ``opensearch/`` in the |Fess| directory,
 installs the four plugins |Fess| requires (``opensearch-analysis-fess``,
@@ -49,6 +49,10 @@ appends the following settings to its ``config/opensearch.yml``:
 - ``configsync.config_path``, set to the ``config/dictionary`` directory of that OpenSearch
 - ``plugins.security.disabled: true``
 
+It also removes ``opensearch-security-analytics`` and ``opensearch-performance-analyzer``,
+bundled plugins that |Fess| does not use, as the OpenSearch in the Docker image does not have them
+either. A plugin the download does not include is skipped.
+
 A setting that ``opensearch.yml`` already has is not added again, and
 ``plugins.security.disabled: true`` is not added when the file has any ``plugins.security.*``
 setting. When the OpenSearch directory already exists, the download is skipped, so running the
@@ -73,6 +77,8 @@ OpenSearch on the same host. Otherwise the command prints the ``SEARCH_ENGINE_HT
        directory. ``bin/fess.in.sh`` does not look for OpenSearch outside that directory.
    * - ``--version <version>``
      - The OpenSearch version to install. The plugins are installed at the same version.
+   * - ``--keep-bundled-plugins``
+     - Keeps the bundled plugins (``opensearch-security-analytics`` and ``opensearch-performance-analyzer``) instead of removing them, leaving the download as shipped.
 
 OpenSearch publishes official builds for Linux and Windows only. On other platforms, such as macOS,
 the command exits with code ``1`` before downloading anything and suggests installing OpenSearch

es/15.9/install/fess-setup.rst

@@ -40,7 +40,7 @@ install opensearch
 
 ::
 
-    $ bin/fess-setup install opensearch [--dest <dir>] [--version <version>]
+    $ bin/fess-setup install opensearch [--dest <dir>] [--version <version>] [--keep-bundled-plugins]
 
 Descarga la versión de OpenSearch compatible con este |Fess| en ``opensearch/`` dentro del
 directorio de |Fess|, instala los cuatro plugins que requiere |Fess| (``opensearch-analysis-fess``,
@@ -50,6 +50,10 @@ siguiente configuración a su ``config/opensearch.yml``:
 - ``configsync.config_path``, con el directorio ``config/dictionary`` de ese OpenSearch como valor
 - ``plugins.security.disabled: true``
 
+Además, elimina los plugins incluidos ``opensearch-security-analytics`` y
+``opensearch-performance-analyzer``, que |Fess| no utiliza; el OpenSearch de la imagen Docker
+tampoco los incluye. Si la descarga no incluye alguno de ellos, se omite.
+
 Una opción que ``opensearch.yml`` ya contiene no se vuelve a añadir, y
 ``plugins.security.disabled: true`` no se añade si el archivo contiene cualquier opción
 ``plugins.security.*``. Si el directorio de OpenSearch ya existe, se omite la descarga, de modo que
@@ -74,6 +78,8 @@ que debe establecer, tal como se describe en :doc:`install-linux` o :doc:`instal
        directorio de |Fess|. ``bin/fess.in.sh`` no busca OpenSearch fuera de ese directorio.
    * - ``--version <version>``
      - La versión de OpenSearch que se instala. Los plugins se instalan en la misma versión.
+   * - ``--keep-bundled-plugins``
+     - Conserva los plugins incluidos (``opensearch-security-analytics`` y ``opensearch-performance-analyzer``) en lugar de eliminarlos, y deja la descarga tal como se distribuye.
 
 OpenSearch publica versiones oficiales solo para Linux y Windows. En otras plataformas, como macOS,
 el comando termina con el código ``1`` antes de descargar nada y sugiere instalar OpenSearch con

fr/15.9/install/fess-setup.rst

@@ -41,7 +41,7 @@ install opensearch
 
 ::
 
-    $ bin/fess-setup install opensearch [--dest <dir>] [--version <version>]
+    $ bin/fess-setup install opensearch [--dest <dir>] [--version <version>] [--keep-bundled-plugins]
 
 Télécharge la version d'OpenSearch prise en charge par ce |Fess| dans ``opensearch/`` du répertoire
 de |Fess|, y installe les quatre plugins requis par |Fess| (``opensearch-analysis-fess``,
@@ -51,6 +51,10 @@ les paramètres suivants à son ``config/opensearch.yml`` :
 - ``configsync.config_path``, défini sur le répertoire ``config/dictionary`` de cet OpenSearch
 - ``plugins.security.disabled: true``
 
+La commande supprime également les plugins fournis ``opensearch-security-analytics`` et
+``opensearch-performance-analyzer``, que |Fess| n'utilise pas ; l'OpenSearch de l'image Docker ne
+les contient pas non plus. Un plugin absent du téléchargement est ignoré.
+
 Un paramètre déjà présent dans ``opensearch.yml`` n'est pas ajouté une seconde fois, et
 ``plugins.security.disabled: true`` n'est pas ajouté lorsque le fichier contient un paramètre
 ``plugins.security.*``, quel qu'il soit. Lorsque le répertoire d'OpenSearch existe déjà, le
@@ -76,6 +80,8 @@ comme décrit dans :doc:`install-linux` ou :doc:`install-windows`.
        |Fess|. ``bin/fess.in.sh`` ne recherche pas OpenSearch en dehors de ce répertoire.
    * - ``--version <version>``
      - Version d'OpenSearch à installer. Les plugins sont installés dans la même version.
+   * - ``--keep-bundled-plugins``
+     - Conserve les plugins fournis (``opensearch-security-analytics`` et ``opensearch-performance-analyzer``) au lieu de les supprimer, et laisse le téléchargement tel quel.
 
 OpenSearch ne publie de versions officielles que pour Linux et Windows. Sur les autres plateformes,
 comme macOS, la commande se termine avec le code ``1`` avant tout téléchargement et suggère

ja/15.9/install/fess-setup.rst

@@ -35,13 +35,15 @@ install opensearch
 
 ::
 
-    $ bin/fess-setup install opensearch [--dest <dir>] [--version <version>]
+    $ bin/fess-setup install opensearch [--dest <dir>] [--version <version>] [--keep-bundled-plugins]
 
 この |Fess| が対応するバージョンの OpenSearch を |Fess| のディレクトリの ``opensearch/`` にダウンロードし、 |Fess| が必要とする 4 つのプラグイン（ ``opensearch-analysis-fess`` 、 ``opensearch-analysis-extension`` 、 ``opensearch-minhash`` 、 ``opensearch-configsync`` ）を導入したうえで、その ``config/opensearch.yml`` に次の設定を追記します。
 
 - ``configsync.config_path`` （値はその OpenSearch の ``config/dictionary`` ディレクトリ）
 - ``plugins.security.disabled: true``
 
+また、 |Fess| が使用しない同梱プラグイン ``opensearch-security-analytics`` と ``opensearch-performance-analyzer`` を削除します。Docker イメージの OpenSearch と同じ構成です。配布物に含まれないプラグインは何もせずに進みます。
+
 ``opensearch.yml`` にすでにある設定は追記しません。また、 ``plugins.security.*`` の設定が 1 つでもある場合は ``plugins.security.disabled: true`` を追記しません。OpenSearch のディレクトリがすでにある場合はダウンロードを省略するため、既存のインストールに対して再実行すると、足りない設定だけが追記されます。
 
 コマンドは追記した設定を表示し、続けて ``bin/fess.in.sh`` がこの OpenSearch を自動で見つけられるかどうかを表示します。 |Fess| のディレクトリの ``opensearch/`` の下で ``config/dictionary`` ディレクトリを持つ OpenSearch がこれ 1 つだけであれば見つけられます。このとき ``bin/fess.in.sh`` （Windows では ``bin\fess.in.bat`` ）が ``FESS_DICTIONARY_PATH`` をそのディレクトリに設定するため、同じホストで動かす OpenSearch であれば、ほかに設定は必要ありません。見つけられない場合は、設定すべき ``SEARCH_ENGINE_HTTP_URL`` と ``FESS_DICTIONARY_PATH`` の値を表示します。設定方法は :doc:`install-linux` または :doc:`install-windows` を参照してください。
@@ -56,6 +58,8 @@ install opensearch
      - OpenSearch の展開先を、 |Fess| のディレクトリの ``opensearch/`` の代わりに指定します。 ``bin/fess.in.sh`` は、このディレクトリの外にある OpenSearch を探しません。
    * - ``--version <version>``
      - 導入する OpenSearch のバージョンです。プラグインも同じバージョンで導入されます。
+   * - ``--keep-bundled-plugins``
+     - 同梱プラグイン（ ``opensearch-security-analytics`` 、 ``opensearch-performance-analyzer`` ）を削除せず、配布物のまま残します。
 
 OpenSearch の公式配布は Linux 向けと Windows 向けだけです。macOS などほかのプラットフォームでは、何もダウンロードせずに終了コード ``1`` で終了し、Homebrew で OpenSearch を導入して ``install opensearch-plugins`` でプラグインを入れる方法か、Docker を使う方法を案内します。
 

ko/15.9/install/fess-setup.rst

@@ -35,13 +35,15 @@ install opensearch
 
 ::
 
-    $ bin/fess-setup install opensearch [--dest <dir>] [--version <version>]
+    $ bin/fess-setup install opensearch [--dest <dir>] [--version <version>] [--keep-bundled-plugins]
 
 이 |Fess| 가 지원하는 버전의 OpenSearch 를 |Fess| 디렉터리의 ``opensearch/`` 에 다운로드하고, |Fess| 가 필요로 하는 4개의 플러그인( ``opensearch-analysis-fess`` , ``opensearch-analysis-extension`` , ``opensearch-minhash`` , ``opensearch-configsync`` )을 설치한 다음, 해당 OpenSearch 의 ``config/opensearch.yml`` 에 다음 설정을 추가합니다.
 
 - ``configsync.config_path`` (값은 해당 OpenSearch 의 ``config/dictionary`` 디렉터리)
 - ``plugins.security.disabled: true``
 
+또한 |Fess| 가 사용하지 않는 번들 플러그인 ``opensearch-security-analytics`` 와 ``opensearch-performance-analyzer`` 를 제거합니다. Docker 이미지의 OpenSearch 와 같은 구성입니다. 배포본에 포함되지 않은 플러그인은 건너뜁니다.
+
 ``opensearch.yml`` 에 이미 있는 설정은 다시 추가하지 않으며, ``plugins.security.*`` 설정이 하나라도 있으면 ``plugins.security.disabled: true`` 를 추가하지 않습니다. OpenSearch 디렉터리가 이미 있으면 다운로드를 건너뛰므로, 기존 설치에 대해 다시 실행하면 부족한 설정만 추가됩니다.
 
 명령은 추가한 설정을 표시한 다음, ``bin/fess.in.sh`` 가 이 OpenSearch 를 자동으로 찾을 수 있는지 표시합니다. |Fess| 디렉터리의 ``opensearch/`` 아래에서 ``config/dictionary`` 디렉터리를 가진 OpenSearch 가 이것 하나뿐이면 찾을 수 있습니다. 이때 ``bin/fess.in.sh`` (Windows 에서는 ``bin\fess.in.bat`` )가 ``FESS_DICTIONARY_PATH`` 를 그 디렉터리로 설정하므로, 같은 호스트에서 실행하는 OpenSearch 라면 그 밖의 설정은 필요하지 않습니다. 찾을 수 없으면 설정해야 할 ``SEARCH_ENGINE_HTTP_URL`` 과 ``FESS_DICTIONARY_PATH`` 값을 표시합니다. 설정 방법은 :doc:`install-linux` 또는 :doc:`install-windows` 를 참조하십시오.
@@ -56,6 +58,8 @@ install opensearch
      - OpenSearch 를 압축 해제할 디렉터리를 |Fess| 디렉터리의 ``opensearch/`` 대신 지정합니다. ``bin/fess.in.sh`` 는 이 디렉터리 밖에 있는 OpenSearch 를 찾지 않습니다.
    * - ``--version <version>``
      - 설치할 OpenSearch 버전입니다. 플러그인도 같은 버전으로 설치됩니다.
+   * - ``--keep-bundled-plugins``
+     - 번들 플러그인( ``opensearch-security-analytics`` , ``opensearch-performance-analyzer`` )을 제거하지 않고 배포본 그대로 둡니다.
 
 OpenSearch 공식 배포판은 Linux 용과 Windows 용뿐입니다. macOS 등 그 밖의 플랫폼에서는 아무것도 다운로드하지 않고 종료 코드 ``1`` 로 종료하며, Homebrew 로 OpenSearch 를 설치하고 ``install opensearch-plugins`` 로 플러그인을 넣는 방법 또는 Docker 를 사용하는 방법을 안내합니다.
 

zh-cn/15.9/install/fess-setup.rst

@@ -35,13 +35,15 @@ install opensearch
 
 ::
 
-    $ bin/fess-setup install opensearch [--dest <dir>] [--version <version>]
+    $ bin/fess-setup install opensearch [--dest <dir>] [--version <version>] [--keep-bundled-plugins]
 
 将此 |Fess| 支持的 OpenSearch 版本下载到 |Fess| 目录下的 ``opensearch/`` 中，安装 |Fess| 所需的 4 个插件（\ ``opensearch-analysis-fess``\ 、\ ``opensearch-analysis-extension``\ 、\ ``opensearch-minhash`` 和 ``opensearch-configsync``\ ），并向其 ``config/opensearch.yml`` 追加以下配置：
 
 - ``configsync.config_path``\ ，其值为该 OpenSearch 的 ``config/dictionary`` 目录
 - ``plugins.security.disabled: true``
 
+此外，还会删除 |Fess| 不使用的内置插件 ``opensearch-security-analytics`` 和 ``opensearch-performance-analyzer``，与 Docker 镜像中的 OpenSearch 配置相同。下载包中不包含的插件会被跳过。
+
 ``opensearch.yml`` 中已有的配置不会重复追加；如果该文件中存在任何 ``plugins.security.*`` 配置，则不会追加 ``plugins.security.disabled: true``\ 。OpenSearch 目录已存在时会跳过下载，因此对已有的安装再次运行该命令时，只会追加缺少的配置。
 
 命令会显示追加的每项配置，然后显示 ``bin/fess.in.sh`` 能否自动找到此 OpenSearch。当它是 |Fess| 目录下 ``opensearch/`` 中唯一带有 ``config/dictionary`` 目录的 OpenSearch 时即可找到：此时 ``bin/fess.in.sh``\ （Windows 上为 ``bin\fess.in.bat``\ ）会将 ``FESS_DICTIONARY_PATH`` 设置为该目录，对于在同一主机上运行的 OpenSearch，无需其他配置。否则，命令会显示需要设置的 ``SEARCH_ENGINE_HTTP_URL`` 和 ``FESS_DICTIONARY_PATH`` 的值，设置方法请参阅 :doc:`install-linux` 或 :doc:`install-windows`\ 。
@@ -56,6 +58,8 @@ install opensearch
      - 指定 OpenSearch 的解压目录，以代替 |Fess| 目录下的 ``opensearch/``\ 。\ ``bin/fess.in.sh`` 不会在该目录之外查找 OpenSearch。
    * - ``--version <version>``
      - 要安装的 OpenSearch 版本。插件也会以相同版本安装。
+   * - ``--keep-bundled-plugins``
+     - 保留内置插件（\ ``opensearch-security-analytics``\ 、\ ``opensearch-performance-analyzer``\ ），不删除，保持下载包原样。
 
 OpenSearch 仅为 Linux 和 Windows 发布官方发行版。在 macOS 等其他平台上，该命令不会下载任何内容，而是以退出码 ``1`` 结束，并建议使用 Homebrew 安装 OpenSearch 后通过 ``install opensearch-plugins`` 添加插件，或者使用 Docker。