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 Ubuntu version (henceforth referred
to here as <MCR-Ubuntu-URL>.)
Use the apt-get remove command to uninstall older versions of Mirantis
Container Runtime (called docker or docker-engine).
$ sudo apt-get remove docker docker-engine docker-ce docker-ce-cli docker.io
The apt-get command may report that none of the packages are installed.
Note
The contents of /var/lib/docker/, including images, containers,
volumes, and networks, are preserved.
For Ubuntu 16.04 and higher, the Linux kernel includes support for overlay2, and Mirantis Container Runtime uses it as the default storage driver. If you need to use aufs instead, be aware that it must be manually configured.
Mirantis Container Runtime can be installed either via Docker repositories, or by downloading and installing the DEB package and thereafter manually managing all upgrades. The Docker repository method is recommended, for the ease it lends in terms of both installation and upgrade tasks. The more manual DEB package approach, however, is useful in certain situations, such as installing Docker on air-gapped system that have no access to the Internet.
Naturally, to install Mirantis Container Runtime on a new host machine using the Docker repository you must first set the repository up on the machine.
Update the apt package index.
$ sudo apt-get update
Install packages to allow apt to use a repository over HTTPS.
$ sudo apt-get install \
apt-transport-https \
ca-certificates \
curl \
software-properties-common
Temporarily add a $DOCKER_EE_URL variable into your environment
(it persists only up until you log out of the session). Replace
<DOCKER-EE-URL> with the URL you noted down in the
prerequisites.
$ DOCKER_EE_URL="<DOCKER-EE-URL>"
Temporarily add a $DOCKER_EE_VERSION variable into your environment.
$ DOCKER_EE_VERSION=19.03
Add Docker’s official GPG key using your customer Mirantis Container Runtime repository URL.
$ curl -fsSL "${DOCKER_EE_URL}/ubuntu/gpg" | sudo apt-key add -
Verify that you now have the key with the fingerprint
DD91 1E99 5A64 A202 E859 07D6 BC14 F10B 6D08 5F96, by searching
for the last eight characters of the fingerprint. Use the command
as-is. It works because of the variable you set earlier.
$ sudo apt-key fingerprint 6D085F96
pub 4096R/0EBFCD88 2017-02-22
Key fingerprint = DD91 1E99 5A64 A202 E859 07D6 BC14 F10B 6D08 5F96
uid Docker Release (EE deb) <docker@docker.com>
sub 4096R/6D085F96 2017-02-22
Set up the stable repository, using the following command as-is (which works due to the variable set up earlier in the process).
$ sudo add-apt-repository \
"deb [arch=$(dpkg --print-architecture)] $DOCKER_EE_URL/ubuntu \
$(lsb_release -cs) \
stable-$DOCKER_EE_VERSION"
Note
The included lsb_release -cs sub command returns the name of
your Ubuntu distribution, for example, xenial.
Update the apt package index.
$ sudo apt-get update
Install the latest version of Mirantis Container Runtime and containerd, or go to the next step to install a specific version. Any existing installation of Docker is replaced.
$ sudo apt-get install docker-ee docker-ee-cli containerd.io
Warning
If you have multiple Docker repositories enabled, installing or
updating without specifying a version in the apt-get install
or apt-get update command always installs the highest possible
version, which may not be appropriate for your stability needs.
{:.warning}
On production systems, you should install a specific version of Mirantis Container Runtime instead of always using the latest. The following output is truncated.
$ apt-cache madison docker-ee
docker-ee | 19.03.0~ee-0~ubuntu-xenial | <DOCKER-EE-URL>/ubuntu xenial/stable amd64 Packages
The contents of the list depend upon which repositories are enabled,
and are specific to your version of Ubuntu (indicated by the
xenial suffix on the version, in this example). Choose a specific
version to install. The second column is the version string. The
third column is the repository name, which indicates which repository
the package is from and by extension its stability level. To install
a specific version, append the version string to the package name and
separate them by an equals sign (=).
$ sudo apt-get install docker-ee=<VERSION_STRING> docker-ee-cli=<VERSION_STRING> containerd.io
The Docker daemon starts automatically.
Verify that Docker is installed correctly by running the
hello-world image.
$ sudo docker run hello-world
This command downloads a test image and runs it in a container. When the container runs, it prints an informational message and exits.
Mirantis Container Runtime is installed and running. The docker
group is created but no users are added to it. You need to use sudo
to run Docker commands.
sudo apt-get update.If you cannot use Docker’s repository to install Mirantis Container Runtime,
you can download the .deb files for your release and install them manually.
You need to download a new file or set of files each time you want to upgrade
Mirantis Container Runtime.
Go to the Mirantis Container Runtime repository URL associated with
your trial or subscription in your browser. Go to
/ubuntu/dists/bionic/pool/stable-<VERSION>/amd64/ and download
the .deb file for the Ubuntu release, Docker EE version, and
architecture you want to install.
Note
Starting with 19.03, you have to download three .deb files.
They are docker-ee-cli_<version>.deb,
containerd.io_<version>.deb, and docker-ee_<version>.deb.
Install Docker, changing the path below to the path where you downloaded the Mirantis Container Runtime package.
$ sudo dpkg -i /path/to/package.deb
Or, if you downloaded the three .deb files, you must install
them in the following order:
$ sudo dpkg -i /path/to/docker-ee-cli_<version>.deb
$ sudo dpkg -i /path/to/containerd.io_<version>.deb
$ sudo dpkg -i /path/to/docker-ee_<version>.deb
The Docker daemon starts automatically.
Verify that Docker is installed correctly by running the
hello-world image.
$ sudo docker run hello-world
This command downloads a test image and runs it in a container. When the container runs, it prints an informational message and exits.
Mirantis Container Runtime is installed and running. The docker
group is created but no users are added to it. You need to use sudo
to run Docker commands.
To upgrade Mirantis Container Runtime, download the newer package file and repeat the installation procedure, pointing to the new file.
Uninstall the Mirantis Container Runtime package.
$ sudo apt-get purge docker-ee
Images, containers, volumes, or customized configuration files on your host are not automatically removed. Run the following command to delete all images, containers, and volumes.
$ sudo rm -rf /var/lib/docker
You must delete any edited configuration files manually.