It is time to say goodbye: This version of Elastic Cloud Enterprise has reached end-of-life (EOL) and is no longer supported.
The documentation for this version is no longer being maintained. If you are running this version, we strongly advise you to upgrade. For the latest information, see the current release documentation.
Software prerequisites
editSoftware prerequisites
editTo install ECE, make sure you prepare your environment with the following software. Pay special attention to what Linux kernel and Docker versions you plan to use and follow our recommendations. Our testing has shown that not all software combinations work well together.
Supported Linux kernel
editElastic Cloud Enterprise requires 3.10 or higher, except between 4.4.156 and 4.9. To check your kernel version, run uname -r.
Kernel-LT has a regression on 4.4.156. See Limitations and known problems if your OS uses this version.
Linux distributions with compatible Docker versions
editECE requires one of the following Linux distributions, in combination with the compatible Docker version:
Operating system |
Docker |
Ubuntu 16.04 LTS (Xenial Xerus) |
18.09.9 |
Ubuntu 18.04 LTS (Bionic Beaver) |
19.03.13 |
Red Hat Enterprise Linux 7 (RHEL 7) |
1.131 |
Red Hat Enterprise Linux 8 (RHEL 8) |
19.03.132 |
CentOS 7 |
18.09.9 |
CentOS 8 |
19.03.132 |
SUSE Linux Enterprise Server (SLES) 12 |
docker-18.09.7_ce-98.43.1 |
1 Docker 1.13 is from the project atomic, which is maintained by RHEL.
2 For Red Hat Enterprise Linux 8 and CentOS 8, use the lastest version of Docker 19.
-
Check your operating system:
cat /etc/os-release
-
Check whether Docker is installed and its version is compatible with ECE:
docker --version
If you use Docker 1.12 or later, you must use only Linux kernel 4.5 or later. If you experience issues with these Docker and Linux kernel versions, move to supported versions.
Elastic Cloud Enterprise does not support Amazon Linux.
Free RAM
editECE requires at least 8GB of free RAM. Check how much free memory you have:
free -h
XFS
editXFS is required if you want to use disk space quotas for Elasticsearch data directories.
Disk space quotas set a limit on the amount of disk space an Elasticsearch 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.
-
On RHEL and CentOS, XFS file systems must be created with the
-n ftype=1option to make sure they can work with the OverlayFS storage driver used by Docker. - If SELinux is enabled, your SELinux configuration must allow mounting Docker sockets into containers (required for deployment management to work)