Software prerequisites

edit

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.

Linux distributions and Docker

edit

Use 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.12

Red Hat Enterprise Linux 7 (RHEL 7)

1.131

Red Hat Enterprise Linux 8 (RHEL 8)

192

CentOS 7

18.09.9

CentOS 8

192

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.

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.

XFS

edit

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)