You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
(This is the 2nd try of previously wrongly raised PR -
#1620)
## Description
Previously we specify Ubuntu (Operating system / OS) version directly
like 20.04 or 22.04.
However, we later also 24.04, and maybe in the future we will have even
more versions.
All the compatible and supported version could be found in our support
matrix - https://www.elastic.co/support/matrix#elastic-cloud-enterprise.
But writing the version directly to public doc page other than support
matrix seems to be easily forgotten to update, and thus we are left
behind in public doc page that it does not mention 24.04 now.
=> This causes confusion on users, because it's telling different in
between public ECE docs and support matrix.
This was brought up by @rheppe in an internal discussion
[here](https://elastic.slack.com/archives/C045W6699NH/p1748919036870519?thread_ts=1748559251.195289&cid=C045W6699NH).
The rationale is that support matrix is the source of truth, per what we
have confirmed with @Kushmaro. So we would like to update the public
docs based on support matrix.
## Additional Notes
- We removed note `Docker 25 and higher are not compatible with ECE
3.7.` because the current branch of docs is for ECE 4.0, and we can see
from support matrix, it's supported.
- We also explicitly mentioned that, the command mentioned in `sudo apt
install -y docker-ce=5:24.0.* docker-ce-cli=5:24.0.* containerd.io` is
just an example of install Docker 24.0 on Ubuntu. We added this because
per support matrix, ECE 4.0 also supports other docker versions, and we
can see from the screenshots below, it's hard to make an exclusive list
in the public doc page, thus it makes more logical sense to say "it's a
command example".
<img width="1728" alt="image"
src="https://github.com/user-attachments/assets/ca2f0c00-427c-46cf-b2fe-05e69a527e90"
/>
## Before / After PR merge
### Before
<img width="1225" alt="image"
src="https://github.com/user-attachments/assets/94ff5f0d-136d-4382-935c-0bba1252ef6d"
/>
### After
No 20.04 or 22.04 version number present
<img width="1359" alt="image"
src="https://github.com/user-attachments/assets/76ad92e3-a439-467a-8f19-75547c8910ba"
/>
---------
Co-authored-by: Edu González de la Herrán <[email protected]>
Copy file name to clipboardExpand all lines: deploy-manage/deploy/cloud-enterprise/configure-host-rhel.md
+6-5Lines changed: 6 additions & 5 deletions
Original file line number
Diff line number
Diff line change
@@ -12,13 +12,10 @@ products:
12
12
13
13
# Configure a RHEL host [ece-configure-hosts-rhel-centos]
14
14
15
-
16
-
17
15
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.
18
16
19
17
*[Prerequisites](#ece-prerequisites-rhel8)
20
-
*[Configure the host](#ece-configure-hosts-rhel8-podman)
21
-
18
+
*[Install Podman and configure the host](#ece-configure-hosts-rhel8-podman)
22
19
23
20
## Prerequisites [ece-prerequisites-rhel8]
24
21
@@ -28,7 +25,11 @@ Verify that required traffic is allowed. Check the [Networking prerequisites](ec
28
25
29
26
**Example:** For AWS, allowing traffic between hosts is implemented using security groups.
30
27
31
-
## Configure the host [ece-configure-hosts-rhel8-podman]
28
+
::::{important}
29
+
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.
30
+
::::
31
+
32
+
## Install Podman and configure the host [ece-configure-hosts-rhel8-podman]
32
33
33
34
1. Install the OS packages `lvm2`, `iptables`, `sysstat`, and `net-tools` by executing:
Copy file name to clipboardExpand all lines: deploy-manage/deploy/cloud-enterprise/configure-host-suse.md
+5-6Lines changed: 5 additions & 6 deletions
Original file line number
Diff line number
Diff line change
@@ -12,10 +12,10 @@ products:
12
12
13
13
# Configure a SUSE host [ece-configure-hosts-sles12]
14
14
15
-
The following instructions show you how to prepare your hosts on SLES 12 SP5 or 15.
15
+
The following instructions explain how to prepare your hosts on SUSE Linux Enterprise Server 12 SP5 (SLES 12) or 15 (SLES 15).
16
16
17
17
*[Install Docker](#ece-install-docker-sles12)
18
-
*[Set up XFS on SLES](#ece-xfs-setup-sles12)
18
+
*[Set up XFS quotas](#ece-xfs-setup-sles12)
19
19
*[Update the configurations settings](#ece-update-config-sles)
20
20
*[Configure the Docker daemon options](#ece-configure-docker-daemon-sles12)
21
21
@@ -26,11 +26,10 @@ If you want to install {{ece}} (ECE) on your own hosts, the steps for preparing
26
26
27
27
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.
28
28
29
-
30
-
## Install Docker [ece-install-docker-sles12]
29
+
## Install Docker on SLES [ece-install-docker-sles12]
31
30
32
31
::::{important}
33
-
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.
32
+
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.
34
33
::::
35
34
36
35
@@ -87,7 +86,7 @@ Make sure to use a combination of Linux distribution and Docker version that is
87
86
88
87
89
88
90
-
## Set up XFS on SLES [ece-xfs-setup-sles12]
89
+
## Set up XFS quotas [ece-xfs-setup-sles12]
91
90
92
91
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.
*[Update the configurations settings](#ece-update-config-ubuntu)
20
20
*[Configure the Docker daemon options](#ece-configure-docker-daemon-ubuntu)
21
21
22
22
23
-
## Install Docker [ece-install-docker-ubuntu]
23
+
## Install Docker on Ubuntu [ece-install-docker-ubuntu]
24
24
25
-
Install Docker LTS version 24.0 for Ubuntu 20.04 or 22.04.
25
+
Install a compatible Docker version on Ubuntu.
26
26
27
27
::::{important}
28
-
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.
29
-
::::
30
-
31
-
32
-
::::{note}
33
-
Docker 25 and higher are not compatible with ECE 3.7.
28
+
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.
34
29
::::
35
30
36
31
@@ -55,10 +50,10 @@ Docker 25 and higher are not compatible with ECE 3.7.
55
50
$(lsb_release -cs) stable"| sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
56
51
```
57
52
58
-
4. Install the correct version of the `docker-ce` package, for Ubuntu 20.04 LTS (Focal Fossa) or Ubuntu 22.04 LTS (Jammy Jellyfish):
53
+
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.
*[Red Hat Enterprise Linux (RHEL) 8 and 9](configure-host-rhel.md)
18
-
*[Rocky Linux 8 and 9](configure-host-rhel.md)
19
-
*[SUSE Linux Enterprise Server (SLES) 12 SP5 and 15](configure-host-suse.md)
16
+
*[Ubuntu](configure-host-ubuntu.md)
17
+
*[Red Hat Enterprise Linux (RHEL) and Rocky Linux](configure-host-rhel.md)
18
+
*[SUSE Linux Enterprise Server (SLES)](configure-host-suse.md)
19
+
20
+
::::{important}
21
+
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.
0 commit comments