Warning: These installation instructions do not apply to Flow Enterprise on-premises version 2020.2.2 or later.
The Replicated installation script outlined in Installing Replicated will install Docker for you in most scenarios. However, if you are an airgapped customer, or you have specific versioning needs (like enterprise versions), you will need to install Docker manually.
There are two types of Docker that can be used: the Community Edition (which is recommended) and the Enterprise Edition. You can find out more about these in Docker's help center. For each of these types, there are multiple ways of installing the engines. We recommend that you use the methods that supply package repositories to your servers.
Installation of Docker is outside the scope of this wiki and is very well documented by Docker here. You can find OS and version specific installations at:
- Community Edition Installations
- Enterprise Edition Installations
These documents are incredibly detailed and will help you get a running docker engine. You can then carry on installing Replicated and Flow enterprise using the instructions found in Installing Replicated. However, there are a few OS specific notes and tips that we have accumulated. These are discussed below.
Some customers have experienced issues with docker and replicated running inside their network. In these cases the Docker Swarm cluster seems to not be active, according to the Replicated console. We have discovered that this issue is usually due to the docker bridge network conflicting with the network that the host server is running inside.
If you are running the host server in a network with a CIDR of 10.0.0.0/16, it is almost certain you will have this conflict. You can read more about the issue here.
To remedy this issue, you should pre-created the replicated network by executing the following command:
docker network create -d overlay --ip-range 172.31.0.0/16 --subnet 172.31.0.0/16 replicated_default
RedHat Enterprise Linux
As stated in Preparing RedHat Enterprise Linux, Flow Enterprise requires the use of RedHat Enterprise Linux version 7 and above. We have found that the best method for working with RHEL is to not use the airgapped method if at all possible. The Replicated script does an excellent job of setting up the Community Edition of Docker on a server and saves a lot of detailed, complicated work. However, if you require the Enterprise Edition, here are some pointers for you:
- Very few storage drivers are supported by RHEL 7, so you MUST use devicemapper. However, this takes extra steps. Here are some important links:
- Before installing docker, attach a separate block device to the server. This block device will be used to setup the storage driver for RHEL and Docker, as outlined here. We highly recommend that you make this block device 16GB or above.
- You must follow the steps for installing the device-mapper-driver.
- Install Replicated only after you have completed these steps.
If you need help, please email email@example.com for 24/7 assistance.