Browse code
Add Oracle Linux specific documentation for installation of Docker from Oracle Linux repositories on Oracle Linux 6 and 7.
Signed-off-by: Avi Miller <avi.miller@oracle.com>
Avi Miller authored on 2014/08/26 09:28:41Showing 2 changed files
| ... | ... |
@@ -34,6 +34,7 @@ pages: |
| 34 | 34 |
- ['installation/mac.md', 'Installation', 'Mac OS X'] |
| 35 | 35 |
- ['installation/ubuntulinux.md', 'Installation', 'Ubuntu'] |
| 36 | 36 |
- ['installation/rhel.md', 'Installation', 'Red Hat Enterprise Linux'] |
| 37 |
+- ['installation/oracle.md', 'Installation', 'Oracle Linux'] |
|
| 37 | 38 |
- ['installation/centos.md', 'Installation', 'CentOS'] |
| 38 | 39 |
- ['installation/debian.md', 'Installation', 'Debian'] |
| 39 | 40 |
- ['installation/gentoolinux.md', 'Installation', 'Gentoo'] |
| 40 | 41 |
new file mode 100644 |
| ... | ... |
@@ -0,0 +1,120 @@ |
| 0 |
+page_title: Installation on Oracle Linux |
|
| 1 |
+page_description: Installation instructions for Docker on Oracle Linux. |
|
| 2 |
+page_keywords: Docker, Docker documentation, requirements, linux, rhel, centos, oracle, ol |
|
| 3 |
+ |
|
| 4 |
+# Oracle Linux 6 and 7 |
|
| 5 |
+ |
|
| 6 |
+You do not require an Oracle Linux Support subscription to install Docker on |
|
| 7 |
+Oracle Linux. |
|
| 8 |
+ |
|
| 9 |
+*For Oracle Linux customers with an active support subscription:* |
|
| 10 |
+Docker is available in either the `ol6_x86_64_addons` or `ol7_x86_64_addons` |
|
| 11 |
+channel for Oracle Linux 6 and Oracle Linux 7 on the [Unbreakable Linux Network |
|
| 12 |
+(ULN)](https://linux.oracle.com). |
|
| 13 |
+ |
|
| 14 |
+*For Oracle Linux users without an active support subscription:* |
|
| 15 |
+Docker is available in the appropriate `ol6_addons` or `ol7_addons` repository |
|
| 16 |
+on [Oracle Public Yum](http://public-yum.oracle.com). |
|
| 17 |
+ |
|
| 18 |
+Docker requires the use of the Unbreakable Enterprise Kernel Release 3 (3.8.13) |
|
| 19 |
+or higher on Oracle Linux. This kernel supports the Docker btrfs storage engine |
|
| 20 |
+on both Oracle Linux 6 and 7. |
|
| 21 |
+ |
|
| 22 |
+Due to current Docker limitations, Docker is only able to run only on the x86_64 |
|
| 23 |
+architecture. |
|
| 24 |
+ |
|
| 25 |
+## To enable the *addons* channel via the Unbreakable Linux Network: |
|
| 26 |
+ |
|
| 27 |
+1. Enable either the *ol6\_x86\_64\_addons* or *ol7\_x86\_64\_addons* channel |
|
| 28 |
+via the ULN web interface. |
|
| 29 |
+Consult the [Unbreakable Linux Network User's |
|
| 30 |
+Guide](http://docs.oracle.com/cd/E52668_01/E39381/html/index.html) for |
|
| 31 |
+documentation on subscribing to channels. |
|
| 32 |
+ |
|
| 33 |
+## To enable the *addons* repository via Oracle Public Yum: |
|
| 34 |
+ |
|
| 35 |
+The latest release of Oracle Linux 6 and 7 are automatically configured to use |
|
| 36 |
+the Oracle Public Yum repositories during installation. However, the *addons* |
|
| 37 |
+repository is not enabled by default. |
|
| 38 |
+ |
|
| 39 |
+To enable the *addons* repository: |
|
| 40 |
+ |
|
| 41 |
+1. Edit either `/etc/yum.repos.d/public-yum-ol6.repo` or |
|
| 42 |
+`/etc/yum.repos.d/public-yum-ol7.repo` |
|
| 43 |
+and set `enabled=1` in the `[ol6_addons]` or the `[ol7_addons]` stanza. |
|
| 44 |
+ |
|
| 45 |
+## To install Docker: |
|
| 46 |
+ |
|
| 47 |
+1. Ensure the appropriate *addons* channel or repository has been enabled. |
|
| 48 |
+ |
|
| 49 |
+2. Use yum to install the Docker package: |
|
| 50 |
+ |
|
| 51 |
+ $ sudo yum install docker |
|
| 52 |
+ |
|
| 53 |
+## To start Docker: |
|
| 54 |
+ |
|
| 55 |
+1. Now that it's installed, start the Docker daemon: |
|
| 56 |
+ |
|
| 57 |
+ 1. On Oracle Linux 6: |
|
| 58 |
+ |
|
| 59 |
+ $ sudo service docker start |
|
| 60 |
+ |
|
| 61 |
+ 2. On Oracle Linux 7: |
|
| 62 |
+ |
|
| 63 |
+ $ sudo systemctl start docker.service |
|
| 64 |
+ |
|
| 65 |
+2. If you want the Docker daemon to start automatically at boot: |
|
| 66 |
+ |
|
| 67 |
+ 1. On Oracle Linux 6: |
|
| 68 |
+ |
|
| 69 |
+ $ sudo chkconfig docker on |
|
| 70 |
+ |
|
| 71 |
+ 2. On Oracle Linux 7: |
|
| 72 |
+ |
|
| 73 |
+ $ sudo systemctl enable docker.service |
|
| 74 |
+ |
|
| 75 |
+**Done!** |
|
| 76 |
+ |
|
| 77 |
+## Using the btrfs storage engine |
|
| 78 |
+ |
|
| 79 |
+Docker on Oracle Linux 6 and 7 supports the use of the btrfs storage engine. |
|
| 80 |
+Before enabling btrfs support, ensure that `/var/lib/docker` is stored on a |
|
| 81 |
+btrfs-based filesystem. Review [Chapter |
|
| 82 |
+5](http://docs.oracle.com/cd/E37670_01/E37355/html/ol_btrfs.html) of the [Oracle |
|
| 83 |
+Linux Administrator's Solution |
|
| 84 |
+Guide](http://docs.oracle.com/cd/E37670_01/E37355/html/index.html) for details |
|
| 85 |
+on how to create and mount btrfs filesystems. |
|
| 86 |
+ |
|
| 87 |
+To enable btrfs support on Oracle Linux: |
|
| 88 |
+ |
|
| 89 |
+1. Ensure that `/var/lib/docker` is on a btrfs filesystem. |
|
| 90 |
+1. Edit `/etc/sysconfig/docker` and add `-s btrfs` to the `OTHER_ARGS` field. |
|
| 91 |
+2. Restart the Docker daemon: |
|
| 92 |
+ |
|
| 93 |
+You can now continue with the [Docker User Guide](/userguide/). |
|
| 94 |
+ |
|
| 95 |
+## Known issues |
|
| 96 |
+ |
|
| 97 |
+### Docker unmounts btrfs filesystem on shutdown |
|
| 98 |
+If you're running Docker using the btrfs storage engine and you stop the Docker |
|
| 99 |
+service, it will unmount the btrfs filesystem during the shutdown process. You |
|
| 100 |
+should ensure the filesystem is mounted properly prior to restarting the Docker |
|
| 101 |
+service. |
|
| 102 |
+ |
|
| 103 |
+On Oracle Linux 7, you can use a `systemd.mount` definition and modify the |
|
| 104 |
+Docker `systemd.service` to depend on the btrfs mount defined in systemd. |
|
| 105 |
+ |
|
| 106 |
+### SElinux Support on Oracle Linux 7 |
|
| 107 |
+SElinux must be set to `Permissive` or `Disabled` in `/etc/sysconfig/selinux` to |
|
| 108 |
+use the btrfs storage engine on Oracle Linux 7. |
|
| 109 |
+ |
|
| 110 |
+## Further issues? |
|
| 111 |
+ |
|
| 112 |
+If you have a current Basic or Premier Support Subscription for Oracle Linux, |
|
| 113 |
+you can report any issues you have with the installation of Docker via a Service |
|
| 114 |
+Request at [My Oracle Support](http://support.oracle.com). |
|
| 115 |
+ |
|
| 116 |
+If you do not have an Oracle Linux Support Subscription, you can use the [Oracle |
|
| 117 |
+Linux |
|
| 118 |
+Forum](https://community.oracle.com/community/server_%26_storage_systems/linux/ |
|
| 119 |
+oracle_linux) for community-based support. |