Software prerequisitesedit

To 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 kerneledit

Elastic 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 versionsedit

ECE 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.

  1. Check your operating system:

    cat /etc/os-release
  2. 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 RAMedit

ECE requires at least 8GB of free RAM. Check how much free memory you have:

free -h

XFSedit

XFS 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=1 option 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)