Ubuntu 16.04 LTS (Xenial Xerus)

Refresh the package index files from their sources:

sudo apt-get update

Install the Linux kernel and the xfsprogs package available on your system. You can omit the xfsprogs package if you don’t plan to use XFS.

sudo apt-get install -y linux-generic-lts-xenial xfsprogs

Add the Docker repository:

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo \
     apt-key add -
sudo apt-get update

Verify that you have the key with the 9DC8 5822 9FC7 DD38 854A E2D8 8D81 803C 0EBF CD88 fingerprint.

sudo apt-key fingerprint 0EBFCD88
...
pub   4096R/0EBFCD88 2017-02-22
      Key fingerprint = 9DC8 5822 9FC7 DD38 854A  E2D8 8D81 803C 0EBF CD88
uid                  Docker Release (CE deb) <docker@docker.com>
sub   4096R/F273FCD8 2017-02-22
...

Add the stable docker repository:

sudo add-apt-repository \
   "deb [arch=amd64] https://download.docker.com/linux/ubuntu \
   $(lsb_release -cs) \
   stable"

Install the correct version of the docker-ce package:

sudo apt-get install docker-ce=5:18.09.2*

Format the partition:

sudo mkfs.xfs /dev/xvdg1

Create the /mnt/data/ directory as a mount point:

sudo install -o $USER -g $USER -d -m 700 /mnt/data

Add an entry to the /etc/fstab file for the new XFS volume. The default filesystem path used by Elastic Cloud Enterprise is /mnt/data.

/dev/xvdg1	/mnt/data	xfs	defaults,nofail,x-systemd.automount,prjquota,pquota  0 2

Regenerate the mount files:

sudo systemctl daemon-reload
sudo systemctl restart local-fs.target

Stop the Docker service:

sudo systemctl stop docker

Enable cgroup accounting for memory and swap space.

If you plan to run Elasticsearch 5.0 and later: Update the /etc/sysctl.conf file to set the maximum number of mapped memory areas a process can have:

echo "vm.max_map_count=262144" | sudo tee -a /etc/sysctl.conf

Verify that IPv4 forwarding is enabled:

cat /proc/sys/net/ipv4/ip_forward

If the output of this command is not 1, you must enable IPv4 forwarding so that Docker can work as expected:

Adjust the system limits.

Add the following configuration values to the /etc/security/limits.conf file. These values are derived from our experience with the Elastic Cloud hosted offering and should be used for Elastic Cloud Enterprise as well.

*                soft    nofile         1024000
*                hard    nofile         1024000
*                soft    memlock        unlimited
*                hard    memlock        unlimited
elastic          soft    nofile         1024000
elastic          hard    nofile         1024000
elastic          soft    memlock        unlimited
elastic          hard    memlock        unlimited
root             soft    nofile         1024000
root             hard    nofile         1024000
root             soft    memlock        unlimited

If you did not create the mount point earlier (if you did not set up XFS), create the /mnt/data/ directory as a mount point:

sudo install -o $USER -g $USER -d -m 700 /mnt/data

If you set up a new device with XFS earlier:

Create the /mnt/data/docker directory for the Docker service storage:

sudo install -o $USER -g $USER -d -m 700 /mnt/data/docker

Update /etc/systemd/system/docker.service.d/docker.conf. If the file path and file do not exist, create them first.

[Unit]
Description=Docker Service
After=multi-user.target

[Service]
Environment="DOCKER_OPTS=-H unix:///run/docker.sock --data-root /mnt/data/docker --storage-driver=aufs --bip=172.17.42.1/16 --raw-logs"
ExecStart=
ExecStart=/usr/bin/dockerd $DOCKER_OPTS

Apply the updated Docker daemon configuration:

Reload the Docker daemon configuration:

sudo systemctl daemon-reload

Restart the Docker service:

sudo systemctl restart docker

Enable Docker to start on boot:

sudo systemctl enable docker

Enable your user to communicate with the Docker subsystem by adding it to the docker group:

sudo usermod -aG docker $USER

Recommended: Tune your network settings.

Create a 70-cloudenterprise.conf file in the /etc/sysctl.d/ file path that includes these network settings:

cat << SETTINGS | sudo tee /etc/sysctl.d/70-cloudenterprise.conf
net.ipv4.tcp_max_syn_backlog=65536
net.core.somaxconn=32768
net.core.netdev_max_backlog=32768
SETTINGS

Pin the Docker version to ensure that the package does not get upgraded:

echo "docker-ce hold" | sudo dpkg --set-selections

Reboot your system to ensure that all configuration changes take effect:

sudo reboot

After rebooting, verify that your Docker settings persist as expected:

sudo docker info | grep Root

If the command returns Docker Root Dir: /mnt/data/docker, then your changes were applied successfully and persist as expected.

If the command returns Docker Root Dir: /var/lib/docker, then you need to troubleshoot the previous configuration steps until the Docker settings are applied successfully before continuing with the installation process. For more information, see Custom Docker daemon options in the Docker documentation.