diff --git a/source/administration-guide/scale/elasticsearch-setup.rst b/source/administration-guide/scale/elasticsearch-setup.rst index d49024540f0..737798ba554 100644 --- a/source/administration-guide/scale/elasticsearch-setup.rst +++ b/source/administration-guide/scale/elasticsearch-setup.rst @@ -13,7 +13,7 @@ Set up Elasticsearch We highly recommend that you set up Elasticsearch server on a dedicated machine separate from the Mattermost Server. -1. Download and install the latest release of `Elasticsearch v8 `_, or `Elasticsearch v7.17+ `_. See the Elasticsearch documentation for installation details. +1. Download and install the latest release of `Elasticsearch v9 `_ or `Elasticsearch v8 `_. See the Elasticsearch documentation for installation details. 2. Set up Elasticsearch with ``systemd`` by running the following commands: @@ -43,7 +43,7 @@ We highly recommend that you set up Elasticsearch server on a dedicated machine 6. In this file, replace the ``network.host`` value of ``_eth0_`` with your network interface name, and save your changes. -7. When using Elasticsearch v8, ensure you set ``action.destructive_requires_name`` to ``false`` in ``elasticsearch.yml`` to allow for wildcard operations to work. +7. Ensure you set ``action.destructive_requires_name`` to ``false`` in ``elasticsearch.yml`` to allow for wildcard operations to work. 8. Restart Elasticsearch by running the following commands: diff --git a/source/administration-guide/scale/enterprise-search.rst b/source/administration-guide/scale/enterprise-search.rst index b239b2cfff4..cbaaf1e3cad 100644 --- a/source/administration-guide/scale/enterprise-search.rst +++ b/source/administration-guide/scale/enterprise-search.rst @@ -37,9 +37,17 @@ Supported paths Review the following support paths for enterprise search based on the version you're using: +.. tab:: Elasticsearch v9 + + `Elasticsearch v9 `__ is supported from Mattermost v11.7. We recommend upgrading to Elasticsearch v9 for the latest features and security updates. See the `Elasticsearch upgrade `_ documentation for upgrade details, and see the :doc:`Elasticsearch setup ` documentation for details on configuring your Mattermost deployment to use Elasticsearch. + .. tab:: Elasticsearch v8 - `Elasticsearch v8 `__ is supported from Mattermost v9.11. While Mattermost supports Elasticsearch v7.17+, we recommend upgrading your Elasticsearch v7 instance to v8.x. See the `Elasticsearch upgrade `_ documentation for upgrade details, and see the :doc:`Elasticsearch setup ` documentation for details on configuring your Mattermost deployment to use Elasticsearch. + `Elasticsearch v8 `__ is supported from Mattermost v9.11. We recommend upgrading to Elasticsearch v9 for the latest features and security updates. See the `Elasticsearch upgrade `_ documentation for upgrade details, and see the :doc:`Elasticsearch setup ` documentation for details on configuring your Mattermost deployment to use Elasticsearch. + + .. note:: + + Elasticsearch v7.17 is no longer supported as of Mattermost v11.7. If you're still using Elasticsearch v7, you must upgrade to Elasticsearch v8 or v9. .. tab:: AWS OpenSearch Service @@ -49,7 +57,7 @@ Review the following support paths for enterprise search based on the version yo .. tab:: AWS Elasticsearch v7.10.x - If you're using Elasticsearch v7.10.x under AWS’s managed services, you can't use newer Elasticsearch clients like the v8 client without changing backend infrastructure. If you're using AWS Elasticsearch v7.10.x, you must `upgrade to AWS OpenSearch `_ for future compatibility. + If you're using Elasticsearch v7.10.x under AWS’s managed services, you can't use newer Elasticsearch clients like the v8 or v9 client without changing backend infrastructure. If you're using AWS Elasticsearch v7.10.x, you must `upgrade to AWS OpenSearch `_ for future compatibility. The migration path from Elasticsearch v7.10.x to OpenSearch has been designed to be straightforward, minimizing effort: diff --git a/source/deployment-guide/software-hardware-requirements.rst b/source/deployment-guide/software-hardware-requirements.rst index c29f79996ac..9a6489147b7 100644 --- a/source/deployment-guide/software-hardware-requirements.rst +++ b/source/deployment-guide/software-hardware-requirements.rst @@ -232,5 +232,5 @@ For Enterprise Edition deployments with a multi-server setup, we highly recommen - Prometheus to track system health of your Mattermost deployment, through :doc:`performance monitoring feature ` available in Mattermost Enterprise. - Grafana to visualize the system health metrics collected by Prometheus with the :doc:`performance monitoring feature `. Grafana 5.0.0 and later is recommended. -- Elasticsearch to support highly efficient database searches in a cluster environment. Elasticsearch v7.17+ is supported, and Elasticsearch v8.x or AWS OpenSearch is recommended from Mattermost v9.11. :doc:`Learn more `. +- Elasticsearch to support highly efficient database searches in a cluster environment. Elasticsearch v8.x and v9.x are supported, and Elasticsearch v9.x or AWS OpenSearch is recommended. :doc:`Learn more `. - AWS S3 or any S3-compatible service. Mattermost is compatible with object storage systems which implement the S3 API. You can also use local storage or a network drive using NFS. Learn more about file storage configuration options :ref:`in our documentation `.