From 6a11c3ff00c1b9b9cfe753ceea359d3c126a999f Mon Sep 17 00:00:00 2001 From: Kuni Sen Date: Thu, 5 Jun 2025 19:24:55 +0900 Subject: [PATCH 1/7] Update configure-host-ubuntu.md --- .../deploy/cloud-enterprise/configure-host-ubuntu.md | 11 +++-------- 1 file changed, 3 insertions(+), 8 deletions(-) diff --git a/deploy-manage/deploy/cloud-enterprise/configure-host-ubuntu.md b/deploy-manage/deploy/cloud-enterprise/configure-host-ubuntu.md index 845de74371..86dddff0a5 100644 --- a/deploy-manage/deploy/cloud-enterprise/configure-host-ubuntu.md +++ b/deploy-manage/deploy/cloud-enterprise/configure-host-ubuntu.md @@ -12,7 +12,7 @@ products: # Configure an Ubuntu host [ece-configure-hosts-ubuntu] -The following instructions show you how to prepare your hosts on 20.04 LTS (Focal Fossa) and Ubuntu 22.04 LTS (Jammy Jellyfish). +The following instructions show you how to prepare your hosts on Ubuntu. * [Install Docker 24.0](#ece-install-docker-ubuntu) * [Set up XFS quotas](#ece-xfs-setup-ubuntu) @@ -22,18 +22,13 @@ The following instructions show you how to prepare your hosts on 20.04 LTS (Foca ## Install Docker [ece-install-docker-ubuntu] -Install Docker LTS version 24.0 for Ubuntu 20.04 or 22.04. +Install the compatible Docker version on Ubuntu. ::::{important} Make sure to use a combination of Linux distribution and Docker version that is supported, following our official [Support matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise). Using unsupported combinations can cause multiple issues with you ECE environment, such as failures to create system deployments, to upgrade workload deployments, proxy timeouts, and more. :::: -::::{note} -Docker 25 and higher are not compatible with ECE 3.7. -:::: - - 1. Install the Docker repository dependencies: ```sh @@ -55,7 +50,7 @@ Docker 25 and higher are not compatible with ECE 3.7. $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null ``` -4. Install the correct version of the `docker-ce` package, for Ubuntu 20.04 LTS (Focal Fossa) or Ubuntu 22.04 LTS (Jammy Jellyfish): +4. Install the correct version of the `docker-ce` package. Following is an example of installing Docker 24.0. If you decide to install a different Docker version, make sure to replace with the desired version in the commands below. ```sh sudo apt install -y docker-ce=5:24.0.* docker-ce-cli=5:24.0.* containerd.io From 6be52e553cbeeb89a2c110130bc1386d1d25f6e2 Mon Sep 17 00:00:00 2001 From: Kuni Sen <30574753+kunisen@users.noreply.github.com> Date: Fri, 6 Jun 2025 15:05:23 +0900 Subject: [PATCH 2/7] Update deploy-manage/deploy/cloud-enterprise/configure-host-ubuntu.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Edu González de la Herrán <25320357+eedugon@users.noreply.github.com> --- deploy-manage/deploy/cloud-enterprise/configure-host-ubuntu.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/deploy-manage/deploy/cloud-enterprise/configure-host-ubuntu.md b/deploy-manage/deploy/cloud-enterprise/configure-host-ubuntu.md index 86dddff0a5..94061d6407 100644 --- a/deploy-manage/deploy/cloud-enterprise/configure-host-ubuntu.md +++ b/deploy-manage/deploy/cloud-enterprise/configure-host-ubuntu.md @@ -50,7 +50,7 @@ Make sure to use a combination of Linux distribution and Docker version that is $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null ``` -4. Install the correct version of the `docker-ce` package. Following is an example of installing Docker 24.0. If you decide to install a different Docker version, make sure to replace with the desired version in the commands below. +4. Install the correct version of the `docker-ce` package. The following is an example of installing Docker 24.0. If you decide to install a different Docker version, make sure to replace with the desired version in the commands below. ```sh sudo apt install -y docker-ce=5:24.0.* docker-ce-cli=5:24.0.* containerd.io From 982968c5eb87b226f45361d2ce4f97dfc9097f11 Mon Sep 17 00:00:00 2001 From: Kuni Sen <30574753+kunisen@users.noreply.github.com> Date: Fri, 6 Jun 2025 15:19:33 +0900 Subject: [PATCH 3/7] Update deploy-manage/deploy/cloud-enterprise/configure-host-ubuntu.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Edu González de la Herrán <25320357+eedugon@users.noreply.github.com> --- deploy-manage/deploy/cloud-enterprise/configure-host-ubuntu.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/deploy-manage/deploy/cloud-enterprise/configure-host-ubuntu.md b/deploy-manage/deploy/cloud-enterprise/configure-host-ubuntu.md index 94061d6407..577a798d16 100644 --- a/deploy-manage/deploy/cloud-enterprise/configure-host-ubuntu.md +++ b/deploy-manage/deploy/cloud-enterprise/configure-host-ubuntu.md @@ -14,7 +14,7 @@ products: The following instructions show you how to prepare your hosts on Ubuntu. -* [Install Docker 24.0](#ece-install-docker-ubuntu) +* [Install Docker](#ece-install-docker-ubuntu) * [Set up XFS quotas](#ece-xfs-setup-ubuntu) * [Update the configurations settings](#ece-update-config-ubuntu) * [Configure the Docker daemon options](#ece-configure-docker-daemon-ubuntu) From a1c5ca3c37c92b45f4b851002089cfd10be909aa Mon Sep 17 00:00:00 2001 From: Kuni Sen Date: Fri, 6 Jun 2025 15:22:43 +0900 Subject: [PATCH 4/7] Make it more version agnostic https://github.com/elastic/docs-content/pull/1621#issuecomment-2944323710 --- .../deploy/cloud-enterprise/configure-host-ubuntu.md | 4 ++-- .../deploy/cloud-enterprise/configure-operating-system.md | 7 +++---- 2 files changed, 5 insertions(+), 6 deletions(-) diff --git a/deploy-manage/deploy/cloud-enterprise/configure-host-ubuntu.md b/deploy-manage/deploy/cloud-enterprise/configure-host-ubuntu.md index 577a798d16..a926591c7d 100644 --- a/deploy-manage/deploy/cloud-enterprise/configure-host-ubuntu.md +++ b/deploy-manage/deploy/cloud-enterprise/configure-host-ubuntu.md @@ -50,10 +50,10 @@ Make sure to use a combination of Linux distribution and Docker version that is $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null ``` -4. Install the correct version of the `docker-ce` package. The following is an example of installing Docker 24.0. If you decide to install a different Docker version, make sure to replace with the desired version in the commands below. +4. Install the correct version of the `docker-ce` package. The following is an example of installing Docker 27.0. If you decide to install a different Docker version, make sure to replace with the desired version in the commands below. ```sh - sudo apt install -y docker-ce=5:24.0.* docker-ce-cli=5:24.0.* containerd.io + sudo apt install -y docker-ce=5:27.0.* docker-ce-cli=5:27.0.* containerd.io ``` diff --git a/deploy-manage/deploy/cloud-enterprise/configure-operating-system.md b/deploy-manage/deploy/cloud-enterprise/configure-operating-system.md index 6d5d4005aa..dc1054ac69 100644 --- a/deploy-manage/deploy/cloud-enterprise/configure-operating-system.md +++ b/deploy-manage/deploy/cloud-enterprise/configure-operating-system.md @@ -13,7 +13,6 @@ products: Before installing {{ece}}, you have to prepare your hosts with one of the following Linux distributions: -* [Ubuntu 20.04 LTS (Focal Fossa) and Ubuntu 22.04 LTS (Jammy Jellyfish)](configure-host-ubuntu.md) -* [Red Hat Enterprise Linux (RHEL) 8 and 9](configure-host-rhel.md) -* [Rocky Linux 8 and 9](configure-host-rhel.md) -* [SUSE Linux Enterprise Server (SLES) 12 SP5 and 15](configure-host-suse.md) +* [Ubuntu)](configure-host-ubuntu.md) +* [Red Hat Enterprise Linux (RHEL) and Rocky Linux](configure-host-rhel.md) +* [SUSE Linux Enterprise Server (SLES)](configure-host-suse.md) From 9a63e6d585755f9f9e02a94cdf0f5a15f8cc3fdd Mon Sep 17 00:00:00 2001 From: Kuni Sen Date: Fri, 6 Jun 2025 15:28:51 +0900 Subject: [PATCH 5/7] Update configure-operating-system.md --- .../deploy/cloud-enterprise/configure-operating-system.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/deploy-manage/deploy/cloud-enterprise/configure-operating-system.md b/deploy-manage/deploy/cloud-enterprise/configure-operating-system.md index dc1054ac69..1d8068919e 100644 --- a/deploy-manage/deploy/cloud-enterprise/configure-operating-system.md +++ b/deploy-manage/deploy/cloud-enterprise/configure-operating-system.md @@ -13,6 +13,6 @@ products: Before installing {{ece}}, you have to prepare your hosts with one of the following Linux distributions: -* [Ubuntu)](configure-host-ubuntu.md) +* [Ubuntu](configure-host-ubuntu.md) * [Red Hat Enterprise Linux (RHEL) and Rocky Linux](configure-host-rhel.md) * [SUSE Linux Enterprise Server (SLES)](configure-host-suse.md) From 6f4559ea94a40472b89396f30d7adcb65b698123 Mon Sep 17 00:00:00 2001 From: Kuni Sen Date: Sat, 7 Jun 2025 14:18:09 +0900 Subject: [PATCH 6/7] add note to RHEL about using compatible container engine https://github.com/elastic/docs-content/pull/1621#issuecomment-2948902729 --- deploy-manage/deploy/cloud-enterprise/configure-host-rhel.md | 5 +++++ deploy-manage/deploy/cloud-enterprise/configure-host-suse.md | 2 +- .../deploy/cloud-enterprise/configure-host-ubuntu.md | 2 +- .../deploy/cloud-enterprise/configure-operating-system.md | 5 +++++ 4 files changed, 12 insertions(+), 2 deletions(-) diff --git a/deploy-manage/deploy/cloud-enterprise/configure-host-rhel.md b/deploy-manage/deploy/cloud-enterprise/configure-host-rhel.md index 8222c4d4de..e93cbfa88a 100644 --- a/deploy-manage/deploy/cloud-enterprise/configure-host-rhel.md +++ b/deploy-manage/deploy/cloud-enterprise/configure-host-rhel.md @@ -28,6 +28,11 @@ Verify that required traffic is allowed. Check the [Networking prerequisites](ec **Example:** For AWS, allowing traffic between hosts is implemented using security groups. +::::{important} +Make sure to use a combination of Linux distribution and Container Engine version that is supported, following our official [Support matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise). Using unsupported combinations can cause multiple issues with you ECE environment, such as failures to create system deployments, to upgrade workload deployments, proxy timeouts, and more. +:::: + + ## Configure the host [ece-configure-hosts-rhel8-podman] 1. Install the OS packages `lvm2`, `iptables`, `sysstat`, and `net-tools` by executing: diff --git a/deploy-manage/deploy/cloud-enterprise/configure-host-suse.md b/deploy-manage/deploy/cloud-enterprise/configure-host-suse.md index 76cebbe808..6e3772d9a3 100644 --- a/deploy-manage/deploy/cloud-enterprise/configure-host-suse.md +++ b/deploy-manage/deploy/cloud-enterprise/configure-host-suse.md @@ -30,7 +30,7 @@ Regardless of which approach you take, the steps in this section need to be perf ## Install Docker [ece-install-docker-sles12] ::::{important} -Make sure to use a combination of Linux distribution and Docker version that is supported, following our official [Support matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise). Using unsupported combinations can cause multiple issues with you ECE environment, such as failures to create system deployments, to upgrade workload deployments, proxy timeouts, and more. +Make sure to use a combination of Linux distribution and Container Engine version that is supported, following our official [Support matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise). Using unsupported combinations can cause multiple issues with you ECE environment, such as failures to create system deployments, to upgrade workload deployments, proxy timeouts, and more. :::: diff --git a/deploy-manage/deploy/cloud-enterprise/configure-host-ubuntu.md b/deploy-manage/deploy/cloud-enterprise/configure-host-ubuntu.md index a926591c7d..e15084d96f 100644 --- a/deploy-manage/deploy/cloud-enterprise/configure-host-ubuntu.md +++ b/deploy-manage/deploy/cloud-enterprise/configure-host-ubuntu.md @@ -25,7 +25,7 @@ The following instructions show you how to prepare your hosts on Ubuntu. Install the compatible Docker version on Ubuntu. ::::{important} -Make sure to use a combination of Linux distribution and Docker version that is supported, following our official [Support matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise). Using unsupported combinations can cause multiple issues with you ECE environment, such as failures to create system deployments, to upgrade workload deployments, proxy timeouts, and more. +Make sure to use a combination of Linux distribution and Container Engine version that is supported, following our official [Support matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise). Using unsupported combinations can cause multiple issues with you ECE environment, such as failures to create system deployments, to upgrade workload deployments, proxy timeouts, and more. :::: diff --git a/deploy-manage/deploy/cloud-enterprise/configure-operating-system.md b/deploy-manage/deploy/cloud-enterprise/configure-operating-system.md index 1d8068919e..478f9ad1c0 100644 --- a/deploy-manage/deploy/cloud-enterprise/configure-operating-system.md +++ b/deploy-manage/deploy/cloud-enterprise/configure-operating-system.md @@ -11,6 +11,11 @@ products: # Configure your operating system [ece-configure-os] +::::{important} +Make sure to use a combination of Linux distribution and Container Engine version that is supported, following our official [Support matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise). Using unsupported combinations can cause multiple issues with you ECE environment, such as failures to create system deployments, to upgrade workload deployments, proxy timeouts, and more. +:::: + + Before installing {{ece}}, you have to prepare your hosts with one of the following Linux distributions: * [Ubuntu](configure-host-ubuntu.md) From 81d928e34afcda5de71693dcfcaef104c1834ca6 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Edu=20Gonz=C3=A1lez=20de=20la=20Herr=C3=A1n?= <25320357+eedugon@users.noreply.github.com> Date: Wed, 11 Jun 2025 11:24:54 +0200 Subject: [PATCH 7/7] final refinements --- .../deploy/cloud-enterprise/configure-host-rhel.md | 10 +++------- .../deploy/cloud-enterprise/configure-host-suse.md | 11 +++++------ .../deploy/cloud-enterprise/configure-host-ubuntu.md | 6 +++--- .../cloud-enterprise/configure-operating-system.md | 9 ++++----- 4 files changed, 15 insertions(+), 21 deletions(-) diff --git a/deploy-manage/deploy/cloud-enterprise/configure-host-rhel.md b/deploy-manage/deploy/cloud-enterprise/configure-host-rhel.md index e93cbfa88a..3712de130a 100644 --- a/deploy-manage/deploy/cloud-enterprise/configure-host-rhel.md +++ b/deploy-manage/deploy/cloud-enterprise/configure-host-rhel.md @@ -12,13 +12,10 @@ products: # Configure a RHEL host [ece-configure-hosts-rhel-centos] - - The following instructions show you how to prepare your hosts on Red Hat Enterprise Linux 8 (RHEL 8), 9 (RHEL 9), and Rocky Linux 8 and 9. * [Prerequisites](#ece-prerequisites-rhel8) -* [Configure the host](#ece-configure-hosts-rhel8-podman) - +* [Install Podman and configure the host](#ece-configure-hosts-rhel8-podman) ## Prerequisites [ece-prerequisites-rhel8] @@ -29,11 +26,10 @@ Verify that required traffic is allowed. Check the [Networking prerequisites](ec **Example:** For AWS, allowing traffic between hosts is implemented using security groups. ::::{important} -Make sure to use a combination of Linux distribution and Container Engine version that is supported, following our official [Support matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise). Using unsupported combinations can cause multiple issues with you ECE environment, such as failures to create system deployments, to upgrade workload deployments, proxy timeouts, and more. +Make sure to use a supported combination of Linux distribution and container engine version as defined in our official [Support matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise). Unsupported combinations can lead to various issues in your ECE environment, including failures when creating system deployments, upgrading workload deployments, proxy timeouts, and more. :::: - -## Configure the host [ece-configure-hosts-rhel8-podman] +## Install Podman and configure the host [ece-configure-hosts-rhel8-podman] 1. Install the OS packages `lvm2`, `iptables`, `sysstat`, and `net-tools` by executing: diff --git a/deploy-manage/deploy/cloud-enterprise/configure-host-suse.md b/deploy-manage/deploy/cloud-enterprise/configure-host-suse.md index 6e3772d9a3..c1406fe68d 100644 --- a/deploy-manage/deploy/cloud-enterprise/configure-host-suse.md +++ b/deploy-manage/deploy/cloud-enterprise/configure-host-suse.md @@ -12,10 +12,10 @@ products: # Configure a SUSE host [ece-configure-hosts-sles12] -The following instructions show you how to prepare your hosts on SLES 12 SP5 or 15. +The following instructions explain how to prepare your hosts on SUSE Linux Enterprise Server 12 SP5 (SLES 12) or 15 (SLES 15). * [Install Docker](#ece-install-docker-sles12) -* [Set up XFS on SLES](#ece-xfs-setup-sles12) +* [Set up XFS quotas](#ece-xfs-setup-sles12) * [Update the configurations settings](#ece-update-config-sles) * [Configure the Docker daemon options](#ece-configure-docker-daemon-sles12) @@ -26,11 +26,10 @@ If you want to install {{ece}} (ECE) on your own hosts, the steps for preparing Regardless of which approach you take, the steps in this section need to be performed on every host that you want to use with ECE. - -## Install Docker [ece-install-docker-sles12] +## Install Docker on SLES [ece-install-docker-sles12] ::::{important} -Make sure to use a combination of Linux distribution and Container Engine version that is supported, following our official [Support matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise). Using unsupported combinations can cause multiple issues with you ECE environment, such as failures to create system deployments, to upgrade workload deployments, proxy timeouts, and more. +Make sure to use a supported combination of Linux distribution and container engine version as defined in our official [Support matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise). Unsupported combinations can lead to various issues in your ECE environment, including failures when creating system deployments, upgrading workload deployments, proxy timeouts, and more. :::: @@ -87,7 +86,7 @@ Make sure to use a combination of Linux distribution and Container Engine versio -## Set up XFS on SLES [ece-xfs-setup-sles12] +## Set up XFS quotas [ece-xfs-setup-sles12] XFS is required to support disk space quotas for {{es}} data directories. Some Linux distributions such as RHEL and Rocky Linux already provide XFS as the default file system. On SLES 12 and 15, you need to set up an XFS file system and have quotas enabled. diff --git a/deploy-manage/deploy/cloud-enterprise/configure-host-ubuntu.md b/deploy-manage/deploy/cloud-enterprise/configure-host-ubuntu.md index e15084d96f..c89a7a5133 100644 --- a/deploy-manage/deploy/cloud-enterprise/configure-host-ubuntu.md +++ b/deploy-manage/deploy/cloud-enterprise/configure-host-ubuntu.md @@ -20,12 +20,12 @@ The following instructions show you how to prepare your hosts on Ubuntu. * [Configure the Docker daemon options](#ece-configure-docker-daemon-ubuntu) -## Install Docker [ece-install-docker-ubuntu] +## Install Docker on Ubuntu [ece-install-docker-ubuntu] -Install the compatible Docker version on Ubuntu. +Install a compatible Docker version on Ubuntu. ::::{important} -Make sure to use a combination of Linux distribution and Container Engine version that is supported, following our official [Support matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise). Using unsupported combinations can cause multiple issues with you ECE environment, such as failures to create system deployments, to upgrade workload deployments, proxy timeouts, and more. +Make sure to use a supported combination of Linux distribution and container engine version as defined in our official [Support matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise). Unsupported combinations can lead to various issues in your ECE environment, including failures when creating system deployments, upgrading workload deployments, proxy timeouts, and more. :::: diff --git a/deploy-manage/deploy/cloud-enterprise/configure-operating-system.md b/deploy-manage/deploy/cloud-enterprise/configure-operating-system.md index 478f9ad1c0..566623ccab 100644 --- a/deploy-manage/deploy/cloud-enterprise/configure-operating-system.md +++ b/deploy-manage/deploy/cloud-enterprise/configure-operating-system.md @@ -11,13 +11,12 @@ products: # Configure your operating system [ece-configure-os] -::::{important} -Make sure to use a combination of Linux distribution and Container Engine version that is supported, following our official [Support matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise). Using unsupported combinations can cause multiple issues with you ECE environment, such as failures to create system deployments, to upgrade workload deployments, proxy timeouts, and more. -:::: - - Before installing {{ece}}, you have to prepare your hosts with one of the following Linux distributions: * [Ubuntu](configure-host-ubuntu.md) * [Red Hat Enterprise Linux (RHEL) and Rocky Linux](configure-host-rhel.md) * [SUSE Linux Enterprise Server (SLES)](configure-host-suse.md) + +::::{important} +Make sure to use a supported combination of Linux distribution and container engine version, such as `Docker` or `Podman`, as defined in our official [Support matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise). Unsupported combinations can lead to various issues in your ECE environment, including failures when creating system deployments, upgrading workload deployments, proxy timeouts, and more. +:::: \ No newline at end of file