From 0c6f626f16784c2229348d81586dc0db73649d3a Mon Sep 17 00:00:00 2001 From: Ralf Schmid Date: Thu, 25 Jun 2026 13:17:14 +0200 Subject: [PATCH 1/3] Adjusted supported ES versions; removed ingest plugin; adjusted instructions --- appendix/proxy.rst | 5 ++- .../connect-configure-elasticsearch.rst | 13 ++------ install/elasticsearch/troubleshooting.rst | 33 ++----------------- install/update.rst | 5 --- prerequisites/software.rst | 23 ++++++------- 5 files changed, 16 insertions(+), 63 deletions(-) diff --git a/appendix/proxy.rst b/appendix/proxy.rst index 309a0763..0016f5d2 100644 --- a/appendix/proxy.rst +++ b/appendix/proxy.rst @@ -52,8 +52,7 @@ NO_PROXY ES_JAVA_OPTS Variable for setting a proxy for Elasticsearch. By default, Elasticsearch does not communicate to external systems during the operation. However, - there can be cases where this is needed, for example when downloading the - ingest plugin for Elasticsearch versions below 8. Example: + there can be cases where this is needed. Example: .. code-block:: sh @@ -80,7 +79,7 @@ configuration): :header: "Address", "Comment" :widths: 40, 70 - "artifacts.elastic.co", "Download of the ingest plugin (only ES < 8)" + "artifacts.elastic.co", "Download of optional plugins" "dl.packager.io", "Download of OS package (package installation)" "go.packager.io", "As above; new package hosting service" "geo.zammad.com", "Used for geo data" diff --git a/install/elasticsearch/connect-configure-elasticsearch.rst b/install/elasticsearch/connect-configure-elasticsearch.rst index a6b82679..3586d660 100644 --- a/install/elasticsearch/connect-configure-elasticsearch.rst +++ b/install/elasticsearch/connect-configure-elasticsearch.rst @@ -20,20 +20,11 @@ commands, as this will fail otherwise. Elasticsearch URL Set the Elasticsearch server address; adapt it to your scenario. - Elasticsearch 7: - - .. code-block:: console - - $ zammad run rails r "Setting.set('es_url', 'http://localhost:9200')" - - Elasticsearch 8 and newer: - .. code-block:: console $ zammad run rails r "Setting.set('es_url', 'https://localhost:9200')" - -Elasticsearch user and password (Elasticsearch 8 and newer) +Elasticsearch user and password Now you need your password which was shown during the installation. Set Elasticsearch user: @@ -51,7 +42,7 @@ Elasticsearch user and password (Elasticsearch 8 and newer) $ zammad run rails r "Setting.set('es_password', '')" -Add certificate to Zammad (Elasticsearch 8 and newer) +Add certificate to Zammad Add it via **Rails console**: In case you are installing a new Zammad and didn't run through the getting started wizard already, add the certificate via console: diff --git a/install/elasticsearch/troubleshooting.rst b/install/elasticsearch/troubleshooting.rst index 44b08a6b..84571c5f 100644 --- a/install/elasticsearch/troubleshooting.rst +++ b/install/elasticsearch/troubleshooting.rst @@ -22,7 +22,7 @@ If you are experiencing this issue and installed Elasticsearch according to :doc:`/install/elasticsearch`, please follow these steps to make sure Elasticsearch is working correctly. -Step 1: Verify Elasticsearch is running +Verify Elasticsearch is running Check Elasticsearch status: .. code-block:: console @@ -57,36 +57,7 @@ Step 1: Verify Elasticsearch is running | Try completely purging and reinstalling Elasticsearch according to :doc:`/install/elasticsearch` - -Step 2: Verify the ingest-attachment plugin is installed correctly - List installed Elasticsearch plugins: - - .. code-block:: console - - $ /usr/share/elasticsearch/bin/elasticsearch-plugin list - - The output should include ``ingest-attachment``. - - Otherwise, try reinstalling the ``ingest-attachment`` plugin and check - again: - - .. code-block:: console - - $ /usr/share/elasticsearch/bin/elasticsearch-plugin remove ingest-attachment - - .. code-block:: console - - $ /usr/share/elasticsearch/bin/elasticsearch-plugin install ingest-attachment - - .. code-block:: console - - $ sudo systemctl restart elasticsearch - - .. code-block:: console - - $ /usr/share/elasticsearch/bin/elasticsearch-plugin list - -Step 3: Verify Zammad can access Elasticsearch and rebuild the indexes +Verify Zammad can access Elasticsearch and rebuild the indexes Without specifying CPU cores to use: .. code-block:: console diff --git a/install/update.rst b/install/update.rst index 8ea4d010..9dcdbdab 100644 --- a/install/update.rst +++ b/install/update.rst @@ -149,11 +149,6 @@ using `Zammad hosting`_ for your and your customers' safety. `documentation `_ and follow the instructions. - In case your are using plugins for Elasticsearch, make sure they are - updated as well (note: starting with Elasticsearch 8, the - ingest-attachment is no longer a plugin, it's now included in - Elasticsearch). - Step 6: Rebuild Elasticsearch index (optional) Only needed if the release note tells you to rebuild the Elasticsearch index. diff --git a/prerequisites/software.rst b/prerequisites/software.rst index c1669f86..157b4bf2 100644 --- a/prerequisites/software.rst +++ b/prerequisites/software.rst @@ -217,19 +217,16 @@ system gets. :header: "Zammad", "Elasticsearch" :widths: 20, 20 - "7.0+", ">= 7.8, < 10" - "5.2 - 6.5", ">= 7.8, < 9" - "5.0 - 5.1", ">= 7.8, < 8" - "4.0-4.1", ">= 6.5, <= 7.12" - "3.4-3.6", ">= 5.5, <= 7.9" - "3.3", ">= 2.4, <=7.6" - "3.2", ">= 2.4, <=7.5" - "3.1", ">= 2.4, <=7.4" - "2.0-3.0", ">= 2.4, <=5.6" - -An Elasticsearch plugin is required for version 7 or older to index the -contents of email attachments: ``ingest-attachment``. Starting with -Elasticsearch 8, it is included by default. + "7.2+", ">= 8.0, < 10" + "7.0 - 7.1", ">= 7.8, < 10" + "5.2 - 6.5", ">= 7.8, < 9" + "5.0 - 5.1", ">= 7.8, < 8" + "4.0-4.1", ">= 6.5, <= 7.12" + "3.4-3.6", ">= 5.5, <= 7.9" + "3.3", ">= 2.4, <=7.6" + "3.2", ">= 2.4, <=7.5" + "3.1", ">= 2.4, <=7.4" + "2.0-3.0", ">= 2.4, <=5.6" .. hint:: You can override the Elasticsearch dependency for package installations (not recommended!) From 5560e8128de6c4c83207704b86f8f4aa14654109 Mon Sep 17 00:00:00 2001 From: Ralf Schmid Date: Thu, 25 Jun 2026 14:42:38 +0200 Subject: [PATCH 2/3] 8 > 8.11 --- prerequisites/software.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/prerequisites/software.rst b/prerequisites/software.rst index 157b4bf2..0d810ac9 100644 --- a/prerequisites/software.rst +++ b/prerequisites/software.rst @@ -217,7 +217,7 @@ system gets. :header: "Zammad", "Elasticsearch" :widths: 20, 20 - "7.2+", ">= 8.0, < 10" + "7.2+", ">= 8.11, < 10" "7.0 - 7.1", ">= 7.8, < 10" "5.2 - 6.5", ">= 7.8, < 9" "5.0 - 5.1", ">= 7.8, < 8" From e13be0acc81ce42def8bcca56710ff08fadb3e1f Mon Sep 17 00:00:00 2001 From: Ralf Schmid Date: Thu, 25 Jun 2026 14:46:03 +0200 Subject: [PATCH 3/3] Removed Elasticsearch artifacts URL --- appendix/proxy.rst | 1 - 1 file changed, 1 deletion(-) diff --git a/appendix/proxy.rst b/appendix/proxy.rst index 0016f5d2..5a9478a4 100644 --- a/appendix/proxy.rst +++ b/appendix/proxy.rst @@ -79,7 +79,6 @@ configuration): :header: "Address", "Comment" :widths: 40, 70 - "artifacts.elastic.co", "Download of optional plugins" "dl.packager.io", "Download of OS package (package installation)" "go.packager.io", "As above; new package hosting service" "geo.zammad.com", "Used for geo data"