Addressing feedback from new installation instructions #1172
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,6 +1,6 @@ | ||
| --- | ||
| description: Instructions for installing Docker on Oracle Linux | ||
| keywords: Docker, Docker documentation, requirements, installation, oracle, ol, rpm, install, uninstall, upgrade, update | ||
| redirect_from: | ||
| - /engine/installation/oracle/ | ||
| title: Get Docker for Oracle Linux | ||
|
|
@@ -14,9 +14,13 @@ To get started with Docker on Oracle Linux, make sure you | |
|
|
||
| ### OS requirements | ||
|
|
||
| To install Docker, you need the 64-bit version of Oracle Linux 6 or 7. | ||
|
|
||
| To use `btrfs`, you need to install the Unbreakable Enterprise Kernel (UEK) | ||
|
There was a problem hiding this comment. This is not just required for Though, I guess this is somewhat of a moot point, because the rest of the documentation outlines how to install a completely unsupported version of Docker anyway. |
||
| version 4.1.12 or higher. running the Unbreakable Enterprise Kernel Release 4 | ||
| (4.1.12) or higher. For Oracle Linux 6, you need to enable extra repositories | ||
| to install UEK4. See | ||
| [Obtaining and installing the UEK packages](https://docs.oracle.com/cd/E37670_01/E37355/html/ol_obtain_uek.html){: target="_blank" class="_" }. | ||
|
|
||
| ### Remove unofficial Docker packages | ||
|
|
||
|
|
@@ -56,15 +60,33 @@ Docker from the repository. | |
|
|
||
| #### Set up the repository | ||
|
|
||
| 1. Install the `yum-utils` plugin, which provides the `yum-config-manager` | ||
| plugin. | ||
|
|
||
| ```bash | ||
| $ sudo yum install -y yum-utils | ||
| ``` | ||
|
|
||
| 2. Use one of the following commands to set up the **stable** repository, | ||
| depending on your version of Oracle Linux: | ||
|
|
||
| **Oracle Linux 7**: | ||
|
|
||
| ```bash | ||
| $ sudo yum-config-manager \ | ||
| --add-repo \ | ||
| https://docs.docker.com/engine/installation/linux/repo_files/oracle/docker-ol7.repo | ||
| ``` | ||
|
|
||
| **Oracle Linux 6**: | ||
|
|
||
| ```bash | ||
| $ sudo yum-config-manager \ | ||
| --add-repo \ | ||
| https://docs.docker.com/engine/installation/linux/repo_files/oracle/docker-ol6.repo | ||
| ``` | ||
|
|
||
| 3. **Optional**: Enable the **testing** repository. This repository is included | ||
| in the `docker.repo` file above but is disabled by default. You can enable | ||
| it alongside the stable repository. Do not use unstable repositories on | ||
| on production systems or for non-testing workloads. | ||
|
|
@@ -75,16 +97,16 @@ Docker from the repository. | |
| > which will almost certainly be an unstable one. | ||
|
|
||
| ```bash | ||
| $ sudo yum-config-manager --enablerepo docker-testing | ||
| ``` | ||
|
|
||
| You can disable the `testing` repository by running the `yum-config-manager` | ||
| command with the `--disablerepo` flag. To re-enable it, use the | ||
| `--set-enabled` flag. The following command disables the `testing` | ||
| repository. | ||
|
|
||
| ```bash | ||
| $ sudo yum-config-manager --disablerepo docker-testing | ||
| ``` | ||
|
|
||
| #### Install Docker | ||
|
|
@@ -94,7 +116,27 @@ Docker from the repository. | |
| ```bash | ||
| $ sudo yum -y check-update | ||
|
There was a problem hiding this comment. This command does not update the |
||
| ``` | ||
|
|
||
| 2. Verify and import Docker's public key, which is used to sign packages in | ||
|
There was a problem hiding this comment. This entire step is not required because you specify the GPG key in the YUM repository configuration and you've enabled GPG checking as part of the yum install process. Therefore, the install of the GPG will automatically be triggered by YUM when the package is installed. Thus, this step should be removed and an additional step should be added later to verify the GPG key when the |
||
| Docker's repository. | ||
|
|
||
| First, verify that the fingerprint is `58118E89F3A912897C070ADBF76221572C52609D`: | ||
|
|
||
| ```bash | ||
| $ curl -s https://yum.dockerproject.org/gpg | gpg --quiet --with-fingerprint | ||
|
|
||
| pub 4096R/2C52609D 2015-07-14 | ||
| Key fingerprint = 5811 8E89 F3A9 1289 7C07 0ADB F762 2157 2C52 609D | ||
| uid Docker Release Tool (releasedocker) <docker@docker.com> | ||
| ``` | ||
|
|
||
| If the fingerprint matches, import the key: | ||
|
|
||
| ```bash | ||
| $ sudo rpm --import https://yum.dockerproject.org/gpg | ||
| ``` | ||
|
|
||
| 3. Install the latest version of Docker, or go to the next step to install a | ||
| specific version. | ||
|
|
||
| ```bash | ||
|
|
@@ -106,29 +148,21 @@ Docker from the repository. | |
| > `yum install` or `yum upgrade` command will always install the highest | ||
| > available version, which will almost certainly be an unstable one. | ||
|
|
||
| 4. On production systems, you should install a specific version of Docker | ||
|
There was a problem hiding this comment. There is no explanation of why you should install a specific version of Docker, nor how to decide which version to install. In the absence of this decision-making guidance, the best advice should be to install the latest stable version, which is what would happen automatically if the |
||
| 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-engine.x86_64 --showduplicates |sort -nr | ||
|
|
||
| docker-engine.x86_64 1.13.0-1.el6 docker-main | ||
| docker-engine.x86_64 1.12.3-1.el6 docker-main | ||
| docker-engine.x86_64 1.12.2-1.el6 docker-main | ||
| docker-engine.x86_64 1.12.1-1.el6 docker-main | ||
| ``` | ||
|
|
||
| The contents of the list depend upon which repositories you have enabled, | ||
|
|
@@ -144,9 +178,24 @@ Docker from the repository. | |
| $ sudo yum -y install docker-engine-<VERSION_STRING> | ||
|
There was a problem hiding this comment. I would remove the |
||
| ``` | ||
|
|
||
| The Docker daemon does not start automatically. | ||
|
|
||
| 5. Start the Docker daemon. Use `systemctl` on Oracle Linux 7 or `service` on | ||
| Oracle Linux 6. | ||
|
|
||
| **Oracle Linux 7**: | ||
|
|
||
| ```bash | ||
| $ sudo systemctl start docker | ||
|
There was a problem hiding this comment. You also need to run |
||
| ``` | ||
|
|
||
| **Oracle Linux 6**: | ||
|
|
||
| ```bash | ||
| $ sudo service docker start | ||
|
There was a problem hiding this comment. You also need to run |
||
| ``` | ||
|
|
||
| 6. Verify that `docker` is installed correctly by running the `hello-world` | ||
| image. | ||
|
|
||
| ```bash | ||
|
|
@@ -187,9 +236,24 @@ a new file each time you want to upgrade Docker. | |
| $ sudo yum install /path/to/package.rpm | ||
| ``` | ||
|
|
||
| The Docker daemon does not start automatically. | ||
|
There was a problem hiding this comment. Step 6 appears to be a duplication of information from step 4. Perhaps it should be split out into its own section on "Enabling and Starting the Docker daemon" which covers both install options. |
||
|
|
||
| 4. Start the Docker daemon. Use `systemctl` on Oracle Linux 7 or `service` on | ||
| Oracle Linux 6. | ||
|
|
||
| **Oracle Linux 7**: | ||
|
|
||
| ```bash | ||
| $ sudo systemctl start docker | ||
| ``` | ||
|
|
||
| **Oracle Linux 6**: | ||
|
|
||
| ```bash | ||
| $ sudo service docker start | ||
| ``` | ||
|
|
||
| 5. Verify that `docker` is installed correctly by running the `hello-world` | ||
| image. | ||
|
|
||
| ```bash | ||
|
|
@@ -210,7 +274,6 @@ To upgrade Docker, download the newer package file and repeat the | |
| [installation procedure](#install-from-a-package), using `yum -y upgrade` | ||
|
There was a problem hiding this comment. Why are you advocating the use of the |
||
| instead of `yum -y install`, and pointing to the new file. | ||
|
|
||
| ## Uninstall Docker | ||
|
|
||
| 1. Uninstall the Docker package: | ||
|
|
@@ -227,6 +290,11 @@ instead of `yum -y install`, and pointing to the new file. | |
| $ sudo rm -rf /var/lib/docker | ||
| ``` | ||
|
|
||
| > **Note**: This won't work when the `btrfs` graph driver has been used, | ||
|
There was a problem hiding this comment. "This won't work" implies that it's somehow broken instead of addressing the fact that Docker creates Rather, it should be something like "If you're using the |
||
| > because the `rm -rf` command cannot remove the subvolumes that Docker | ||
| > creates. See the output of `man btrfs-subvolume` for information on | ||
| > removing `btrfs` subvolumes. | ||
|
There was a problem hiding this comment. Add something like, "Subvolumes need to be removed before the rest of the |
||
|
|
||
| You must delete any edited configuration files manually. | ||
|
|
||
| ## Next steps | ||
|
|
||
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
It would still be great to have a link to the official Oracle Linux Docker User Guide to help guide users to the installation process for the fully supported Docker release from Oracle.