Get Docker EE for Oracle Linux¶

Architectures and storage drivers¶

Docker Engine - Enterprise supports Oracle Linux 64-bit, versions 7.3 and higher, running the Red Hat Compatible kernel (RHCK) 3.10.0-514 or higher. Older versions of Oracle Linux are not supported.

On Oracle Linux, Docker Engine - Enterprise only supports the devicemapper storage driver. In production, you must use it in direct-lvm mode, which requires one or more dedicated block devices. Fast storage such as solid-state media (SSD) is recommended.

Find your Docker EE repo URL¶

To install Docker EE, you will need the URL of the Docker EE repository associated with your trial or subscription:

1. Go to https://hub.docker.com/my-content. All of your subscriptions and trials are listed.
2. Click the Setup button for Docker Enterprise Edition for Oracle Linux.
3. Copy the URL from Copy and paste this URL to download your Edition and save it for later use.

You will use this URL in a later step to create a variable called, DOCKERURL.

Uninstall old Docker versions¶

The Docker Engine - Enterprise 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-engine \
                  docker-engine-selinux

Set up the repository¶

You only need to set up the repository once, after which you can install Docker Engine - Enterprise from the repo and repeatedly upgrade as necessary.

1. Remove existing Docker repositories from /etc/yum.repos.d/:

   $ sudo rm /etc/yum.repos.d/docker*.repo
   

2. 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>"
   

3. 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/oraclelinux" > /etc/yum/vars/dockerurl'
   

4. 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
   

5. Enable the ol7_addons Oracle repository. This ensures access to the container-selinux package required by docker-ee.

   $ sudo yum-config-manager --enable ol7_addons
   

6. Add the Docker Engine - Enterprise stable repository:

   $ sudo -E yum-config-manager \
       --add-repo \
       "$DOCKERURL/oraclelinux/docker-ee.repo"
   

Install from the repository¶

1. 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.

2. To install a specific version of Docker Engine - Enterprise (recommended in production), list versions and install:

   1. 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.oraclelinuix     docker-ee-stable-18.09
      

      The list returned depends on which repositories you enabled, and is specific to your version of Oracle Linux (indicated by .el7 in this example).

   2. 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.

3. Start Docker:

   Note

   If using devicemapper, ensure it is properly configured before starting Docker.

   $ sudo systemctl start docker
   

4. Verify that Docker Engine - Enterprise 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
   

   Docker Engine - Enterprise is installed and running. Use sudo to run Docker commands.

Install with a package¶

1. Go to the Docker Engine - Enterprise repository URL associated with your trial or subscription in your browser. Go to oraclelinux/. Choose your Oracle Linux version, architecture, and Docker version. Download the .rpm file from the Packages directory.

2. 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.

3. Start Docker:

   Note

   If using devicemapper, ensure it is properly configured before starting Docker.

   $ sudo systemctl start docker
   

4. Verify that Docker Engine - Enterprise 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
   

   Docker Engine - Enterprise is installed and running. Use sudo to run Docker commands.

Upgrade with a package¶

1. Download the newer package file.
2. Repeat the installation procedure, using yum -y upgrade instead of yum -y install, and point to the new file.