2015-06-08 03:07:20 +00:00
|
|
|
<!--[metadata]>
|
|
|
|
+++
|
|
|
|
title = "Installation on Oracle Linux"
|
|
|
|
description = "Installation instructions for Docker on Oracle Linux."
|
|
|
|
keywords = ["Docker, Docker documentation, requirements, linux, rhel, centos, oracle, ol"]
|
|
|
|
[menu.main]
|
|
|
|
parent = "smn_linux"
|
|
|
|
+++
|
|
|
|
<![end-metadata]-->
|
2014-08-26 00:28:41 +00:00
|
|
|
|
|
|
|
# Oracle Linux 6 and 7
|
|
|
|
|
|
|
|
You do not require an Oracle Linux Support subscription to install Docker on
|
|
|
|
Oracle Linux.
|
|
|
|
|
|
|
|
*For Oracle Linux customers with an active support subscription:*
|
|
|
|
Docker is available in either the `ol6_x86_64_addons` or `ol7_x86_64_addons`
|
|
|
|
channel for Oracle Linux 6 and Oracle Linux 7 on the [Unbreakable Linux Network
|
|
|
|
(ULN)](https://linux.oracle.com).
|
|
|
|
|
|
|
|
*For Oracle Linux users without an active support subscription:*
|
|
|
|
Docker is available in the appropriate `ol6_addons` or `ol7_addons` repository
|
|
|
|
on [Oracle Public Yum](http://public-yum.oracle.com).
|
|
|
|
|
|
|
|
Docker requires the use of the Unbreakable Enterprise Kernel Release 3 (3.8.13)
|
|
|
|
or higher on Oracle Linux. This kernel supports the Docker btrfs storage engine
|
|
|
|
on both Oracle Linux 6 and 7.
|
|
|
|
|
|
|
|
Due to current Docker limitations, Docker is only able to run only on the x86_64
|
|
|
|
architecture.
|
|
|
|
|
|
|
|
## To enable the *addons* channel via the Unbreakable Linux Network:
|
|
|
|
|
|
|
|
1. Enable either the *ol6\_x86\_64\_addons* or *ol7\_x86\_64\_addons* channel
|
|
|
|
via the ULN web interface.
|
|
|
|
Consult the [Unbreakable Linux Network User's
|
|
|
|
Guide](http://docs.oracle.com/cd/E52668_01/E39381/html/index.html) for
|
|
|
|
documentation on subscribing to channels.
|
|
|
|
|
|
|
|
## To enable the *addons* repository via Oracle Public Yum:
|
|
|
|
|
|
|
|
The latest release of Oracle Linux 6 and 7 are automatically configured to use
|
|
|
|
the Oracle Public Yum repositories during installation. However, the *addons*
|
|
|
|
repository is not enabled by default.
|
|
|
|
|
|
|
|
To enable the *addons* repository:
|
|
|
|
|
|
|
|
1. Edit either `/etc/yum.repos.d/public-yum-ol6.repo` or
|
|
|
|
`/etc/yum.repos.d/public-yum-ol7.repo`
|
|
|
|
and set `enabled=1` in the `[ol6_addons]` or the `[ol7_addons]` stanza.
|
|
|
|
|
2015-04-29 19:51:57 +00:00
|
|
|
## Installation
|
2014-08-26 00:28:41 +00:00
|
|
|
|
|
|
|
1. Ensure the appropriate *addons* channel or repository has been enabled.
|
|
|
|
|
|
|
|
2. Use yum to install the Docker package:
|
|
|
|
|
2015-04-29 19:51:57 +00:00
|
|
|
$ sudo yum install docker
|
2014-08-26 00:28:41 +00:00
|
|
|
|
2015-04-29 19:51:57 +00:00
|
|
|
## Starting Docker
|
2014-08-26 00:28:41 +00:00
|
|
|
|
|
|
|
1. Now that it's installed, start the Docker daemon:
|
|
|
|
|
2015-04-29 19:51:57 +00:00
|
|
|
1. On Oracle Linux 6:
|
2014-08-26 00:28:41 +00:00
|
|
|
|
2015-04-29 19:51:57 +00:00
|
|
|
$ sudo service docker start
|
2014-08-26 00:28:41 +00:00
|
|
|
|
2015-04-29 19:51:57 +00:00
|
|
|
2. On Oracle Linux 7:
|
2014-08-26 00:28:41 +00:00
|
|
|
|
2015-04-29 19:51:57 +00:00
|
|
|
$ sudo systemctl start docker.service
|
2014-08-26 00:28:41 +00:00
|
|
|
|
|
|
|
2. If you want the Docker daemon to start automatically at boot:
|
|
|
|
|
2015-04-29 19:51:57 +00:00
|
|
|
1. On Oracle Linux 6:
|
2014-08-26 00:28:41 +00:00
|
|
|
|
2015-04-29 19:51:57 +00:00
|
|
|
$ sudo chkconfig docker on
|
2014-08-26 00:28:41 +00:00
|
|
|
|
2015-04-29 19:51:57 +00:00
|
|
|
2. On Oracle Linux 7:
|
2014-08-26 00:28:41 +00:00
|
|
|
|
2015-04-29 19:51:57 +00:00
|
|
|
$ sudo systemctl enable docker.service
|
2014-08-26 00:28:41 +00:00
|
|
|
|
|
|
|
**Done!**
|
|
|
|
|
2014-11-26 04:09:52 +00:00
|
|
|
## Custom daemon options
|
|
|
|
|
|
|
|
If you need to add an HTTP Proxy, set a different directory or partition for the
|
|
|
|
Docker runtime files, or make other customizations, read our systemd article to
|
|
|
|
learn how to [customize your systemd Docker daemon options](/articles/systemd/).
|
|
|
|
|
2014-08-26 00:28:41 +00:00
|
|
|
## Using the btrfs storage engine
|
|
|
|
|
|
|
|
Docker on Oracle Linux 6 and 7 supports the use of the btrfs storage engine.
|
|
|
|
Before enabling btrfs support, ensure that `/var/lib/docker` is stored on a
|
|
|
|
btrfs-based filesystem. Review [Chapter
|
|
|
|
5](http://docs.oracle.com/cd/E37670_01/E37355/html/ol_btrfs.html) of the [Oracle
|
|
|
|
Linux Administrator's Solution
|
|
|
|
Guide](http://docs.oracle.com/cd/E37670_01/E37355/html/index.html) for details
|
|
|
|
on how to create and mount btrfs filesystems.
|
|
|
|
|
|
|
|
To enable btrfs support on Oracle Linux:
|
|
|
|
|
|
|
|
1. Ensure that `/var/lib/docker` is on a btrfs filesystem.
|
|
|
|
1. Edit `/etc/sysconfig/docker` and add `-s btrfs` to the `OTHER_ARGS` field.
|
|
|
|
2. Restart the Docker daemon:
|
|
|
|
|
|
|
|
You can now continue with the [Docker User Guide](/userguide/).
|
|
|
|
|
2015-04-29 19:51:57 +00:00
|
|
|
## Uninstallation
|
|
|
|
|
|
|
|
To uninstall the Docker package:
|
|
|
|
|
|
|
|
$ sudo yum -y remove docker
|
|
|
|
|
|
|
|
The above command will not remove images, containers, volumes, or user created
|
|
|
|
configuration files on your host. If you wish to delete all images, containers,
|
|
|
|
and volumes run the following command:
|
|
|
|
|
|
|
|
$ rm -rf /var/lib/docker
|
|
|
|
|
|
|
|
You must delete the user created configuration files manually.
|
|
|
|
|
2014-08-26 00:28:41 +00:00
|
|
|
## Known issues
|
|
|
|
|
|
|
|
### Docker unmounts btrfs filesystem on shutdown
|
|
|
|
If you're running Docker using the btrfs storage engine and you stop the Docker
|
|
|
|
service, it will unmount the btrfs filesystem during the shutdown process. You
|
|
|
|
should ensure the filesystem is mounted properly prior to restarting the Docker
|
|
|
|
service.
|
|
|
|
|
|
|
|
On Oracle Linux 7, you can use a `systemd.mount` definition and modify the
|
|
|
|
Docker `systemd.service` to depend on the btrfs mount defined in systemd.
|
|
|
|
|
2015-04-21 15:50:09 +00:00
|
|
|
### SElinux support on Oracle Linux 7
|
2014-08-26 00:28:41 +00:00
|
|
|
SElinux must be set to `Permissive` or `Disabled` in `/etc/sysconfig/selinux` to
|
|
|
|
use the btrfs storage engine on Oracle Linux 7.
|
|
|
|
|
|
|
|
## Further issues?
|
|
|
|
|
|
|
|
If you have a current Basic or Premier Support Subscription for Oracle Linux,
|
|
|
|
you can report any issues you have with the installation of Docker via a Service
|
|
|
|
Request at [My Oracle Support](http://support.oracle.com).
|
|
|
|
|
|
|
|
If you do not have an Oracle Linux Support Subscription, you can use the [Oracle
|
|
|
|
Linux
|
2014-12-01 13:37:04 +00:00
|
|
|
Forum](https://community.oracle.com/community/server_%26_storage_systems/linux/oracle_linux) for community-based support.
|