diff --git a/_includes/ee-linux-install-reuse.md b/_includes/ee-linux-install-reuse.md new file mode 100644 index 0000000000..68848a580f --- /dev/null +++ b/_includes/ee-linux-install-reuse.md @@ -0,0 +1,343 @@ +{% assign section = include.section %} + +{% comment %} + +Include a chunk of this file, using variables already set in the file +where you want to reuse the chunk. + +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). + +{% elsif section == "ee-url-intro" %} + +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: + +- 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**. + +Use this URL when you see the placeholder text ``. + +To learn more about Docker EE, see +[Docker Enterprise Edition](https://www.docker.com/enterprise-edition/){: target="_blank" class="_" }. + + + +{% 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. + + + +{% elsif section == "set-up-yum-repo" %} + +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 will not persist when the current session ends. + + ```bash + $ export DOCKERURL='' + ``` + +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. + + ```bash + $ sudo 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`. + + {% 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. + + ```bash + $ sudo yum install -y yum-utils \ + device-mapper-persistent-data \ + lvm2 + ``` + +{% if linux-dist == "rhel" %} +5. 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 + ``` + + Depending on cloud provider, you may also need to enable another repository. + + For AWS: + + ```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: + + ```bash + $ sudo yum-config-manager --enable rhui-rhel-7-server-rhui-extras-rpms + ``` +{% endif %} + +6. Use the following command to add the **stable** repository: + + ```bash + $ sudo yum-config-manager \ + --add-repo \ + "$DOCKERURL/{{ linux-dist-url-slug }}/docker-ee.repo" + ``` + + +{% 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. + + ```bash + $ sudo yum -y install docker-ee + ``` + + If this is the first time you have refreshed the package index since adding + the Docker repositories, you will be prompted to accept the GPG key, and + the key's fingerprint will be shown. Verify that the fingerprint matches + `{{ gpg-fingerprint }}` and if so, accept the key. + +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. + + > **Note**: This `yum list` command only shows binary packages. To show + > source packages as well, omit the `.x86_64` from the package name. + + ```bash + $ sudo yum list docker-ee.x86_64 --showduplicates | sort -r + + docker-ee.x86_64 {{ minor-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 will be 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 (`-`): + + > **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`. + + ```bash + $ sudo yum -y install + ``` + + Docker is installed but not started. The `docker` group is created, but no + users are added to the group. + +3. Edit `/etc/docker/daemon.json`. If it does not yet exist, create it. Assuming + that the file was empty, add the following contents. + + ```json + { + "storage-driver": "devicemapper" + } + ``` + +4. For production systems, you must use `direct-lvm` mode, which requires you + to prepare the block devices. 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**. + +5. Start Docker. + + ```bash + $ sudo systemctl start docker + ``` + +6. Verify that Docker EE is installed correctly by running the `hello-world` + image. + + ```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](linux-postinstall.md) to allow +non-privileged users to run Docker commands and for other optional configuration +steps. + + + +{% elsif section == "upgrade-using-yum-repo" %} + +To upgrade Docker EE: + +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. Run `sudo yum makecache fast`. + +3. Follow the + [installation instructions](#install-docker), choosing the new version you + want to install. + + +{% 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 will 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`. + + ```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. +{% endif %} + +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-{{ minor-version }}/Packages` and + download the `.{{ package-format | downcase }}` file for the Docker version + you want to install. + + {% 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`. + + + {% endif %} + +2. Install Docker EE, changing the path below to the path where you downloaded + the Docker package. + + ```bash + $ 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. Edit `/etc/docker/daemon.json`. If it does not yet exist, create it. + Assuming that the file was empty, add the following contents. + + ```json + { + "storage-driver": "devicemapper" + } + ``` + +4. For production systems, you must use `direct-lvm` mode, which requires you + to prepare the block devices. 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**. + +5. Start Docker. + + ```bash + $ sudo systemctl start docker + ``` + +6. Verify that Docker EE is installed correctly by running the `hello-world` + image. + + ```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](linux-postinstall.md) +to allow non-privileged users to run Docker commands and for other optional +configuration steps. + + +{% 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. + +{% elsif section == "yum-uninstall" %} + +1. Uninstall the Docker EE package: + + ```bash + $ 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: + + ```bash + $ sudo rm -rf /var/lib/docker + ``` + +3. 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. + + +{% elsif section == "linux-install-nextsteps" %} + +- Continue to [Post-installation steps for Linux](/engine/installation/linux/linux-postinstall.md) + +- Continue with the [User Guide](/engine/userguide/index.md). + +{% endif %} \ No newline at end of file diff --git a/engine/installation/linux/docker-ce/centos.md b/engine/installation/linux/docker-ce/centos.md index 0a4815ac72..ee7a7515dd 100644 --- a/engine/installation/linux/docker-ce/centos.md +++ b/engine/installation/linux/docker-ce/centos.md @@ -80,7 +80,9 @@ from the repository. `devicemapper` storage driver. ```bash - $ sudo yum install -y yum-utils device-mapper-persistent-data lvm2 + $ sudo yum install -y yum-utils \ + device-mapper-persistent-data \ + lvm2 ``` 2. Use the following command to set up the **stable** repository. You always @@ -120,19 +122,7 @@ from the repository. #### Install Docker CE -1. Update the `yum` package index. - - ```bash - $ sudo yum makecache fast - ``` - - If this is the first time you have refreshed the package index since adding - the Docker repositories, you will be prompted to accept the GPG key, and - the key's fingerprint will be shown. Verify that the fingerprint is - correct, and if so, accept the key. The fingerprint should match - `060A 61C5 1B55 8A7F 742B 77AA C52F EB6B 621E 9F35`. - -2. Install the latest version of Docker CE, or go to the next step to install a +1. Install the latest version of Docker CE, or go to the next step to install a specific version. ```bash @@ -145,10 +135,16 @@ from the repository. > which may not be appropriate for your stability needs. {:.warning} + If this is the first time you have refreshed the package index since adding + the Docker repositories, you will be prompted to accept the GPG key, and + the key's fingerprint will be shown. Verify that the fingerprint is + correct, and if so, accept the key. The fingerprint should match + `060A 61C5 1B55 8A7F 742B 77AA C52F EB6B 621E 9F35`. + Docker is installed but not started. The `docker` group is created, but no users are added to the group. -3. On production systems, you should install a specific version of Docker CE +2. On production systems, you should install a specific version of Docker CE 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. @@ -159,28 +155,33 @@ from the repository. ```bash $ yum list docker-ce.x86_64 --showduplicates | sort -r - docker-ce.x86_64 {{ minor-version }}.0.el7 docker-ce-stable + docker-ce.x86_64 {{ minor-version }}.ce-1.el7.centos docker-ce-stable ``` The contents of the list depend upon which repositories are enabled, and will be specific to your version of CentOS (indicated by the `.el7` 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 a hyphen (`-`): + 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 (`-`). + + > **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-ce-17.06.1.ce`. ```bash - $ sudo yum install docker-ce- + $ sudo yum install ``` -4. Start Docker. +3. Start Docker. ```bash $ sudo systemctl start docker ``` -5. Verify that `docker` is installed correctly by running the `hello-world` +4. Verify that `docker` is installed correctly by running the `hello-world` image. ```bash diff --git a/engine/installation/linux/docker-ce/debian.md b/engine/installation/linux/docker-ce/debian.md index 6924970c30..7e494ab736 100644 --- a/engine/installation/linux/docker-ce/debian.md +++ b/engine/installation/linux/docker-ce/debian.md @@ -124,7 +124,9 @@ from the repository. $ curl -fsSL {{ download-url-base}}/gpg | sudo apt-key add - ``` - Verify that the key ID is `9DC8 5822 9FC7 DD38 854A E2D8 8D81 803C 0EBF CD88`. + Verify that you now have the key with the fingerprint + `9DC8 5822 9FC7 DD38 854A E2D8 8D81 803C 0EBF CD88`, by searching for the + last 8 characters of the fingerprint. ```bash $ sudo apt-key fingerprint 0EBFCD88 diff --git a/engine/installation/linux/docker-ce/fedora.md b/engine/installation/linux/docker-ce/fedora.md index d4b4371d14..f1734f926a 100644 --- a/engine/installation/linux/docker-ce/fedora.md +++ b/engine/installation/linux/docker-ce/fedora.md @@ -11,7 +11,7 @@ title: Get Docker CE for Fedora To get started with Docker CE on Fedora, make sure you [meet the prerequisites](#prerequisites), then -[install Docker](#install-docker-ce). +[install Docker](#install-docker). ## Prerequisites @@ -27,11 +27,6 @@ To install Docker, you need the 64-bit version of one of these Fedora versions: - 24 - 25 -- 26 - - -> **Note**: Fedora 26 packages are currently only available in the **edge** -> and **test** repositories. ### Uninstall old versions @@ -87,7 +82,7 @@ from the repository. 2. Use the following command to set up the **stable** repository. You always need the **stable** repository, even if you want to install builds from the - **edge** or **test** repositories as well. + **edge** or **testing** repositories as well. ```bash $ sudo dnf config-manager \ @@ -95,23 +90,19 @@ from the repository. {{ download-url-base }}/docker-ce.repo ``` -3. **Optional**: Enable the **edge** and **test** repositories. These +3. **Optional**: Enable the **edge** and **testing** repositories. These repositories are included in the `docker.repo` file above but are disabled by default. You can enable them alongside the stable repository. - - - > **Note**: Fedora 26 packages are currently only available in the **edge** - > and **test** repositories. ```bash $ sudo dnf config-manager --set-enabled docker-ce-edge ``` ```bash - $ sudo dnf config-manager --set-enabled docker-ce-test + $ sudo dnf config-manager --set-enabled docker-ce-testing ``` - You can disable the **edge** or **test** repository by running the + You can disable the **edge** or **testing** repository by running the `dnf config-manager` command with the `--disable` flag. To re-enable it, use the `--enable` flag. The following command disables the **edge** repository. @@ -120,7 +111,7 @@ from the repository. ``` > **Note**: Starting with Docker 17.06, stable releases are also pushed to - > the **edge** and **test** repositories. + > the **edge** and **testing** repositories. [Learn about **stable** and **edge** channels](/engine/installation/). @@ -151,7 +142,7 @@ from the repository. > or updating without specifying a version in the `dnf install` or > `dnf update` command will always install the highest possible version, > which may not be appropriate for your stability needs. - {:.warning} + {:.warning-vanilla} 3. On production systems, you should install a specific version of Docker CE instead of always using the latest. List the available versions. This diff --git a/engine/installation/linux/docker-ce/ubuntu.md b/engine/installation/linux/docker-ce/ubuntu.md index d8603c5bf7..d783644d40 100644 --- a/engine/installation/linux/docker-ce/ubuntu.md +++ b/engine/installation/linux/docker-ce/ubuntu.md @@ -12,7 +12,7 @@ title: Get Docker CE for Ubuntu To get started with Docker CE on Ubuntu, make sure you [meet the prerequisites](#prerequisites), then -[install Docker](#install-docker-ce). +[install Docker](#install-docker). ## Prerequisites @@ -34,9 +34,10 @@ versions: - Xenial 16.04 (LTS) - Trusty 14.04 (LTS) -Docker CE is supported on Ubuntu on `x86_64` (or `amd64`), `armhf`, and `s390x` (IBM Z) architectures. +Docker CE is supported on Ubuntu on `x86_64`, `armhf`, and `s390x` (IBM z +Systems) architectures. -> **`s390x` limitations**: IBM Z is only supported on Ubuntu Xenial and Zesty. +> **`s390x` limitations**: System Z is only supported on Ubuntu Xenial and Zesty. ### Uninstall old versions @@ -118,7 +119,9 @@ the repository. $ curl -fsSL {{ download-url-base }}/gpg | sudo apt-key add - ``` - Verify that the key fingerprint is `9DC8 5822 9FC7 DD38 854A E2D8 8D81 803C 0EBF CD88`. + Verify that you now have the key with the fingerprint + `9DC8 5822 9FC7 DD38 854A E2D8 8D81 803C 0EBF CD88`, by searching for the + last 8 characters of the fingerprint. ```bash $ sudo apt-key fingerprint 0EBFCD88 @@ -131,8 +134,8 @@ the repository. 4. Use the following command to set up the **stable** repository. You always need the **stable** repository, even if you want to install builds from the - **edge** or **test** repositories as well. To add the **edge** or - **test** repository, add the word `edge` or `test` (or both) after the + **edge** or **testing** repositories as well. To add the **edge** or + **testing** repository, add the word `edge` or `testing` (or both) after the word `stable` in the commands below. > **Note**: The `lsb_release -cs` sub-command below returns the name of your @@ -141,7 +144,7 @@ the repository. > to your parent Ubuntu distribution. For example, if you are using > `Linux Mint Rafaela`, you could use `trusty`. - **x86_64**: + **amd64**: ```bash $ sudo add-apt-repository \ @@ -169,7 +172,7 @@ the repository. ``` > **Note**: Starting with Docker 17.06, stable releases are also pushed to - > the **edge** and **test** repositories. + > the **edge** and **testing** repositories. [Learn about **stable** and **edge** channels](/engine/installation/). @@ -195,7 +198,7 @@ the repository. > or updating without specifying a version in the `apt-get install` or > `apt-get update` command will always install the highest possible version, > which may not be appropriate for your stability needs. - {:.warning} + {:.warning-vanilla} 3. On production systems, you should install a specific version of Docker CE instead of always using the latest. This output is truncated. List the @@ -227,17 +230,11 @@ the repository. $ sudo docker run hello-world ``` - or if you run on armhf: - -    ```bash - $ sudo docker run armhf/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 CE is installed and running. You need to use `sudo` to run Docker -commands. Continue to [Linux postinstall](../linux-postinstall.md) to allow +Docker CE is installed and running. You need to use `sudo` to run Docker commands. +Continue to [Linux postinstall](../linux-postinstall.md) to allow non-privileged users to run Docker commands and for other optional configuration steps. diff --git a/engine/installation/linux/docker-ee/centos.md b/engine/installation/linux/docker-ee/centos.md index 012600c27e..d7846c0b09 100644 --- a/engine/installation/linux/docker-ee/centos.md +++ b/engine/installation/linux/docker-ee/centos.md @@ -7,46 +7,37 @@ title: Get Docker EE for CentOS --- {% assign minor-version = "17.06" %} +{% assign linux-dist = "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" %} -To get started with Docker EE on CentOS, make sure you -[meet the prerequisites](#prerequisites), then -[install Docker EE](#install-docker-ee). +{% include ee-linux-install-reuse.md section="ee-install-intro" %} ## Prerequisites Docker CE users should go to -[Get docker CE for CentOS](/engine/installation/linux/docker-ce/centos.md) +[Get docker CE for CentOS](https://docs.docker.com/engine/installation/linux/docker-ce/centos/) **instead of this topic**. -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 CentOS and for Docker EE for Linux, which includes access -to Docker EE for all Linux distributions.To get this information: +### Docker EE repository URL -- 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 CentOS**. -- Copy the URL from the field labeled - **Copy and paste this URL to download your Edition**. - -Use this URL when you see the placeholder text ``. - -To learn more about Docker EE, see -[Docker Enterprise Edition](https://www.docker.com/enterprise-edition/){: 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. +{% include ee-linux-install-reuse.md section="ee-url-intro" %} ### OS requirements -To install Docker EE, you need the 64-bit version of CentOS 7. +To install Docker EE, you need the 64-bit version of {{ linux-dist-long}} 7. The `centos-extras` repository must be enabled. This repository is enabled by default, but if you have disabled it, you need to [re-enable it](https://wiki.centos.org/AdditionalResources/Repositories){: 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. + ### Uninstall old versions Older versions of Docker were called `docker` or `docker-engine`. In addition, @@ -68,16 +59,7 @@ networks, are preserved. The Docker EE package is now called `docker-ee`. ## Install Docker EE -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 RPM 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. +{% include ee-linux-install-reuse.md section="ways-to-install" %} ### Install using the repository @@ -87,225 +69,28 @@ EE from the repository. #### Set up the repository -1. Remove any existing Docker repositories from `/etc/yum.repos.d/`. - -2. Store your Docker EE repository URL in a `yum` variable in `/etc/yum/vars/`. - Replace `` with the URL you noted down in the - [prerequisites](#prerequisites). - - ```bash - $ sudo sh -c 'echo "/centos" > /etc/yum/vars/dockerurl' - ``` - -3. 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 device-mapper-persistent-data lvm2 - ``` - -4. Use the following command to add the **stable** repository: - - ```bash - $ sudo yum-config-manager \ - --add-repo \ - /centos/docker-ee.repo - ``` +{% include ee-linux-install-reuse.md section="set-up-yum-repo" %} #### Install Docker EE -1. Update the `yum` package index. - - ```bash - $ sudo yum makecache fast - ``` - - If this is the first time you have refreshed the package index since adding - the Docker repositories, you will be prompted to accept the GPG key, and - the key's fingerprint will be shown. Verify that the fingerprint is - correct, and if so, accept the key. The fingerprint should match - `DD91 1E99 5A64 A202 E859 07D6 BC14 F10B 6D08 5F96`. - -2. Install the latest version of Docker EE, or go to the next step to install a - specific version. - - ```bash - $ sudo yum install docker-ee - ``` - - > **Warning**: If you have multiple Docker repositories enabled, installing - > or updating without specifying a version in the `yum install` or - > `yum update` command will always install the highest possible version, - > which may not be appropriate for your stability needs. - {:.warning} - - Docker is installed but not started. The `docker` group is created, but no - users are added to the group. - -3. 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. - - > **Note**: This `yum list` command only shows binary packages. To show - > source packages as well, omit the `.x86_64` from the package name. - - ```bash - $ yum list docker-ee.x86_64 --showduplicates | sort -r - - docker-ee.x86_64 {{ minor-version }}.0.el7 docker-ee-stable - ``` - - The contents of the list depend upon which repositories are enabled, and - will be specific to your version of CentOS (indicated by the `.el7` 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 a hyphen (`-`): - - ```bash - $ sudo yum install docker-ee- - ``` - - Docker is installed but not started. The `docker` group is created, but no - users are added to the group. - -4. Edit `/etc/docker/daemon.json`. If it does not yet exist, create it. Assuming - that the file was empty, add the following contents. - - ```json - { - "storage-driver": "devicemapper" - } - ``` - -5. For production systems, you must use `direct-lvm` mode, which requires you - to prepare the block devices. 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**. Do not skip this step. - -6. Start Docker. - - ```bash - $ sudo systemctl start docker - ``` - -7. Verify that Docker EE is installed correctly by running the `hello-world` - image. - - ```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](/engine/installation/linux/linux-postinstall.md) -to allow non-privileged users to run Docker commands and for other optional -configuration steps. +{% include ee-linux-install-reuse.md section="install-using-yum-repo" %} #### Upgrade Docker EE -To upgrade Docker EE: - -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. Run `sudo yum makecache fast`. - -3. Follow the - [installation instructions](#install-docker), choosing the new version you want - to install. +{% include ee-linux-install-reuse.md section="upgrade-using-yum-repo" %} ### Install from a package -If you cannot use Docker's repository to install Docker EE, you can download the -`.rpm` file for your release and install it manually. You will need to download -a new file each time you want to upgrade Docker. - -1. Go to the Docker EE repository URL associated with your trial or - subscription in your browser. Go to - `centos/7/x86_64/stable-{{ minor-version }}/Packages/` and download the - `.rpm` file for the Docker version you want to install. - -2. Install Docker EE, changing the path below to the path where you downloaded - the Docker EE package. - - ```bash - $ 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. Edit `/etc/docker/daemon.json`. If it does not yet exist, create it. Assuming - that the file was empty, add the following contents. - - ```json - { - "storage-driver": "devicemapper" - } - ``` - -4. For production systems, you must use `direct-lvm` mode, which requires you - to prepare the block devices. 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**. Do not skip this step. - -5. Start Docker. - - ```bash - $ sudo systemctl start docker - ``` - -6. Verify that Docker EE is installed correctly by running the `hello-world` - image. - - ```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](linux-postinstall.md) to allow -non-privileged users to run Docker commands and for other optional configuration -steps. +{% include ee-linux-install-reuse.md section="install-using-yum-package" %} #### Upgrade Docker EE -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. +{% include ee-linux-install-reuse.md section="upgrade-using-yum-package" %} ## Uninstall Docker EE -1. Uninstall the Docker EE package: - - ```bash - $ sudo yum 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: - - ```bash - $ sudo rm -rf /var/lib/docker - ``` - -3. 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. +{% include ee-linux-install-reuse.md section="yum-uninstall" %} ## Next steps -- Continue to [Post-installation steps for Linux](/engine/installation/linux/linux-postinstall.md) - -- Continue with the [User Guide](/engine/userguide/index.md). +{% include ee-linux-install-reuse.md section="linux-install-nextsteps" %} diff --git a/engine/installation/linux/docker-ee/oracle.md b/engine/installation/linux/docker-ee/oracle.md index f8dca987b3..d1b741da5c 100644 --- a/engine/installation/linux/docker-ee/oracle.md +++ b/engine/installation/linux/docker-ee/oracle.md @@ -8,45 +8,36 @@ title: Get Docker EE for Oracle Linux --- {% assign minor-version = "17.06" %} +{% assign linux-dist = "oraclelinux" %} +{% 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 Oracle Linux, make sure you +To get started with Docker EE on {{ linux-dist-long }}, make sure you [meet the prerequisites](#prerequisites), then [install Docker](#install-docker-ee). ## Prerequisites -Docker Community Edition (Docker CE) is not supported on Oracle Linux. +Docker Community Edition (Docker CE) is not supported on {{ linux-dist-long }}. ### Docker EE repository URL -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 Oracle Linux and for Docker EE for Linux, which includes -access to Docker EE for all Linux distributions.To get this information: - -- 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 Oracle Linux**. -- Copy the URL from the field labeled - **Copy and paste this URL to download your Edition**. - -Use this URL when you see the placeholder text ``. - -To learn more about Docker EE, see -[Docker Enterprise Edition](https://www.docker.com/enterprise-edition/){: target="_blank" class="_" }. +{% include ee-linux-install-reuse.md section="ee-url-intro" %} ### OS requirements -To install Docker EE, you need the 64-bit version of Oracle Linux 7.3 running the -Red Hat Compatible kernel (RHCK) 3.10.0-514 or higher. Older versions of Oracle -Linux 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. 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. -> **Docker EE will not install on Oracle Linux with `selinux` enabled!** +> **Docker EE will not install on {{ linux-dist }} with `selinux` enabled!** > > If you have `selinux` enabled and you attempt to install Docker EE 17.06.1, > you will get an error that the `container-selinux` package cannot be found. @@ -70,16 +61,7 @@ networks, are preserved. The Docker EE package is now called `docker-ee`. ## Install Docker EE -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 RPM 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. +{% include ee-linux-install-reuse.md section="ways-to-install" %} ### Install using the repository @@ -89,215 +71,28 @@ from the repository. #### Set up the repository -1. Remove any existing Docker repositories from `/etc/yum.repos.d/`. - -2. Store your EE repository URL in `/etc/yum/vars/dockerurl`. Replace - `` with the URL you noted down in the - [prerequisites](#prerequisites). - - ```bash - $ sudo sh -c 'echo "/oraclelinux" > /etc/yum/vars/dockerurl' - ``` - -3. 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 device-mapper-persistent-data lvm2 container-selinux - ``` - -4. Use the following command to add the **stable** repository: - - ```bash - $ sudo yum-config-manager \ - --add-repo \ - /oraclelinux/docker-ee.repo - ``` +{% include ee-linux-install-reuse.md section="set-up-yum-repo" %} #### Install Docker EE -1. Update the `yum` package index. - - ```bash - $ sudo yum makecache fast - ``` - - If this is the first time you have refreshed the package index since adding - the Docker repositories, you will be prompted to accept the GPG key, and - the key's fingerprint will be shown. Verify that the fingerprint matches - `77FE DA13 1A83 1D29 A418 D3E8 99E5 FF2E 7668 2BC9` and if so, accept the - key. - -2. 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 - ``` - - Docker is installed but not started. The `docker` group is created, but no - users are added to the group. - -3. On production systems, you should install a specific version of Docker - 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. The output is truncated. - - > **Note**: This `yum list` command only shows binary packages. To show - > source packages as well, omit the `.x86_64` from the package name. - - ```bash - $ yum list docker-ee.x86_64 --showduplicates | sort -r - - docker-ee.x86_64 {{ minor-version }}.0.el7 docker-ee-stable - ``` - - The contents of the list depend upon which repositories you have enabled. - 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 a hyphen (`-`): - - ```bash - $ sudo yum -y install docker-ee- - ``` - -4. Edit `/etc/docker/daemon.json`. If it does not yet exist, create it. Assuming - that the file was empty, add the following contents. - - ```json - { - "storage-driver": "devicemapper" - } - ``` - -5. For production systems, you must use `direct-lvm` mode, which requires you - to prepare the block devices. 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**. - -6. Start the Docker daemon. - - ```bash - $ sudo systemctl start docker - ``` - -7. Verify that Docker EE is installed correctly by running the `hello-world` - image. - - ```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](linux-postinstall.md) to allow -non-privileged users to run Docker commands and for other optional configuration -steps. +{% include ee-linux-install-reuse.md section="install-using-yum-repo" %} #### Upgrade Docker EE -To upgrade Docker EE: - -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. Run `sudo yum makecache fast`. - -3. Follow the - [installation instructions](#install-docker), choosing the new version you want - to install. +{% include ee-linux-install-reuse.md section="upgrade-using-yum-repo" %} ### Install from a package -If you cannot use the official Docker repository to install Docker EE, you can -download the `.rpm` file for your release and install it manually. You will -need to download a new file each time you want to upgrade Docker EE. - -1. Go to the Docker EE repository URL associated with your - trial or subscription in your browser. Browse to - `oraclelinux/7/x86_64/stable-{{ minor-version }}/Packages` and download the - `.rpm` file for the Docker version you want to install. - -2. Install Docker EE, changing the path below to the path where you downloaded - the Docker package. - - ```bash - $ 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. Edit `/etc/docker/daemon.json`. If it does not yet exist, create it. Assuming - that the file was empty, add the following contents. - - ```json - { - "storage-driver": "devicemapper" - } - ``` - -4. For production systems, you must use `direct-lvm` mode, which requires you - to prepare the block devices. 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**. - -5. Start the Docker daemon. - - ```bash - $ sudo systemctl start docker - ``` - -6. Verify that Docker EE is installed correctly by running the `hello-world` - image. - - ```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](linux-postinstall.md) -to allow non-privileged users to run Docker commands and for other optional -configuration steps. +{% include ee-linux-install-reuse.md section="install-using-yum-package" %} #### Upgrade Docker EE -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. +{% include ee-linux-install-reuse.md section="upgrade-using-yum-package" %} ## Uninstall Docker EE -1. Uninstall the Docker EE package: - - ```bash - $ sudo yum 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: - - ```bash - $ sudo rm -rf /var/lib/docker - ``` - -3. 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. +{% include ee-linux-install-reuse.md section="yum-uninstall" %} ## Next steps -- Continue to [Post-installation steps for Linux](/engine/installation/linux/linux-postinstall.md) - -- Continue with the [User Guide](/engine/userguide/index.md). +{% include ee-linux-install-reuse.md section="linux-install-nextsteps" %} diff --git a/engine/installation/linux/docker-ee/rhel.md b/engine/installation/linux/docker-ee/rhel.md index 017e2818ec..d854bb6222 100644 --- a/engine/installation/linux/docker-ee/rhel.md +++ b/engine/installation/linux/docker-ee/rhel.md @@ -9,37 +9,26 @@ title: Get Docker EE for Red Hat Enterprise Linux --- {% assign minor-version = "17.06" %} +{% assign linux-dist = "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" %} -To get started with Docker EE on Red Hat Enterprise Linux (RHEL), 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 RHEL. +Docker Community Edition (Docker CE) is not supported on {{ linux-dist-long }}. ### Docker EE repository URL -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 RHEL and for Docker EE for Linux, which includes access -to Docker EE for all Linux distributions. To get this information: - -- 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 Red Hat Enterprise Linux**. -- Copy the URL from the field labeled - **Copy and paste this URL to download your Edition**. - -Use this URL when you see the placeholder text ``. - -To learn more about Docker EE, see -[Docker Enterprise Edition](https://www.docker.com/enterprise-edition/){: target="_blank" class="_" }. +{% include ee-linux-install-reuse.md section="ee-url-intro" %} ### OS requirements -To install Docker EE, you need the 64-bit version of RHEL 7 running on an x86 -hardware platform, or `s390x` (IBM Z) architecture. +To install Docker EE, you need the 64-bit version of {{ linux-dist-long }} 7 +running on an x86 hardware platform, or `s390x` (IBM Z) architecture. In addition, you must use the `devicemapper` storage driver. On production systems, you must use `direct-lvm` mode, which requires one or more dedicated @@ -65,16 +54,7 @@ networks, are preserved. The Docker EE package is now called `docker-ee`. ## Install Docker EE -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 RPM 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. +{% include ee-linux-install-reuse.md section="ways-to-install" %} ### Install using the repository @@ -84,271 +64,28 @@ from the repository. #### Set up the repository -1. Remove any existing Docker repositories from `/etc/yum.repos.d/`. - -2. Store two `yum` variables in `/etc/yum/vars/`. - - - Store your EE repository URL in `/etc/yum/vars/dockerurl`. Replace - `` with the URL you noted down in the - [prerequisites](#prerequisites). - - ```bash - $ sudo sh -c 'echo "/rhel" > /etc/yum/vars/dockerurl' - ``` - - - Store your RHEL version string in `/etc/yum/vars/dockerosversion`. - Use the appropriate value from the following table. Most users should use - `7`. - - | Version string | Description | - |----------------|-------------| - | `7` | Unless you have specific requirements, you should use this version. Dependencies are not locked to specific versions but use the latest available version. | - | `7.3` | Dependencies are locked to specific packages for RHEL 7.3. | - | `7.2` | Dependencies are locked to specific packages for RHEL 7.2. | - - ```bash - $ sudo sh -c 'echo "" > /etc/yum/vars/dockerosversion' - ``` - -3. 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 device-mapper-persistent-data lvm2 - ``` - -4. 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 - ``` - - Depending on cloud provider, you may also need to enable another repository. - - For AWS: - - ```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: - - ```bash - $ sudo yum-config-manager --enable rhui-rhel-7-server-rhui-extras-rpms - ``` - -5. Use the following command to add the **stable** repository: - - ```bash - $ sudo yum-config-manager \ - --add-repo \ - /rhel/docker-ee.repo - ``` +{% include ee-linux-install-reuse.md section="set-up-yum-repo" %} #### Install Docker EE -1. Update the `yum` package index. - - ```bash - $ sudo yum makecache fast - ``` - - If this is the first time you have refreshed the package index since adding - the Docker repositories, you will be prompted to accept the GPG key, and - the key's fingerprint will be shown. Verify that the fingerprint matches - `DD91 1E99 5A64 A202 E859 07D6 BC14 F10B 6D08 5F96` and if so, accept the - key. - -2. 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 - ``` - -3. 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. - - > **Note**: This `yum list` command only shows binary packages. To show - > source packages as well, omit the `.x86_64` from the package name. - - ```bash - $ yum list docker-ee.x86_64 --showduplicates | sort -r - - docker-ee.x86_64 {{ minor-version }}.0.el7 docker-ee-stable - ``` - - The contents of the list depend upon which repositories you have enabled, - and will be specific to your version of RHEL (indicated by the `.el7` 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 a hyphen (`-`): - - ```bash - $ sudo yum -y install docker-ee- - ``` - - Docker is installed but not started. The `docker` group is created, but no - users are added to the group. - -4. Edit `/etc/docker/daemon.json`. If it does not yet exist, create it. Assuming - that the file was empty, add the following contents. - - ```json - { - "storage-driver": "devicemapper" - } - ``` - -5. For production systems, you must use `direct-lvm` mode, which requires you - to prepare the block devices. 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**. - -6. Start Docker. - - ```bash - $ sudo systemctl start docker - ``` - -7. Verify that Docker EE is installed correctly by running the `hello-world` - image. - - ```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](linux-postinstall.md) to allow -non-privileged users to run Docker commands and for other optional configuration -steps. +{% include ee-linux-install-reuse.md section="install-using-yum-repo" %} #### Upgrade Docker EE -To upgrade Docker EE: - -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. Run `sudo yum makecache fast`. - -3. Follow the - [installation instructions](#install-docker), choosing the new version you want - to install. +{% include ee-linux-install-reuse.md section="upgrade-using-yum-repo" %} ### Install from a package -If you cannot use the official Docker repository to install Docker EE, you can -download the `.rpm` file for your release and install it manually. You will -need to download a new file each time you want to upgrade 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. - -1. Go to the Docker EE repository URL associated with your - trial or subscription in your browser. Go to - `rhel/7/x86_64/stable-{{ minor-version }}/Packages` and download the `.rpm` - file for the Docker version you want to install. - - > **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`. - -2. Install Docker EE, changing the path below to the path where you downloaded - the Docker package. - - ```bash - $ 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. Edit `/etc/docker/daemon.json`. If it does not yet exist, create it. Assuming - that the file was empty, add the following contents. - - ```json - { - "storage-driver": "devicemapper" - } - ``` - -4. For production systems, you must use `direct-lvm` mode, which requires you - to prepare the block devices. 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**. - -5. Start Docker. - - ```bash - $ sudo systemctl start docker - ``` - -6. Verify that Docker EE is installed correctly by running the `hello-world` - image. - - ```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](linux-postinstall.md) -to allow non-privileged users to run Docker commands and for other optional -configuration steps. +{% include ee-linux-install-reuse.md section="install-using-yum-package" %} #### Upgrade Docker EE -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. - +{% include ee-linux-install-reuse.md section="upgrade-using-yum-package" %} ## Uninstall Docker EE -1. Uninstall the Docker EE package: - - ```bash - $ 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: - - ```bash - $ sudo rm -rf /var/lib/docker - ``` - -3. 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. +{% include ee-linux-install-reuse.md section="yum-uninstall" %} ## Next steps -- Continue to [Post-installation steps for Linux](/engine/installation/linux/linux-postinstall.md) - -- Continue with the [User Guide](/engine/userguide/index.md). +{% include ee-linux-install-reuse.md section="linux-install-nextsteps" %} diff --git a/engine/installation/linux/docker-ee/ubuntu.md b/engine/installation/linux/docker-ee/ubuntu.md index 8a9c548e6c..ed86828535 100644 --- a/engine/installation/linux/docker-ee/ubuntu.md +++ b/engine/installation/linux/docker-ee/ubuntu.md @@ -118,15 +118,17 @@ from the repository. $ curl -fsSL /ubuntu/gpg | sudo apt-key add - ``` - Verify that the key fingerprint is `DD91 1E99 5A64 A202 E859 07D6 BC14 F10B 6D08 5F96`. + 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 8 characters of the fingerprint. ```bash - $ apt-key fingerprint 6D085F96 + $ sudo apt-key fingerprint 6D085F96 - pub 4096R/6D085F96 2017-02-22 - Key fingerprint = DD91 1E99 5A64 A202 E859 07D6 BC14 F10B 6D08 5F96 - uid [ultimate] Docker Release (EE deb) - sub 4096R/91A29FA3 2017-02-22 + pub 4096R/0EBFCD88 2017-02-22 + Key fingerprint = DD91 1E99 5A64 A202 E859 07D6 BC14 F10B 6D08 5F96 + uid Docker Release (CE deb) + sub 4096R/6D085F96 2017-02-22 ``` 4. Use the following command to set up the **stable** repository, replacing