There are two ways to install and upgrade Mirantis Container Runtime on CentOS:
To install MCR, you first need to go to repos.mirantis.com to obtain the URL for the static repository that
contains the MCR software for the desired CentOS version (henceforth
referred to here as <MCR-CentOS-URL>.)
Mirantis Container Runtime supports CentOS 64-bit, latest version, running on
x86_64.
On CentOS, Mirantis Container Runtime supports the overlay2 storage
drivers. The following limitations apply:
selinux is enabled, overlay2 is supported on CentOS 7.4 or higher.selinux is disabled, overlay2 is supported on CentOS 7.2 or higher
with kernel version 3.10.0-693 and higher.The Mirantis Container Runtime package is called docker-ee. Older
versions were called docker or docker-engine. Uninstall all
older versions and associated dependencies. The contents of
/var/lib/docker/ are preserved, including images, containers,
volumes, and networks.
$ sudo yum remove docker \
docker-client \
docker-client-latest \
docker-common \
docker-latest \
docker-latest-logrotate \
docker-logrotate \
docker-selinux \
docker-engine-selinux \
docker-engine
The advantage of using a repository from which to install Mirantis Container Runtime (or any software) is that it provides a certain level of automation. RPM-based distributions such as CentOS, use a tool called YUM that work with your repositories to manage dependencies and provide automatic updates.
You only need to set up the repository once, after which you can install Mirantis Container Runtime from the repo and repeatedly upgrade as necessary.
Remove existing Docker repositories from /etc/yum.repos.d/:
$ sudo rm /etc/yum.repos.d/docker*.repo
Temporarily store the URL (that you copied above) in an environment
variable. Replace <DOCKER-EE-URL> with your URL in the following
command. This variable assignment does not persist when the session ends:
$ export DOCKERURL="<DOCKER-EE-URL>"
Store the value of the variable, DOCKERURL (from the previous
step), in a yum variable in /etc/yum/vars/:
$ sudo -E sh -c 'echo "$DOCKERURL/centos" > /etc/yum/vars/dockerurl'
Install required packages: yum-utils provides the
yum-config-manager utility, and device-mapper-persistent-data
and lvm2 are required by the devicemapper storage driver:
$ sudo yum install -y yum-utils \
device-mapper-persistent-data \
lvm2
Add the Mirantis Container Runtime stable repository:
$ sudo -E yum-config-manager \
--add-repo \
"$DOCKERURL/centos/docker-ee.repo"
Install the latest patch release, or go to the next step to install a specific version:
$ sudo yum -y install docker-ee docker-ee-cli containerd.io
If prompted to accept the GPG key, verify that the fingerprint
matches 77FE DA13 1A83 1D29 A418 D3E8 99E5 FF2E 7668 2BC9, and if so, accept it.
To install a specific version of Mirantis Container Runtime (recommended in production), list versions and install:
List and sort the versions available in your repo. This example sorts results by version number, highest to lowest, and is truncated:
$ sudo yum list docker-ee --showduplicates | sort -r
docker-ee.x86_64 19.03.ee.2-1.el7.entos docker-ee-stable-18.09
The list returned depends on which repositories you enabled, and is
specific to your version of CentOS (indicated by ``.el7`` in this
example).
Install a specific version by its fully qualified package name,
which is the package name (docker-ee) plus the version string
(2nd column) starting at the first colon (:), up to the first
hyphen, separated by a hyphen (-). For example,
docker-ee-18.09.1.
$ sudo yum -y install docker-ee-<VERSION_STRING> docker-ee-cli-<VERSION_STRING> containerd.io
For example, if you want to install the 18.09 version run the following:
sudo yum-config-manager --enable docker-ee-stable-18.09
Docker is installed but not started. The docker group is created,
but no users are added to the group.
Start Docker:
Note
If using devicemapper, ensure it is properly configured before
starting Docker.
$ sudo systemctl start docker
Verify that Mirantis Container Runtime is installed correctly by
running the hello-world image. This command downloads a test
image, runs it in a container, prints an informational message, and
exits:
$ sudo docker run hello-world
Mirantis Container Runtime is installed and running. Use sudo to
run Docker commands.
To manually install Docker Enterprise, download the .rpm file for your
release. You need to download a new file each time you want to upgrade Docker
Enterprise.
Go to the Mirantis Container Runtime repository URL associated with
your trial or subscription in your browser. Go to
centos/7/x86_64/stable-<VERSION>/Packages and download the .rpm file
for the Docker version you want to install.
Install Docker Enterprise, changing the path below to the path where you downloaded the Docker package.
$ sudo yum install /path/to/package.rpm
Docker is installed but not started. The docker group is created,
but no users are added to the group.
Start Docker:
Note
If using devicemapper, ensure it is properly configured before
starting Docker.
$ sudo systemctl start docker
Verify that Mirantis Container Runtime is installed correctly by
running the hello-world image. This command downloads a test
image, runs it in a container, prints an informational message, and
exits:
$ sudo docker run hello-world
Mirantis Container Runtime is installed and running. Use sudo to
run Docker commands.
yum -y upgrade instead of yum -y install, and point to
the new file.Uninstall the Mirantis Container Runtime package:
$ sudo yum -y remove docker-ee
Delete all images, containers, and volumes (because these are not automatically removed from your host):
$ sudo rm -rf /var/lib/docker
Delete other Docker related resources:
$ sudo rm -rf /run/docker
$ sudo rm -rf /var/run/docker
$ sudo rm -rf /etc/docker
If desired, remove the devicemapper thin pool and reformat the
block devices that were part of it.
You must delete any edited configuration files manually.