docker
/
docs
mirror of https://github.com/docker/docs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Address ppc64le PRs; Clean up EE install pages (#6363)

This commit is contained in:
Gwendolynne Barr 2018-04-04 16:31:49 -07:00 committed by GitHub
parent 0e2a3ebf2f
commit 672fd04b8c
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
4 changed files with 210 additions and 284 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

245
_includes/ee-linux-install-reuse.md
View File

@ -10,73 +10,61 @@ Usage: {% include ee-linux-install-reuse.md section="ee-install-intro" %}
{% endcomment %}
{% if section == "ee-install-intro" %}
To get started with Docker EE on {{ linux-dist-long }}, make sure you
[meet the prerequisites](#prerequisites), then
[install Docker](#install-docker-ee).
There are two ways to install and upgrade [Docker Enterprise Edition (Docker EE)](https://www.docker.com/enterprise-edition/){: target="_blank" class="_" }
on {{ linux-dist-long }}:
{% elsif section == "ee-url-intro" %}
- [YUM repository](#repo-install-and-upgrade): Set up a Docker repository and install Docker EE from it. This is the recommended approach because installation and upgrades are managed with YUM and easier to do.
To install Docker Enterprise Edition (Docker EE), you need to know the Docker EE
repository URL associated with your trial or subscription. These instructions
work for Docker EE for {{ linux-dist-long }} and for Docker EE for Linux, which
includes access to Docker EE for all Linux distributions. To get this
information:
- [RPM package](#package-install-and-upgrade): Download the {{ package-format }} package, install it manually, and manage upgrades manually. This is useful when installing Docker EE on air-gapped systems with no access to the internet.
- Go to [https://store.docker.com/my-content](https://store.docker.com/my-content).
- Each subscription or trial you have access to is listed. Click the **Setup**
button for **Docker Enterprise Edition for {{ linux-dist-long }}**.
- Copy the URL from the field labeled
**Copy and paste this URL to download your Edition**.
{% if linux-dist == "rhel" or linux-dist == "oraclelinux" %}
Docker Community Edition (Docker CE) is _not_ supported on {{ linux-dist-long }}.
{% endif %}
{% if linux-dist == "centos" %}
For Docker Community Edition on {{ linux-dist-cap }}, see [Get Docker CE for CentOS](/install/linux/docker-ce/centos.md).
{% endif %}
Use this URL when you see the placeholder text `<DOCKER-EE-URL>`.
{% elsif section == "find-ee-repo-url" %}
To learn more about Docker EE, see
[Docker Enterprise Edition](https://www.docker.com/enterprise-edition/){: target="_blank" class="_" }.
To install Docker EE, you will need the URL of the Docker EE repository associated with your trial or subscription:
1. Go to [https://store.docker.com/my-content](https://store.docker.com/my-content){: target="_blank" class="_" }. All of your subscriptions and trials are listed.
2. Click the **Setup** button for **Docker Enterprise Edition for {{ linux-dist-long }}**.
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`.
{% elsif section == "using-yum-repo" %}
{% elsif section == "ways-to-install" %}
You can install Docker EE in different ways, depending on your needs:
- Most users
[set up Docker's repositories](#install-using-the-repository) and install
from them, for ease of installation and upgrade tasks. This is the
recommended approach.
- Some users download the {{ package-format }} package and install it manually
and manage upgrades completely manually. This is useful in situations such as
installing Docker on air-gapped systems with no access to the internet.
The advantage of using a repository from which to install Docker EE (or any software) is that it provides a certain level of automation. RPM-based distributions such as {{ linux-dist-long }}, use a tool called YUM that work with your repositories to manage dependencies and provide automatic updates.
{% elsif section == "set-up-yum-repo" %}
You only need to set up the repository once, after which you can install Docker EE _from_ the repo and repeatedly upgrade as necessary.
1. Remove any existing Docker repositories from `/etc/yum.repos.d/`.
2. Temporarily store the Docker EE repository URL you noted down in the
[prerequisites](#prerequisites) in an environment variable.
This does not persist when the current session ends.
1. Remove existing Docker repositories from `/etc/yum.repos.d/`:
```bash
$ export DOCKERURL='<DOCKER-EE-URL>'
$ sudo rm /etc/yum.repos.d/docker*.repo
```
3. Store your Docker EE repository URL in a `yum` variable in `/etc/yum/vars/`.
This command relies on the variable you stored in the previous step.
2. Temporarily store the URL (that you [copied above](#find-your-docker-ee-repo-url)) 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.
```bash
$ 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/`:
```bash
$ sudo -E sh -c 'echo "$DOCKERURL/{{ linux-dist-url-slug }}" > /etc/yum/vars/dockerurl'
```
{% if linux-dist == "rhel" %}
Store your OS version string in `/etc/yum/vars/dockerosversion`. Most users
should use `7`, but you can also use the more specific minor version,
starting from `7.2`.
Also, store your OS version string in `/etc/yum/vars/dockerosversion`. Most users should use `7`, but you can also use the more specific minor version, starting from `7.2`.
```bash
$ sudo sh -c 'echo "7" > /etc/yum/vars/dockerosversion'
@ -84,9 +72,7 @@ You can install Docker EE in different ways, depending on your needs:
{% endif %}
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.
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:
```bash
$ sudo yum install -y yum-utils \
@ -95,32 +81,42 @@ You can install Docker EE in different ways, depending on your needs:
```
{% if linux-dist == "rhel" %}
5. Enable the `extras` RHEL repository. This ensures access to the
`container-selinux` package which is required by `docker-ee`.
5. Enable the `extras` RHEL repository. This ensures access to the `container-selinux` package required by `docker-ee`.
The repository can differ per your architecture and cloud provider, so review the options in this step before running:
**For all architectures _except_ IBM Power PC:**
```bash
$ sudo yum-config-manager --enable rhel-7-server-extras-rpms
```
Depending on cloud provider, you may also need to enable another repository.
**For IBM Power PC only (little endian):**
For AWS:
```bash
$ sudo yum-config-manager --enable extras
$ sudo subscription-manager repos --enable=rhel-7-for-power-le-extras-rpms
$ sudo yum makecache fast
$ sudo yum -y install container-selinux
```
Depending on cloud provider, you may also need to enable another repository:
**For AWS** (where `REGION` is a literal, and does _not_ represent the region your machine is running in):
```bash
$ sudo yum-config-manager --enable rhui-REGION-rhel-server-extras
```
> **Note**: `REGION` here is literal, and does *not* represent the region
> your machine is running in.
For Azure:
**For Azure:**
```bash
$ sudo yum-config-manager --enable rhui-rhel-7-server-rhui-extras-rpms
```
{% endif %}
6. Use the following command to add the **stable** repository:
6. Add the Docker EE **stable** repository:
```bash
$ sudo -E yum-config-manager \
@ -131,120 +127,84 @@ You can install Docker EE in different ways, depending on your needs:
{% elsif section == "install-using-yum-repo" %}
1. Install the latest version of Docker EE, or go to the next step to install a
specific version.
1. Install the _latest version_ of Docker EE, or go to the next step to install a specific version:
```bash
$ sudo yum -y install docker-ee
```
If this is the first time you are installing a package from a recently added
repository, you are prompted to accept the GPG key, and
the key's fingerprint is shown. Verify that the fingerprint matches
`{{ gpg-fingerprint }}` and if so, accept the key.
If prompted to accept the GPG key, verify that the fingerprint matches `{{ gpg-fingerprint }}`, and if so, accept it.
2. On production systems, you should install a specific version of Docker EE
instead of always using the latest. List the available versions.
This example uses the `sort -r` command to sort the results by version
number, highest to lowest, and is truncated.
2. To install a _specific version_ of Docker EE (recommended in production), list versions and install:
a. List and sort the versions available in your repo. This example sorts results by version number, highest to lowest, and is truncated:
```bash
$ sudo yum list docker-ee --showduplicates | sort -r
docker-ee.x86_64 {{ site.docker_ee_version }}.ee.2-1.el7.{{ linux-dist }} docker-ee-stable-17.06
docker-ee.x86_64 {{ site.docker_ee_version }}.ee.2-1.el7.{{ linux-dist }} docker-ee-stable-17.06
```
The contents of the list depend upon which repositories you have enabled,
and is specific to your version of {{ linux-dist-long }}
(indicated by the `.el7` suffix on the version, in this example). Choose a
specific version to install. The second column is the version string. You
can use the entire version string, but **you need to include at least to the
first hyphen**. 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 a hyphen (`-`):
The list returned depends on which repositories you enabled, and is specific to your version of {{ linux-dist-long }} (indicated by `.el7` in this example).
> **Note**: The version string is the package name plus the version up to
> the first hyphen. In the example above, the fully qualified package name
> is `docker-ee-17.06.1.ee.2`.
b. Install a specific version by its **fully qualified package name** which is the package name (`docker-ee`) plus the version string (2nd column) up to the hyphen, for example: `docker-ee-17.06.1.ee.2`
```bash
$ sudo yum -y install <FULLY-QUALIFIED-PACKAGE-NAME>
```
Docker is installed but not started. The `docker` group is created, but no
users are added to the group.
Docker is installed but not started. The `docker` group is created, but no users are added to the group.
{% if linux-dist == "centos" or linux-dist == "rhel" or linux-dist == "oraclelinux" %}
3. If you need to use `devicemapper`, follow the procedure in the
[devicemapper storage driver guide](/engine/userguide/storagedriver/device-mapper-driver.md#configure-direct-lvm-mode-for-production){: target="_blank" class="_" }
**before starting Docker**. For production systems using `devicemapper`,
you must use `direct-lvm` mode,
which requires you to prepare the block devices.
{% endif %}
3. Start Docker:
4. Start Docker.
> If using `devicemapper`, ensure it is properly configured before starting Docker, per the [storage guide](/storage/storagedriver/device-mapper-driver/){: target="_blank" class="_" }.
```bash
$ sudo systemctl start docker
```
5. Verify that Docker EE is installed correctly by running the `hello-world`
image.
4. Verify that Docker EE 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:
```bash
$ 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.
Docker EE is installed and running. You need to use `sudo` to run Docker
commands. Continue to [Linux postinstall](/install/linux/linux-postinstall.md) to allow
non-privileged users to run Docker commands and for other optional configuration
steps.
Docker EE is installed and running. Use `sudo` to run Docker commands. See
[Linux postinstall](/install/linux/linux-postinstall.md){: target="_blank" class="_" } to allow
non-privileged users to run Docker commands.
{% elsif section == "upgrade-using-yum-repo" %}
To upgrade Docker EE:
1. [Add the new repository](#set-up-the-repository).
1. If upgrading to a new major Docker EE version (such as when going from
Docker 17.03.x to Docker 17.06.x),
[add the new repository](#set-up-the-repository){: target="_blank" class="_" }.
2. Follow the [installation instructions](#install-from-the-repository) and install a new version.
2. Follow the
[installation instructions](#install-docker), choosing the new version you
want to install.
{% elsif section == "package-installation" %}
To manually install Docker EE, download the `.{{ package-format | downcase }}` file for your release. You need to download a new file each time you want to upgrade Docker EE.
{% elsif section == "install-using-yum-package" %}
If you cannot use the official Docker repository to install Docker EE, you can
download the `.{{ package-format | downcase }}` file for your release and
install it manually. You need to download a new file each time you want to
upgrade Docker EE.
{% if linux-dist == "rhel" %}
1. Enable the `extras` RHEL repository. This ensures access to the
`container-selinux` package which is required by `docker-ee`.
1. Enable the `extras` RHEL repository. This ensures access to the `container-selinux` package which is required by `docker-ee`:
```bash
$ sudo yum-config-manager --enable rhel-7-server-extras-rpms
```
Alternately, obtain that package manually from Red Hat.
There is no way to publicly browse this repository.
Alternately, obtain that package manually from Red Hat. There is no way to publicly browse this repository.
{% endif %}
{% if linux-dist == "centos" %}
1. Go to the Docker EE repository URL associated with your
trial or subscription in your browser. Go to
`{{ linux-dist-url-slug }}/7/x86_64/stable-{{ site.docker_ee_version }}/Packages` and
download the `.{{ package-format | downcase }}` file for the Docker version
you want to install.
1. Go to the Docker EE repository URL associated with your trial or subscription
in your browser. Go to `{{ linux-dist-url-slug }}/7/x86_64/stable-{{ site.docker_ee_version }}/Packages`
and download the `.{{ package-format | downcase }}` file for the Docker version you want to install.
{% endif %}
{% if linux-dist == "rhel" or linux-dist == "oraclelinux" %}
1. Go to the Docker EE repository URL associated with your
trial or subscription in your browser. Go to
@ -253,10 +213,8 @@ upgrade Docker EE.
`.{{ package-format | downcase }}` file from the `Packages` directory.
{% if linux-dist == "rhel" %}
> **Note**: If you have trouble with `selinux` using the packages under the
> `7` directory, try choosing the version-specific directory instead, such
> as `7.3`.
> If you have trouble with `selinux` using the packages under the `7` directory,
> try choosing the version-specific directory instead, such as `7.3`.
{% endif %}
{% endif %}
@ -270,41 +228,34 @@ upgrade Docker EE.
Docker is installed but not started. The `docker` group is created, but no
users are added to the group.
{% if linux-dist == "centos" or linux-dist == "rhel" or linux-dist == "oraclelinux" %}
3. If you need to use `devicemapper`, follow the procedure in the
[devicemapper storage driver guide](/engine/userguide/storagedriver/device-mapper-driver.md#configure-direct-lvm-mode-for-production){: target="_blank" class="_" }
**before starting Docker**. For production systems using `devicemapper`,
you must use `direct-lvm` mode,
which requires you to prepare the block devices.
{% endif %}
3. Start Docker:
4. Start Docker.
> If using `devicemapper`, ensure it is properly configured before starting Docker, per the [storage guide](/storage/storagedriver/device-mapper-driver/){: target="_blank" class="_" }.
```bash
$ sudo systemctl start docker
```
5. Verify that Docker EE is installed correctly by running the `hello-world`
image.
4. Verify that Docker EE 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:
```bash
$ 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.
Docker EE is installed and running. You need to use `sudo` to run Docker
commands. Continue to [Post-installation steps for Linux](/install/linux/linux-postinstall.md)
to allow non-privileged users to run Docker commands and for other optional
configuration steps.
Docker EE is installed and running. Use `sudo` to run Docker commands. See
[Linux postinstall](/install/linux/linux-postinstall.md){: target="_blank" class="_" } to allow
non-privileged users to run Docker commands.
{% elsif section == "upgrade-using-yum-package" %}
To upgrade Docker EE, download the newer package file and repeat the
[installation procedure](#install-from-a-package), using `yum -y upgrade`
instead of `yum -y install`, and pointing to the new file.
1. Download the newer package file.
2. Repeat the [installation procedure](#install-with-a-package), using
`yum -y upgrade` instead of `yum -y install`, and point to the new file.
{% elsif section == "yum-uninstall" %}
@ -314,9 +265,7 @@ instead of `yum -y install`, and pointing to the new file.
$ sudo yum -y remove docker-ee
```
2. Images, containers, volumes, or customized configuration files on your host
are not automatically removed. To delete all images, containers, and
volumes:
2. Delete all images, containers, and volumes (because these are not automatically removed from your host):
```bash
$ sudo rm -rf /var/lib/docker
@ -330,8 +279,8 @@ You must delete any edited configuration files manually.
{% elsif section == "linux-install-nextsteps" %}
- Continue to [Post-installation steps for Linux](/install/linux/linux-postinstall.md)
- Continue to [Post-installation steps for Linux](/install/linux/linux-postinstall.md){: target="_blank" class="_" }
- Continue with the [User Guide](/engine/userguide/index.md).
- Continue with user guides on [Universal Control Plane (UCP)](/datacenter/ucp/2.2/guides/){: target="_blank" class="_" } and [Docker Trusted Registry (DTR)](/datacenter/dtr/2.4/guides/){: target="_blank" class="_" }
{% endif %}

76
install/linux/docker-ee/centos.md
View File

@ -5,55 +5,45 @@ redirect_from:
- /engine/installation/centos/
- /engine/installation/linux/docker-ee/centos/
title: Get Docker EE for CentOS
toc_max: 4
---
{% assign linux-dist = "centos" %}
{% assign linux-dist-cap = "CentOS" %}
{% assign linux-dist-url-slug = "centos" %}
{% assign linux-dist-long = "Centos" %}
{% assign package-format = "RPM" %}
{% assign gpg-fingerprint = "77FE DA13 1A83 1D29 A418 D3E8 99E5 FF2E 7668 2BC9" %}
{% include ee-linux-install-reuse.md section="ee-install-intro" %}
## Prerequisites
Docker CE users should go to
[Get docker CE for CentOS](/install/linux/docker-ce/centos.md)
**instead of this topic**.
This section lists what you need to consider before installing Docker EE. Items that require action are explained below.
### Docker EE repository URL
- Use {{ linux-dist-cap }} 64-bit 7.1 and higher on `x86_64`.
- Use storage driver `overlay2` or `devicemapper` (`direct-lvm` mode in production).
- Find the URL for your Docker EE repo at [Docker Store](https://store.docker.com/my-content){: target="_blank" class="_" }.
- Uninstall old versions of Docker.
- Remove old Docker repos from `/etc/yum.repos.d/`.
{% include ee-linux-install-reuse.md section="ee-url-intro" %}
### Architectures and storage drivers
### OS requirements
Docker EE supports {{ linux-dist-long }} 64-bit, versions 7.1 and higher (7.1, 7.2, 7.3, 7.4), running on `x86_64`.
To install Docker EE, you need the 64-bit version of {{ linux-dist-long }}
running on `x86_64`.
On {{ linux-dist-long }}, Docker EE supports storage drivers, `overlay2` and `devicemapper`. In Docker EE 17.06.2-ee-5 and higher, `overlay2` is the recommended storage driver. The following limitations apply:
In addition, you must use the `overlay2` or `devicemapper` storage driver.
Beginning with Docker EE 17.06.2-ee-5 the `overlay2` storage driver is the
recommended storage driver.
- [OverlayFS](/storage/storagedriver/overlayfs-driver){: target="_blank" class="_" }: If `selinux` is enabled, the `overlay2` storage driver is supported on {{ linux-dist-cap }} 7.4 or higher. If `selinux` is disabled, `overlay2` is supported on {{ linux-dist-cap }} 7.2 or higher with kernel version 3.10.0-693 and higher.
The following limitations apply:
- [Device Mapper](/storage/storagedriver/device-mapper-driver/){: target="_blank" class="_" }: On production systems using `devicemapper`, you must use `direct-lvm` mode, which requires one or more dedicated block devices. Fast storage such as solid-state media (SSD) is recommended. Do not start Docker until properly configured per the [storage guide](/storage/storagedriver/device-mapper-driver/){: target="_blank" class="_" }.
**OverlayFS**:
### Find your Docker EE repo URL
- The `overlay2` storage driver is only supported on CentOS 7 systems
using version 3.10.0-693 or high of the kernel.
- If `selinux` is enabled, the `overlay2` storage driver is only supported on
RHEL 7.4 or higher.
{% include ee-linux-install-reuse.md section="find-ee-repo-url" %}
**Devicemapper**:
### Uninstall old Docker versions
- On production systems using `devicemapper`, you must use `direct-lvm` mode,
which requires one or more dedicated block devices. Fast storage such as
solid-state media (SSD) is recommended.
### Uninstall old versions
Older versions of Docker were called `docker` or `docker-engine`. In addition,
if you are upgrading from Docker CE to Docker EE, remove the Docker CE package.
The Docker EE 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. If you are upgrading from Docker CE to Docker EE, remove the Docker CE package as well.
```bash
$ sudo yum remove docker \
@ -69,41 +59,37 @@ $ sudo yum remove docker \
docker-ce
```
It's OK if `yum` reports that none of these packages are installed.
## Repo install and upgrade
The contents of `/var/lib/docker/`, including images, containers, volumes, and
networks, are preserved. The Docker EE package is now called `docker-ee`.
{% include ee-linux-install-reuse.md section="using-yum-repo" %}
## Install Docker EE
{% include ee-linux-install-reuse.md section="ways-to-install" %}
### Install using the repository
Before you install Docker EE for the first time on a new host machine, you need
to set up the Docker EE repository. Afterward, you can install and update Docker
EE from the repository.
#### Set up the repository
### Set up the repository
{% include ee-linux-install-reuse.md section="set-up-yum-repo" %}
#### Install Docker EE
### Install from the repository
{% include ee-linux-install-reuse.md section="install-using-yum-repo" %}
#### Upgrade Docker EE
### Upgrade from the repository
{% include ee-linux-install-reuse.md section="upgrade-using-yum-repo" %}
### Install from a package
## Package install and upgrade
{% include ee-linux-install-reuse.md section="package-installation" %}
### Install with a package
{% include ee-linux-install-reuse.md section="install-using-yum-package" %}
#### Upgrade Docker EE
### Upgrade with a package
{% include ee-linux-install-reuse.md section="upgrade-using-yum-package" %}
## Uninstall Docker EE
{% include ee-linux-install-reuse.md section="yum-uninstall" %}

80
install/linux/docker-ee/oracle.md
View File

@ -6,48 +6,42 @@ redirect_from:
- /engine/installation/linux/oracle/
- /engine/installation/linux/docker-ee/oracle/
title: Get Docker EE for Oracle Linux
toc_max: 4
---
{% assign linux-dist = "oraclelinux" %}
{% assign linux-dist-cap = "OL" %}
{% assign linux-dist-url-slug = "oraclelinux" %}
{% assign linux-dist-long = "Oracle Linux" %}
{% assign package-format = "RPM" %}
{% assign gpg-fingerprint = "77FE DA13 1A83 1D29 A418 D3E8 99E5 FF2E 7668 2BC9" %}
To get started with Docker EE on {{ linux-dist-long }}, make sure you
[meet the prerequisites](#prerequisites), then
[install Docker](#install-docker-ee).
{% include ee-linux-install-reuse.md section="ee-install-intro" %}
## Prerequisites
Docker Community Edition (Docker CE) is not supported on {{ linux-dist-long }}.
This section lists what you need to consider before installing Docker EE. Items that require action are explained below.
### Docker EE repository URL
- Use {{ linux-dist-cap }} 64-bit 7.3 or higher on RHCK 3.10.0-514 or higher.
- Use the `devicemapper` storage driver only (`direct-lvm` mode in production).
- Find the URL for your Docker EE repo at [Docker Store](https://store.docker.com/my-content){: target="_blank" class="_" }.
- Uninstall old versions of Docker.
- Remove old Docker repos from `/etc/yum.repos.d/`.
- Disable SELinux if installing or upgrading Docker EE 17.06.1.
{% include ee-linux-install-reuse.md section="ee-url-intro" %}
### Architectures and storage drivers
### OS requirements
Docker EE supports {{ linux-dist-long }} 64-bit, versions 7.3 and higher, running the Red Hat Compatible kernel (RHCK) 3.10.0-514 or higher. Older versions of {{ linux-dist-long }} are not supported.
To install Docker EE, you need the 64-bit version of {{ linux-dist-long }} 7.3
or higher, running the Red Hat Compatible kernel (RHCK) 3.10.0-514 or higher.
Older versions of {{ linux-dist-long }} are not supported.
On {{ linux-dist-long }}, Docker EE 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. Do not start Docker until properly configured per the [storage guide](/storage/storagedriver/device-mapper-driver/){: target="_blank" class="_" }.
In addition, you must use the `devicemapper` storage driver if you use
Docker EE. On production systems, you must use `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
> **Docker EE cannot install on {{ linux-dist }} with `selinux` enabled!**
>
> If you have `selinux` enabled and you attempt to install Docker EE 17.06.1,
> you get an error that the `container-selinux` package cannot be found.
{:.warning }
{% include ee-linux-install-reuse.md section="find-ee-repo-url" %}
### Uninstall old versions
### Uninstall old Docker versions
Older versions of Docker were called `docker` or `docker-engine`. If these are
installed, uninstall them, along with associated dependencies.
The Docker EE 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.
```bash
$ sudo yum remove docker \
@ -55,41 +49,47 @@ $ sudo yum remove docker \
docker-engine-selinux
```
It's OK if `yum` reports that none of these packages are installed.
## Repo install and upgrade
The contents of `/var/lib/docker/`, including images, containers, volumes, and
networks, are preserved. The Docker EE package is now called `docker-ee`.
{% include ee-linux-install-reuse.md section="using-yum-repo" %}
## Install Docker EE
{% capture selinux-warning %}
> Docker EE cannot install on {{ linux-dist-long }} with SELinux enabled
>
> If you have `selinux` enabled and you attempt to install Docker EE 17.06.1, you get an error that the `container-selinux` package cannot be found..
{:.warning}
{% endcapture %}
{{ selinux-warning }}
{% include ee-linux-install-reuse.md section="ways-to-install" %}
### Install using the repository
Before you install Docker EE for the first time on a new host machine, you need
to set up the Docker repository. Afterward, you can install and update Docker EE
from the repository.
#### Set up the repository
### Set up the repository
{% include ee-linux-install-reuse.md section="set-up-yum-repo" %}
#### Install Docker EE
### Install from the repository
{% include ee-linux-install-reuse.md section="install-using-yum-repo" %}
#### Upgrade Docker EE
### Upgrade from the repository
{% include ee-linux-install-reuse.md section="upgrade-using-yum-repo" %}
### Install from a package
## Package install and upgrade
{% include ee-linux-install-reuse.md section="package-installation" %}
{{ selinux-warning }}
### Install with a package
{% include ee-linux-install-reuse.md section="install-using-yum-package" %}
#### Upgrade Docker EE
### Upgrade with a package
{% include ee-linux-install-reuse.md section="upgrade-using-yum-package" %}
## Uninstall Docker EE
{% include ee-linux-install-reuse.md section="yum-uninstall" %}

93
install/linux/docker-ee/rhel.md
View File

@ -7,63 +7,50 @@ redirect_from:
- /engine/installation/linux/rhel/
- /engine/installation/linux/docker-ee/rhel/
title: Get Docker EE for Red Hat Enterprise Linux
toc_max: 4
---
{% assign linux-dist = "rhel" %}
{% assign linux-dist-cap = "RHEL" %}
{% assign linux-dist-url-slug = "rhel" %}
{% assign linux-dist-long = "Red Hat Enterprise Linux" %}
{% assign package-format = "RPM" %}
{% assign gpg-fingerprint = "77FE DA13 1A83 1D29 A418 D3E8 99E5 FF2E 7668 2BC9" %}
{% include ee-linux-install-reuse.md section="ee-install-intro" %}
## Prerequisites
Docker Community Edition (Docker CE) is not supported on {{ linux-dist-long }}.
This section lists what you need to consider before installing Docker EE. Items that require action are explained below.
### Docker EE repository URL
- Use {{ linux-dist-cap }} 64-bit 7.1 and higher on `x86_64`, `s390x`, or `ppc64le` (not ppc64).
- Use storage driver `overlay2` or `devicemapper` (`direct-lvm` mode in production).
- Find the URL for your Docker EE repo at [Docker Store](https://store.docker.com/my-content){: target="_blank" class="_" }.
- Uninstall old versions of Docker.
- Remove old Docker repos from `/etc/yum.repos.d/`.
- Disable SELinux on IBM Power systems before install/upgrade.
{% include ee-linux-install-reuse.md section="ee-url-intro" %}
### Architectures and storage drivers
### OS requirements
Docker EE supports {{ linux-dist-long }} 64-bit, versions 7.1 and higher (7.1, 7.2, 7.3, 7.4), running on one of the following architectures: `x86_64`, `s390x` (IBM Z), or `ppc64le` (IBM Power PC, little endian format). To ensure you have `ppc64le` (and not `ppc64`), run the command, `uname -m`.
To install Docker EE, you need the 64-bit version of {{ linux-dist-long }}
running on `x86_64`, `s390x` (IBM Z), or `ppc64le` (IBM Power) architectures.
> Little endian format only
>
> On IBM Power PC systems, Docker EE only supports little endian format, `ppc64le`, even though {{ linux-dist-cap }} 7 ships both big and little endian versions.
In addition, you must use the `overlay2` or `devicemapper` storage driver.
Beginning with Docker EE 17.06.2-ee-5 the `overlay2` storage driver is the
recommended storage driver.
On {{ linux-dist-long }}, Docker EE supports storage drivers, `overlay2` and `devicemapper`. In Docker EE 17.06.2-ee-5 and higher, `overlay2` is the recommended storage driver. The following limitations apply:
The following limitations apply:
- [OverlayFS](/storage/storagedriver/overlayfs-driver){: target="_blank" class="_" }: If `selinux` is enabled, the `overlay2` storage driver is supported on {{ linux-dist-cap }} 7.4 or higher. If `selinux` is disabled, `overlay2` is supported on {{ linux-dist-cap }} 7.2 or higher with kernel version 3.10.0-693 and higher.
**OverlayFS**:
- [Device Mapper](/storage/storagedriver/device-mapper-driver/){: target="_blank" class="_" }: On production systems using `devicemapper`, you must use `direct-lvm` mode, which requires one or more dedicated block devices. Fast storage such as solid-state media (SSD) is recommended. Do not start Docker until properly configured per the [storage guide](/storage/storagedriver/device-mapper-driver/){: target="_blank" class="_" }.
- The `overlay2` storage driver is only supported on RHEL 7.2 or higher systems
using version 3.10.0-693 or high of the kernel.
- If `selinux` is enabled, the `overlay2` storage driver is only supported on
RHEL 7.4 or higher.
### Find your Docker EE repo URL
**Devicemapper**:
{% include ee-linux-install-reuse.md section="find-ee-repo-url" %}
- On production systems using `devicemapper`, you must use `direct-lvm` mode,
which requires one or more dedicated block devices. Fast storage such as
solid-state media (SSD) is recommended.
### Uninstall old Docker versions
{% capture selinux-warning %}
> **Warning**: There is currently no support for `selinux` on IBM Z systems. If
> you try to install Docker EE on an IBM Z system with `selinux` enabled, you get
> an error about the `container-selinux` package, which is missing from Red Hat's
> repository for IBM Z. The only current workaround is to disable `selinux`
> before installing or upgrading Docker on IBM Z.
{:.warning}
{% endcapture %}
{{ selinux-warning }}
### Uninstall old versions
Older versions of Docker were called `docker` or `docker-engine`. If these are
installed, uninstall them, along with associated dependencies.
The Docker EE 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.
```bash
$ sudo yum remove docker \
@ -79,45 +66,49 @@ $ sudo yum remove docker \
docker-ce
```
It's OK if `yum` reports that none of these packages are installed.
The contents of `/var/lib/docker/`, including images, containers, volumes, and
networks, are preserved. The Docker EE package is now called `docker-ee`.
## Install Docker EE
## Repo install and upgrade
{% include ee-linux-install-reuse.md section="ways-to-install" %}
{% include ee-linux-install-reuse.md section="using-yum-repo" %}
### Install using the repository
{% capture selinux-warning %}
> Disable SELinux before installing Docker EE on IBM Z systems
>
> There is currently no support for `selinux` on IBM Z systems. If you attempt to install or upgrade Docker EE on an IBM Z system with `selinux` enabled, an error is thrown that the `container-selinux` package is not found. Disable `selinux` before installing or upgrading Docker on IBM Z.
{:.warning}
{% endcapture %}
{{ selinux-warning }}
Before you install Docker EE for the first time on a new host machine, you need
to set up the Docker repository. Afterward, you can install and update Docker EE
from the repository.
#### Set up the repository
### Set up the repository
{% include ee-linux-install-reuse.md section="set-up-yum-repo" %}
#### Install Docker EE
{{ selinux-warning }}
### Install from the repository
{% include ee-linux-install-reuse.md section="install-using-yum-repo" %}
#### Upgrade Docker EE
### Upgrade from the repository
{% include ee-linux-install-reuse.md section="upgrade-using-yum-repo" %}
### Install from a package
## Package install and upgrade
{% include ee-linux-install-reuse.md section="package-installation" %}
{{ selinux-warning }}
### Install with a package
{% include ee-linux-install-reuse.md section="install-using-yum-package" %}
#### Upgrade Docker EE
### Upgrade with a package
{% include ee-linux-install-reuse.md section="upgrade-using-yum-package" %}
## Uninstall Docker EE
{% include ee-linux-install-reuse.md section="yum-uninstall" %}