Skip to main content

Brainspace

Install Docker

Installing Docker will be a little different based on the Linux distribution chosen but should be straightforward using the appropriate Linux package manager.

To install Docker Community Edition, refer to: https://docs.docker.com/engine/install/

Note

If installing onto Redhat 8/9, use the instructions for CentOS. Additionally, only the 'docker-ce' package needs to be installed, the other packages are optional.

To install a paid and supported version of Docker Swarm, refer to: https://www.mirantis.com/software/swarm/

The following ports must be available and allowed in the network according to the Docker Swarm docs:

  • Port 2377 TCP for communication with and between manager nodes

  • Port 7946 TCP/UDP for overlay network node discovery

  • Port 4789 UDP (configurable) for overlay network traffic

    • Ensure IP protocol 50 (IPSec ESP) traffic is allowed.

Important

-> Very Important

If uninstalling the Docker Engine from an existing environment for any reason, do NOT follow the instructions to delete the /var/lib/docker directory (instructions for Ubuntu, for example: https://docs.docker.com/engine/install/ubuntu/#uninstall-docker-engine).

When you set up a Docker volume for an NFS share, it creates a mount point down in /var/lib/docker. This means if you have set up a Docker volume for the NFS data/localdata shares and you run the command to delete that directory, it will also delete the entire Brainspace dataset, and all data contained in those shares.

You must unmount those shares under /var/lib/docker prior to deleting the contents of that directory.