From 8b2d08d49462f46db9576fa239aab12750884862 Mon Sep 17 00:00:00 2001 From: Marci W <333176+marciw@users.noreply.github.com> Date: Wed, 20 May 2026 19:15:10 -0400 Subject: [PATCH 1/5] Refine ECE SUSE host configuration page Rewrite the SUSE host configuration page to address GitHub issue docs-content-internal#24: drop the unsupported Docker 24.0.7 examples, flag SLES 12 SP5 EOL, and label commands as examples that should be cross-checked against the Support matrix. Extract the Docker version into a shared ece-docker-version substitution so the Ubuntu and SUSE pages stay in sync. Reword the intros on all three sibling pages (RHEL, SUSE, Ubuntu) so they diverge enough to be indexed independently by search engines. Replace the deprecated `service network restart` with `systemctl restart NetworkManager`. Co-Authored-By: Claude Opus 4.7 (1M context) --- .../cloud-enterprise/configure-host-rhel.md | 2 +- .../cloud-enterprise/configure-host-suse.md | 81 +++++++++---------- .../cloud-enterprise/configure-host-ubuntu.md | 8 +- docset.yml | 1 + 4 files changed, 42 insertions(+), 50 deletions(-) diff --git a/deploy-manage/deploy/cloud-enterprise/configure-host-rhel.md b/deploy-manage/deploy/cloud-enterprise/configure-host-rhel.md index ea7eece91b..565a49231c 100644 --- a/deploy-manage/deploy/cloud-enterprise/configure-host-rhel.md +++ b/deploy-manage/deploy/cloud-enterprise/configure-host-rhel.md @@ -12,7 +12,7 @@ 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. +Red Hat Enterprise Linux 8 and 9, along with Rocky Linux 8 and 9, run {{ece}} on Podman rather than Docker. The procedure below installs Podman with `dnf`, configures the Podman socket so the standard `docker` CLI works against it, and applies the SELinux, XFS, and kernel tuning that ECE expects on Red Hat-family hosts. * [Prerequisites](#ece-prerequisites-rhel8) * [Install Podman and configure the host](#ece-configure-hosts-rhel8-podman) diff --git a/deploy-manage/deploy/cloud-enterprise/configure-host-suse.md b/deploy-manage/deploy/cloud-enterprise/configure-host-suse.md index a918cc18d5..343e2f5620 100644 --- a/deploy-manage/deploy/cloud-enterprise/configure-host-suse.md +++ b/deploy-manage/deploy/cloud-enterprise/configure-host-suse.md @@ -12,79 +12,77 @@ products: # Configure a SUSE host [ece-configure-hosts-sles12] -The following instructions explain how to prepare your hosts on SUSE Linux Enterprise Server 12 SP5 (SLES 12) or 15 (SLES 15). +SUSE Linux Enterprise Server (SLES) hosts use `zypper` to install Docker and require XFS quotas to be set up manually, since SLES doesn't ship XFS as the default filesystem. The procedure below covers both SLES 12 SP5 and SLES 15, but note that SLES 12 SP5 reached general support end of life in October 2024 — new {{ece}} installations should target SLES 15. + +Always cross-check your SLES version and Docker version against the [Support matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise) before installing. The commands shown on this page are examples; substitute the versions you've selected from the support matrix. * [Install Docker](#ece-install-docker-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) -If you want to install {{ece}} (ECE) on your own hosts, the steps for preparing your hosts can take a bit of time. There are two ways you can approach this: - -* **Think like a minimalist**: [Install the correct version of Docker](#ece-install-docker-sles12) on hosts that meet the [prerequisites](prepare-environment.md) for ECE, then skip ahead and [install ECE](install.md#install-ece). Be aware that some checks during the installation can fail with this approach, which will mean doing further host preparation work before retrying the installation. -* **Cover your bases**: If you want to make absolutely sure that your installation of {{ece}} can succeed on hosts that meet the [prerequisites](prepare-environment.md), or if any of the checks during the installation failed previously, run through the full preparation steps in this section and then and [install ECE](install.md#install-ece). You’ll do a bit more work now, but life will be simpler later on. - -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 on SLES [ece-install-docker-sles12] ::::{include} /deploy-manage/deploy/_snippets/ece-supported-combinations.md :::: +::::{warning} +SLES 12 SP5 reached general support end of life on **October 31, 2024**. New {{ece}} deployments should target SLES 15. Existing SLES 12 SP5 hosts should be migrated to a supported SLES 15 release. +:::: -1. Remove Docker and previously installed podman packages (if previously installed). +1. Remove Docker and any previously installed podman packages (if previously installed). ```sh sudo zypper remove -y docker docker-ce podman podman-remote ``` -2. Update packages to the latest available versions +2. Update packages to the latest available versions. ```sh sudo zypper refresh sudo zypper update -y ``` -3. Install Docker and other required packages: +3. Install Docker and other required packages. The following commands are examples of installing Docker {{ece-docker-version}}. If you decide to install a different Docker version, replace `{{ece-docker-version}}` with the desired version from the [Support matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise). - * For SLES 12: + * For SLES 15: ```sh - sudo zypper install -y docker=24.0.7_ce-98.109.3 + sudo zypper install -y curl device-mapper lvm2 net-tools docker={{ece-docker-version}}.* ``` - * For SLES 15: + * For SLES 12 SP5 (EOL — only use on existing deployments): ```sh - sudo zypper install -y curl device-mapper lvm2 net-tools docker=24.0.7_ce-150000.198.2 net-tools + sudo zypper install -y docker={{ece-docker-version}}.* ``` -4. Disable nscd, as it interferes with Elastic’s services: - - ```sh - sudo systemctl stop nscd - sudo systemctl disable nscd - ``` + ::::{tip} + If `zypper` reports that the requested Docker version isn't available, ensure that the SUSE **Containers Module** is enabled (`sudo SUSEConnect -p sle-module-containers/15./x86_64`) or refer to SUSE's documentation for adding the upstream Docker repository. + :::: +4. Set up the OS groups and add your user. + 1. Create the `elastic` and `docker` groups if they don't already exist: -## Set up OS groups and user [ece_set_up_os_groups_and_user] + ```sh + sudo groupadd elastic + sudo groupadd docker + ``` -1. If they don’t already exist, create the following OS groups: + 2. Add the user to both groups: - ```sh - sudo groupadd elastic - sudo groupadd docker - ``` + ```sh + sudo usermod -aG elastic,docker $USER + ``` -2. Add the user to these groups: +5. Disable nscd, as it interferes with Elastic's services: ```sh - sudo usermod -aG elastic,docker $USER + sudo systemctl stop nscd + sudo systemctl disable nscd ``` - - ## 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. @@ -95,12 +93,10 @@ Disk space quotas set a limit on the amount of disk space an {{es}} cluster node Using LVM, `mdadm`, or a combination of the two for block device management is possible, but the configuration is not covered here, nor is it provided as part of supporting ECE. :::: - ::::{important} -You must use XFS and have quotas enabled on all allocators, otherwise disk usage won’t display correctly. +You must use XFS and have quotas enabled on all allocators, otherwise disk usage won't display correctly. :::: - **Example:** Set up XFS on a single, pre-partitioned block device named `/dev/xvdg1`. Replace `/dev/xvdg1` in the following example with the corresponding device on your host. 1. Format the partition: @@ -127,8 +123,6 @@ You must use XFS and have quotas enabled on all allocators, otherwise disk usage sudo mount -a ``` - - ## Update the configurations settings [ece-update-config-sles] 1. Stop the Docker service: @@ -151,7 +145,7 @@ You must use XFS and have quotas enabled on all allocators, otherwise disk usage sudo update-bootloader ``` -3. Configure kernel parameters +3. Configure kernel parameters. ```sh cat < @@ -266,7 +257,7 @@ You must use XFS and have quotas enabled on all allocators, otherwise disk usage } ``` -2. The user installing ECE must have a User ID (UID) and Group ID (GID) of 1000 or higher. Make sure that the GID matches the ID of the `elastic`` group created earlier (likely to be 1000). You can set this using the following command: +2. The user installing ECE must have a User ID (UID) and Group ID (GID) of 1000 or higher. Make sure that the GID matches the ID of the `elastic` group created earlier (likely to be 1000). You can set this using the following command: ```sh sudo usermod -g $USER @@ -311,7 +302,7 @@ You must use XFS and have quotas enabled on all allocators, otherwise disk usage According to [{{es}} networking settings](elasticsearch://reference/elasticsearch/configuration-reference/networking-settings.md), {{es}} overrides TCP keepalive settings at the socket level for its own connections: * If system-level values exceed 300 seconds, {{es}} automatically lowers them to 300 seconds. * Values below 300 seconds are used as-is. - + For non-{{es}} connections such as the proxy layer, consider reducing the following TCP keepalive parameters to detect stale network sessions and prevent firewalls from dropping silent connections: * `net.ipv4.tcp_keepalive_time` * `net.ipv4.tcp_keepalive_intvl` @@ -319,7 +310,7 @@ You must use XFS and have quotas enabled on all allocators, otherwise disk usage ::: - 1. Ensure settings in /etc/sysctl.d/*.conf are applied on boot + 1. Ensure settings in /etc/sysctl.d/*.conf are applied on boot: ```sh SCRIPT_LOCATION="/var/lib/cloud/scripts/per-boot/00-load-sysctl-settings" diff --git a/deploy-manage/deploy/cloud-enterprise/configure-host-ubuntu.md b/deploy-manage/deploy/cloud-enterprise/configure-host-ubuntu.md index a1f4812985..cd27846a8b 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 Ubuntu. +Use the following workflow to ready an Ubuntu server for {{ece}} (ECE). The steps install Docker from the upstream Docker `apt` repository, set up an XFS volume for cluster data, tune kernel and systemd parameters for production workloads, and pin the Docker version so unattended upgrades don't break ECE. * [Install Docker](#ece-install-docker-ubuntu) * [Set up XFS quotas](#ece-xfs-setup-ubuntu) @@ -22,7 +22,7 @@ The following instructions show you how to prepare your hosts on Ubuntu. ## Install Docker on Ubuntu [ece-install-docker-ubuntu] -Install a compatible Docker version on Ubuntu. +Install a compatible Docker version on Ubuntu using `apt`. ::::{include} /deploy-manage/deploy/_snippets/ece-supported-combinations.md :::: @@ -49,10 +49,10 @@ Install a compatible Docker version on Ubuntu. $(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 27.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 {{ece-docker-version}}. If you decide to install a different Docker version, make sure to replace with the desired version in the commands below. ```sh - sudo apt update && sudo apt install -y docker-ce=5:27.0.* docker-ce-cli=5:27.0.* containerd.io + sudo apt update && sudo apt install -y docker-ce=5:{{ece-docker-version}}.* docker-ce-cli=5:{{ece-docker-version}}.* containerd.io ``` diff --git a/docset.yml b/docset.yml index 5ecf676ed5..d852c933a2 100644 --- a/docset.yml +++ b/docset.yml @@ -93,6 +93,7 @@ subs: ecloud: "Elastic Cloud" ech: "Elastic Cloud Hosted" ece: "Elastic Cloud Enterprise" + ece-docker-version: "27.0" eck: "Elastic Cloud on Kubernetes" edot: "Elastic Distribution of OpenTelemetry" motlp: "Elastic Cloud Managed OTLP Endpoint" From f499b6ba5f1c67f267ea76ab57e08d9b2db420c9 Mon Sep 17 00:00:00 2001 From: Marci W <333176+marciw@users.noreply.github.com> Date: Thu, 21 May 2026 12:01:40 -0400 Subject: [PATCH 2/5] Drop SLES 12 SP5 install commands; remove SUSE network restart MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Follow-up to the SUSE refinement: SLES 12 SP5 is EOL, so the page now targets SLES 15 only with a note pointing migrators at the last SUSE- shipped Docker for SLES 12 SP5. Also drop `sudo systemctl restart NetworkManager` from the sysctl apply step — that's the wrong command for SUSE (default network manager is wicked, not NetworkManager), and the network restart isn't actually needed after `sysctl -p` for the parameters being set here. Link the SUSE Docker installation doc instead of half-documenting the SUSEConnect command. Co-Authored-By: Claude Opus 4.7 (1M context) --- .../cloud-enterprise/configure-host-suse.md | 27 ++++++++----------- 1 file changed, 11 insertions(+), 16 deletions(-) diff --git a/deploy-manage/deploy/cloud-enterprise/configure-host-suse.md b/deploy-manage/deploy/cloud-enterprise/configure-host-suse.md index 343e2f5620..14627dc939 100644 --- a/deploy-manage/deploy/cloud-enterprise/configure-host-suse.md +++ b/deploy-manage/deploy/cloud-enterprise/configure-host-suse.md @@ -12,7 +12,7 @@ products: # Configure a SUSE host [ece-configure-hosts-sles12] -SUSE Linux Enterprise Server (SLES) hosts use `zypper` to install Docker and require XFS quotas to be set up manually, since SLES doesn't ship XFS as the default filesystem. The procedure below covers both SLES 12 SP5 and SLES 15, but note that SLES 12 SP5 reached general support end of life in October 2024 — new {{ece}} installations should target SLES 15. +SUSE Linux Enterprise Server (SLES) hosts use `zypper` to install Docker and require XFS quotas to be set up manually, since SLES doesn't ship XFS as the default filesystem. The procedure below targets SLES 15. SLES 12 SP5 reached general support end of life in October 2024 — new {{ece}} installations should use SLES 15, and existing SLES 12 SP5 hosts should be migrated. Always cross-check your SLES version and Docker version against the [Support matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise) before installing. The commands shown on this page are examples; substitute the versions you've selected from the support matrix. @@ -43,22 +43,18 @@ SLES 12 SP5 reached general support end of life on **October 31, 2024**. New {{e sudo zypper update -y ``` -3. Install Docker and other required packages. The following commands are examples of installing Docker {{ece-docker-version}}. If you decide to install a different Docker version, replace `{{ece-docker-version}}` with the desired version from the [Support matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise). +3. Install Docker and other required packages on SLES 15. The following command is an example of installing Docker {{ece-docker-version}}. If you decide to install a different Docker version, replace `{{ece-docker-version}}` with the desired version from the [Support matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise). - * For SLES 15: - - ```sh - sudo zypper install -y curl device-mapper lvm2 net-tools docker={{ece-docker-version}}.* - ``` - - * For SLES 12 SP5 (EOL — only use on existing deployments): - - ```sh - sudo zypper install -y docker={{ece-docker-version}}.* - ``` + ```sh + sudo zypper install -y curl device-mapper lvm2 net-tools docker={{ece-docker-version}}.* + ``` ::::{tip} - If `zypper` reports that the requested Docker version isn't available, ensure that the SUSE **Containers Module** is enabled (`sudo SUSEConnect -p sle-module-containers/15./x86_64`) or refer to SUSE's documentation for adding the upstream Docker repository. + If `zypper` reports that the requested Docker version isn't available, ensure that the SUSE **Containers Module** is enabled, or refer to [SUSE's documentation](https://documentation.suse.com/sles/15-SP6/html/SLES-all/cha-docker-installation.html) for adding the upstream Docker repository. + :::: + + ::::{note} + Installation on SLES 12 SP5 is no longer covered here because SLES 12 SP5 is past general support end of life. If you're maintaining an existing SLES 12 SP5 deployment, install the last Docker version that SUSE shipped for SLES 12 SP5 and plan a migration to SLES 15. :::: 4. Set up the OS groups and add your user. @@ -85,7 +81,7 @@ SLES 12 SP5 reached general support end of life on **October 31, 2024**. New {{e ## 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. +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 15, you need to set up an XFS file system and have quotas enabled. Disk space quotas set a limit on the amount of disk space an {{es}} cluster node can use. Currently, quotas are calculated by a static ratio of 1:32, which means that for every 1 GB of RAM a cluster is given, a cluster node is allowed to consume 32 GB of disk space. @@ -169,7 +165,6 @@ You must use XFS and have quotas enabled on all allocators, otherwise disk usage ```sh sudo sysctl -p - sudo systemctl restart NetworkManager ``` 4. Adjust the system limits. From e359cc59cd2d0d078bf40c036b9a49d325629574 Mon Sep 17 00:00:00 2001 From: Marci W <333176+marciw@users.noreply.github.com> Date: Thu, 21 May 2026 17:25:47 -0400 Subject: [PATCH 3/5] claude still can't quite write --- .../cloud-enterprise/configure-host-rhel.md | 2 +- .../cloud-enterprise/configure-host-suse.md | 27 ++++++++++--------- .../cloud-enterprise/configure-host-ubuntu.md | 4 +-- 3 files changed, 18 insertions(+), 15 deletions(-) diff --git a/deploy-manage/deploy/cloud-enterprise/configure-host-rhel.md b/deploy-manage/deploy/cloud-enterprise/configure-host-rhel.md index 565a49231c..889d74a5f3 100644 --- a/deploy-manage/deploy/cloud-enterprise/configure-host-rhel.md +++ b/deploy-manage/deploy/cloud-enterprise/configure-host-rhel.md @@ -12,7 +12,7 @@ products: # Configure a RHEL host [ece-configure-hosts-rhel-centos] -Red Hat Enterprise Linux 8 and 9, along with Rocky Linux 8 and 9, run {{ece}} on Podman rather than Docker. The procedure below installs Podman with `dnf`, configures the Podman socket so the standard `docker` CLI works against it, and applies the SELinux, XFS, and kernel tuning that ECE expects on Red Hat-family hosts. +Red Hat Enterprise Linux 8 and 9, along with Rocky Linux 8 and 9, run {{ece}} on Podman rather than Docker. Use these steps to install Podman with `dnf`; configure the Podman socket so the standard `docker` CLI works against it; and apply the SELinux, XFS, and kernel tuning that ECE expects on Red Hat-family hosts. * [Prerequisites](#ece-prerequisites-rhel8) * [Install Podman and configure the host](#ece-configure-hosts-rhel8-podman) diff --git a/deploy-manage/deploy/cloud-enterprise/configure-host-suse.md b/deploy-manage/deploy/cloud-enterprise/configure-host-suse.md index 14627dc939..c965f6a48a 100644 --- a/deploy-manage/deploy/cloud-enterprise/configure-host-suse.md +++ b/deploy-manage/deploy/cloud-enterprise/configure-host-suse.md @@ -12,9 +12,14 @@ products: # Configure a SUSE host [ece-configure-hosts-sles12] -SUSE Linux Enterprise Server (SLES) hosts use `zypper` to install Docker and require XFS quotas to be set up manually, since SLES doesn't ship XFS as the default filesystem. The procedure below targets SLES 15. SLES 12 SP5 reached general support end of life in October 2024 — new {{ece}} installations should use SLES 15, and existing SLES 12 SP5 hosts should be migrated. +SUSE Linux Enterprise Server (SLES) hosts use `zypper` to install Docker and require XFS quotas to be set up manually, since SLES doesn't ship XFS as the default filesystem. The steps on this page target SLES 15. + +Before installing, make sure to cross-check your SLES version and Docker version against the [Support matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise). The commands shown on this page are examples; substitute the versions you've identified in the support matrix. + +::::{warning} +SLES 12 SP5 reached general support end of life on **October 31, 2024**. Use SLES 15 or later for new {{ece}} installations, and migrate existing SLES 12 SP5 hosts. +:::: -Always cross-check your SLES version and Docker version against the [Support matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise) before installing. The commands shown on this page are examples; substitute the versions you've selected from the support matrix. * [Install Docker](#ece-install-docker-sles12) * [Set up XFS quotas](#ece-xfs-setup-sles12) @@ -26,11 +31,9 @@ Always cross-check your SLES version and Docker version against the [Support mat ::::{include} /deploy-manage/deploy/_snippets/ece-supported-combinations.md :::: -::::{warning} -SLES 12 SP5 reached general support end of life on **October 31, 2024**. New {{ece}} deployments should target SLES 15. Existing SLES 12 SP5 hosts should be migrated to a supported SLES 15 release. -:::: -1. Remove Docker and any previously installed podman packages (if previously installed). + +1. Remove Docker and any previously installed podman packages. ```sh sudo zypper remove -y docker docker-ce podman podman-remote @@ -43,15 +46,15 @@ SLES 12 SP5 reached general support end of life on **October 31, 2024**. New {{e sudo zypper update -y ``` -3. Install Docker and other required packages on SLES 15. The following command is an example of installing Docker {{ece-docker-version}}. If you decide to install a different Docker version, replace `{{ece-docker-version}}` with the desired version from the [Support matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise). +3. Install Docker and other required packages on SLES 15. The following command is an example of installing Docker {{ece-docker-version}}. To install a different Docker version, replace {{ece-docker-version}} with your preferred version from the [Support matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise). - ```sh + ```sh subs=true sudo zypper install -y curl device-mapper lvm2 net-tools docker={{ece-docker-version}}.* ``` ::::{tip} - If `zypper` reports that the requested Docker version isn't available, ensure that the SUSE **Containers Module** is enabled, or refer to [SUSE's documentation](https://documentation.suse.com/sles/15-SP6/html/SLES-all/cha-docker-installation.html) for adding the upstream Docker repository. - :::: + If `zypper` reports that the requested Docker version isn't available, make sure the SUSE **Containers Module** is enabled, or refer to [SUSE's documentation](https://documentation.suse.com/sles/15-SP6/html/SLES-all/cha-docker-installation.html) for adding the upstream Docker repository. + ::::s ::::{note} Installation on SLES 12 SP5 is no longer covered here because SLES 12 SP5 is past general support end of life. If you're maintaining an existing SLES 12 SP5 deployment, install the last Docker version that SUSE shipped for SLES 12 SP5 and plan a migration to SLES 15. @@ -72,7 +75,7 @@ SLES 12 SP5 reached general support end of life on **October 31, 2024**. New {{e sudo usermod -aG elastic,docker $USER ``` -5. Disable nscd, as it interferes with Elastic's services: +5. Disable `nscd`, which can interfere with Elastic services: ```sh sudo systemctl stop nscd @@ -90,7 +93,7 @@ Using LVM, `mdadm`, or a combination of the two for block device management is p :::: ::::{important} -You must use XFS and have quotas enabled on all allocators, otherwise disk usage won't display correctly. +You must use XFS and have quotas enabled on all allocators; otherwise, disk usage won't display correctly. :::: **Example:** Set up XFS on a single, pre-partitioned block device named `/dev/xvdg1`. Replace `/dev/xvdg1` in the following example with the corresponding device on your host. diff --git a/deploy-manage/deploy/cloud-enterprise/configure-host-ubuntu.md b/deploy-manage/deploy/cloud-enterprise/configure-host-ubuntu.md index cd27846a8b..02cc78a328 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] -Use the following workflow to ready an Ubuntu server for {{ece}} (ECE). The steps install Docker from the upstream Docker `apt` repository, set up an XFS volume for cluster data, tune kernel and systemd parameters for production workloads, and pin the Docker version so unattended upgrades don't break ECE. +Use the following workflow to ready an Ubuntu server for {{ece}} (ECE). These steps install Docker from the upstream Docker `apt` repository, set up an XFS volume for cluster data, tune kernel and systemd parameters for production workloads, and pin the Docker version so unattended upgrades don't break ECE. * [Install Docker](#ece-install-docker-ubuntu) * [Set up XFS quotas](#ece-xfs-setup-ubuntu) @@ -49,7 +49,7 @@ Install a compatible Docker version on Ubuntu using `apt`. $(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 {{ece-docker-version}}. 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 command is an example of installing Docker {{ece-docker-version}}. To install a different Docker version, replace {{ece-docker-version}} with your preferred version from the [Support matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise) ```sh sudo apt update && sudo apt install -y docker-ce=5:{{ece-docker-version}}.* docker-ce-cli=5:{{ece-docker-version}}.* containerd.io From 169525db0367d7dfaa84d5a1cc7bc2cd699e638f Mon Sep 17 00:00:00 2001 From: Marci W <333176+marciw@users.noreply.github.com> Date: Thu, 21 May 2026 17:32:00 -0400 Subject: [PATCH 4/5] Fix stray fence character and missing subs=true on Ubuntu install command Three small follow-ups from a fresh-eyes pass: - SUSE: remove stray `s` after the closing fence on the Containers Module tip. - Ubuntu: add the missing period at the end of the Docker example sentence. - Ubuntu: add `subs=true` to the `docker-ce` install code block so `{{ece-docker-version}}` resolves like it does in the SUSE block. Co-Authored-By: Claude Opus 4.7 (1M context) --- deploy-manage/deploy/cloud-enterprise/configure-host-suse.md | 2 +- .../deploy/cloud-enterprise/configure-host-ubuntu.md | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/deploy-manage/deploy/cloud-enterprise/configure-host-suse.md b/deploy-manage/deploy/cloud-enterprise/configure-host-suse.md index c965f6a48a..c0abcddfa4 100644 --- a/deploy-manage/deploy/cloud-enterprise/configure-host-suse.md +++ b/deploy-manage/deploy/cloud-enterprise/configure-host-suse.md @@ -54,7 +54,7 @@ SLES 12 SP5 reached general support end of life on **October 31, 2024**. Use SLE ::::{tip} If `zypper` reports that the requested Docker version isn't available, make sure the SUSE **Containers Module** is enabled, or refer to [SUSE's documentation](https://documentation.suse.com/sles/15-SP6/html/SLES-all/cha-docker-installation.html) for adding the upstream Docker repository. - ::::s + :::: ::::{note} Installation on SLES 12 SP5 is no longer covered here because SLES 12 SP5 is past general support end of life. If you're maintaining an existing SLES 12 SP5 deployment, install the last Docker version that SUSE shipped for SLES 12 SP5 and plan a migration to SLES 15. diff --git a/deploy-manage/deploy/cloud-enterprise/configure-host-ubuntu.md b/deploy-manage/deploy/cloud-enterprise/configure-host-ubuntu.md index 02cc78a328..3429a34a20 100644 --- a/deploy-manage/deploy/cloud-enterprise/configure-host-ubuntu.md +++ b/deploy-manage/deploy/cloud-enterprise/configure-host-ubuntu.md @@ -49,9 +49,9 @@ Install a compatible Docker version on Ubuntu using `apt`. $(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 command is an example of installing Docker {{ece-docker-version}}. To install a different Docker version, replace {{ece-docker-version}} with your preferred version from the [Support matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise) +4. Install the correct version of the `docker-ce` package. The following command is an example of installing Docker {{ece-docker-version}}. To install a different Docker version, replace {{ece-docker-version}} with your preferred version from the [Support matrix](https://www.elastic.co/support/matrix#elastic-cloud-enterprise). - ```sh + ```sh subs=true sudo apt update && sudo apt install -y docker-ce=5:{{ece-docker-version}}.* docker-ce-cli=5:{{ece-docker-version}}.* containerd.io ``` From 4816db1cc0cf1b9d0546593af120198c3dfa3ba8 Mon Sep 17 00:00:00 2001 From: Marci W <333176+marciw@users.noreply.github.com> Date: Thu, 21 May 2026 17:46:35 -0400 Subject: [PATCH 5/5] Update deploy-manage/deploy/cloud-enterprise/configure-host-ubuntu.md Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@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 3429a34a20..0959a6107d 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] -Use the following workflow to ready an Ubuntu server for {{ece}} (ECE). These steps install Docker from the upstream Docker `apt` repository, set up an XFS volume for cluster data, tune kernel and systemd parameters for production workloads, and pin the Docker version so unattended upgrades don't break ECE. +Use the steps on this page to prepare an Ubuntu server for {{ece}} (ECE): install Docker from the upstream Docker `apt` repository, set up an XFS volume for cluster data, tune kernel and systemd parameters for production workloads, and pin the Docker version so unattended upgrades don't break ECE. * [Install Docker](#ece-install-docker-ubuntu) * [Set up XFS quotas](#ece-xfs-setup-ubuntu)