Browse code

Do some major rearranging of the fedora/centos/rhel installation docs

Signed-off-by: Sven Dowideit <SvenDowideit@home.org.au>

Sven Dowideit authored on 2015/02/05 12:42:11
Showing 3 changed files
... ...
@@ -4,48 +4,34 @@ page_keywords: Docker, Docker documentation, requirements, linux, centos, epel,
4 4
 
5 5
 # CentOS
6 6
 
7
-While the Docker package is provided by default as part of CentOS-7,
8
-it is provided by the EPEL repository for CentOS-6. Please note that
9
-this changes the installation instructions slightly between versions. If you
10
-need the latest version, you can always use the latest binary which works on
11
-kernel 3.8 and above.
7
+Docker is supported on the following versions of CentOS:
12 8
 
13
-These instructions work for CentOS 6 and later. They will likely work for
14
-other binary compatible EL6 distributions such as Scientific Linux, but
15
-they haven't been tested.
9
+- [*CentOS 7 (64-bit)*](#installing-docker---centos-7)
10
+- [*CentOS 6.5 (64-bit)*](#installing-docker---centos-6.5) or later
11
+
12
+These instructions are likely work for other binary compatible EL6/EL7 distributions
13
+such as Scientific Linux, but they haven't been tested.
16 14
 
17 15
 Please note that due to the current Docker limitations, Docker is able to
18 16
 run only on the **64 bit** architecture.
19 17
 
20
-To run Docker, you will need [CentOS6](http://www.centos.org) or higher,
21
-with a kernel version 2.6.32-431 or higher as this has specific kernel
22
-fixes to allow Docker to run.
18
+## Kernel support
19
+
20
+Currently the CentOS project will only support Docker when running on kernels
21
+shipped by the distribution. There are kernel changes which will cause issues
22
+if one decides to step outside that box and run non-distribution kernel packages.
23
+
24
+To run Docker on [CentOS-6.5](http://www.centos.org) or later, you will need
25
+kernel version 2.6.32-431 or higher as this has specific kernel fixes to allow
26
+Docker to run.
23 27
 
24 28
 ## Installing Docker - CentOS-7
25 29
 Docker is included by default in the CentOS-Extras repository. To install
26
-simply run the following command.
30
+run the following command:
27 31
 
28 32
     $ sudo yum install docker
29 33
 
30
-## Kernel support
31
-
32
-Currently the CentOS project will only support Docker via the EPEL package when
33
-running on kernels shipped by the distribution. There are things like namespace
34
-changes which will cause issues if one decides to step outside that box and run
35
-non-distro kernel packages.
36
-
37
-### Manual installation of latest version
38
-
39
-While using a package is the recommended way of installing Docker,
40
-the above package might not be the latest version. If you need the latest
41
-version, [you can install the binary directly](
42
-https://docs.docker.com/installation/binaries/).
43
-
44
-When installing the binary without a package, you may want
45
-to integrate Docker with systemd. For this, simply install the two unit files
46
-(service and socket) from [the github
47
-repository](https://github.com/docker/docker/tree/master/contrib/init/systemd)
48
-to `/etc/systemd/system`.
34
+Please continue with the [Starting the Docker daemon](#starting-the-docker-daemon).
49 35
 
50 36
 ### FirewallD
51 37
 
... ...
@@ -55,32 +41,49 @@ conflict with Docker.
55 55
 When `firewalld` is started or restarted it will remove the `DOCKER` chain
56 56
 from iptables, preventing Docker from working properly.
57 57
 
58
-When using systemd, `firewalld` is started before Docker, but if you
58
+When using Systemd, `firewalld` is started before Docker, but if you
59 59
 start or restart `firewalld` after Docker, you will have to restart the Docker daemon.
60 60
 
61
-## Installing Docker - CentOS-6
62
-Please note that this for CentOS-6, this package is part of [Extra Packages
63
-for Enterprise Linux (EPEL)](https://fedoraproject.org/wiki/EPEL), a community effort
64
-to create and maintain additional packages for the RHEL distribution.
61
+## Installing Docker - CentOS-6.5
62
+
63
+For Centos-6.5, the Docker package is part of [Extra Packages
64
+for Enterprise Linux (EPEL)](https://fedoraproject.org/wiki/EPEL) repository,
65
+a community effort to create and maintain additional packages for the RHEL distribution.
65 66
 
66 67
 Firstly, you need to ensure you have the EPEL repository enabled. Please
67 68
 follow the [EPEL installation instructions](
68 69
 https://fedoraproject.org/wiki/EPEL#How_can_I_use_these_extra_packages.3F).
69 70
 
70
-The `docker-io` package provides Docker on EPEL.
71
+For CentOS-6, there is a package name conflict with a system tray application
72
+and its executable, so the Docker RPM package was called `docker-io`.
71 73
 
72
-If you already have the (unrelated) `docker` package
73
-installed, it will conflict with `docker-io`.
74
-There's a [bug report](
75
-https://bugzilla.redhat.com/show_bug.cgi?id=1043676) filed for it.
76
-To proceed with `docker-io` installation, please remove `docker` first.
74
+To proceed with `docker-io` installation on CentOS-6, you may need to remove the
75
+`docker` package first.
77 76
 
78
-Next, let's install the `docker-io` package which
79
-will install Docker on our host.
77
+    $ sudo yum -y remove docker
78
+
79
+Next, let's install the `docker-io` package which will install Docker on our host.
80 80
 
81 81
     $ sudo yum install docker-io
82 82
 
83
-## Using Docker
83
+Please continue with the [Starting the Docker daemon](#starting-the-docker-daemon).
84
+
85
+## Manual installation of latest Docker release
86
+
87
+While using a package is the recommended way of installing Docker,
88
+the above package might not be the current release version. If you need the latest
89
+version, [you can install the binary directly](
90
+https://docs.docker.com/installation/binaries/).
91
+
92
+When installing the binary without a package, you may want
93
+to integrate Docker with Systemd. For this, install the two unit files
94
+(service and socket) from [the GitHub
95
+repository](https://github.com/docker/docker/tree/master/contrib/init/systemd)
96
+to `/etc/systemd/system`.
97
+
98
+Please continue with the [Starting the Docker daemon](#starting-the-docker-daemon).
99
+
100
+## Starting the Docker daemon
84 101
 
85 102
 Once Docker is installed, you will need to start the docker daemon.
86 103
 
... ...
@@ -115,13 +118,13 @@ If everything is working properly, you'll get a simple bash prompt. Type
115 115
 ## Custom daemon options
116 116
 
117 117
 If you need to add an HTTP Proxy, set a different directory or partition for the
118
-Docker runtime files, or make other customizations, read our systemd article to
119
-learn how to [customize your systemd Docker daemon options](/articles/systemd/).
118
+Docker runtime files, or make other customizations, read our Systemd article to
119
+learn how to [customize your Systemd Docker daemon options](/articles/systemd/).
120 120
 
121 121
 ## Dockerfiles
122 122
 The CentOS Project provides a number of sample Dockerfiles which you may use
123 123
 either as templates or to familiarize yourself with docker. These templates
124
-are available on github at [https://github.com/CentOS/CentOS-Dockerfiles](
124
+are available on GitHub at [https://github.com/CentOS/CentOS-Dockerfiles](
125 125
 https://github.com/CentOS/CentOS-Dockerfiles)
126 126
 
127 127
 **Done!** You can either continue with the [Docker User
... ...
@@ -1,25 +1,19 @@
1 1
 page_title: Installation on Fedora
2
-page_description: Installation instructions for Docker on Fedora.
3
-page_keywords: Docker, Docker documentation, Fedora, requirements, virtualbox, vagrant, git, ssh, putty, cygwin, linux
2
+page_description: Instructions for installing Docker on Fedora.
3
+page_keywords: Docker, Docker documentation, Fedora, requirements, linux
4 4
 
5 5
 # Fedora
6 6
 
7
-Docker is supported only on Fedora 20 and later,
8
-on the **64 bit** architecture.
7
+Docker is supported on the following versions of Fedora:
9 8
 
10
-## Installation
9
+- [*Fedora 20 (64-bit)*](#fedora-20-installation)
10
+- [*Fedora 21 and later (64-bit)*](#fedora-21-and-later-installation)
11 11
 
12
-For `Fedora 20`, the `docker-io` package provides Docker.
12
+Currently the Fedora project will only support Docker when running on kernels
13
+shipped by the distribution. There are kernel changes which will cause issues
14
+if one decides to step outside that box and run non-distribution kernel packages.
13 15
 
14
-If you have the (unrelated) `docker` package installed already, it will
15
-conflict with `docker-io`. To proceed with `docker-io` installation on
16
-Fedora 20, please remove `docker` first.
17
-
18
-    $ sudo yum -y remove docker
19
-    $ sudo yum -y install docker-io
20
-
21
-For `Fedora 21 and later`, there are no package conflicts as the system
22
-tray application and its executable have been renamed `wmdocker`.
16
+## Fedora 21 and later installation
23 17
 
24 18
 Install the `docker` package which will install Docker on our host.
25 19
 
... ...
@@ -29,6 +23,27 @@ To update the `docker` package:
29 29
 
30 30
     $ sudo yum -y update docker
31 31
 
32
+Please continue with the [Starting the Docker daemon](#starting-the-docker-daemon).
33
+
34
+## Fedora 20 installation
35
+
36
+For `Fedora 20`, there is a package name conflict with a system tray application
37
+and its executable, so the Docker RPM package was called `docker-io`.
38
+
39
+To proceed with `docker-io` installation on Fedora 20, please remove the `docker`
40
+package first.
41
+
42
+    $ sudo yum -y remove docker
43
+    $ sudo yum -y install docker-io
44
+
45
+To update the `docker` package:
46
+
47
+    $ sudo yum -y update docker-io
48
+
49
+Please continue with the [Starting the Docker daemon](#starting-the-docker-daemon).
50
+
51
+## Starting the Docker daemon
52
+
32 53
 Now that it's installed, let's start the Docker daemon.
33 54
 
34 55
     $ sudo systemctl start docker
... ...
@@ -60,8 +75,8 @@ create a `docker` group, have it own `/var/run/docker.sock`, and add users to th
60 60
 ## Custom daemon options
61 61
 
62 62
 If you need to add an HTTP Proxy, set a different directory or partition for the
63
-Docker runtime files, or make other customizations, read our systemd article to
64
-learn how to [customize your systemd Docker daemon options](/articles/systemd/).
63
+Docker runtime files, or make other customizations, read our Systemd article to
64
+learn how to [customize your Systemd Docker daemon options](/articles/systemd/).
65 65
 
66 66
 ## What next?
67 67
 
... ...
@@ -1,10 +1,24 @@
1 1
 page_title: Installation on Red Hat Enterprise Linux
2
-page_description: Installation instructions for Docker on Red Hat Enterprise Linux.
3
-page_keywords: Docker, Docker documentation, requirements, linux, rhel, centos
2
+page_description: Instructions for installing Docker on Red Hat Enterprise Linux.
3
+page_keywords: Docker, Docker documentation, requirements, linux, rhel
4 4
 
5
-# Red Hat Enterprise Linux 7
5
+# Red Hat Enterprise Linux
6 6
 
7
-**Red Hat Enterprise Linux 7** has [shipped with
7
+Docker is supported on the following versions of RHEL:
8
+
9
+- [*Red Hat Enterprise Linux 7 (64-bit)*](#red-hat-enterprise-linux-7-installation)
10
+- [*Red Hat Enterprise Linux 6.5 (64-bit)*](#red-hat-enterprise-linux-6.5-installation) or later
11
+
12
+## Kernel support
13
+
14
+RHEL will only support Docker via the *extras* channel or EPEL package when
15
+running on kernels shipped by the distribution. There are kernel changes which
16
+will cause issues if one decides to step outside that box and run
17
+non-distribution kernel packages.
18
+
19
+## Red Hat Enterprise Linux 7 Installation
20
+
21
+**Red Hat Enterprise Linux 7 (64 bit)** has [shipped with
8 22
 Docker](https://access.redhat.com/site/products/red-hat-enterprise-linux/docker-and-containers).
9 23
 An overview and some guidance can be found in the [Release
10 24
 Notes](https://access.redhat.com/site/documentation/en-US/Red_Hat_Enterprise_Linux/7/html/7.0_Release_Notes/chap-Red_Hat_Enterprise_Linux-7.0_Release_Notes-Linux_Containers_with_Docker_Format.html).
... ...
@@ -25,51 +39,44 @@ Enterprise Linux 7](https://access.redhat.com/site/articles/881893)
25 25
 guide, can be found by Red Hat customers on the [Red Hat Customer
26 26
 Portal](https://access.redhat.com/).
27 27
 
28
-# Red Hat Enterprise Linux 6
29
-
30
-Docker is available for **RHEL** on EPEL. Please note that
31
-this package is part of [Extra Packages for Enterprise Linux
32
-(EPEL)](https://fedoraproject.org/wiki/EPEL), a community effort to
33
-create and maintain additional packages for the RHEL distribution.
28
+Please continue with the [Starting the Docker daemon](#starting-the-docker-daemon).
34 29
 
35
-Also note that due to the current Docker limitations, Docker is able to
36
-run only on the **64 bit** architecture.
30
+## Red Hat Enterprise Linux 6.5 Installation
37 31
 
38
-You will need [RHEL
39
-6.5](https://access.redhat.com/site/articles/3078#RHEL6) or higher, with
32
+You will need **64 bit** [RHEL
33
+6.5](https://access.redhat.com/site/articles/3078#RHEL6) or later, with
40 34
 a RHEL 6 kernel version 2.6.32-431 or higher as this has specific kernel
41 35
 fixes to allow Docker to work.
42 36
 
43
-## Kernel support
44
-
45
-RHEL will only support Docker via the *extras* channel or EPEL package when
46
-running on kernels shipped by the distribution. There are things like namespace
47
-changes which will cause issues if one decides to step outside that box and run
48
-non-distro kernel packages.
49
-
50
-## Installation
37
+Docker is available for **RHEL6.5** on EPEL. Please note that
38
+this package is part of [Extra Packages for Enterprise Linux
39
+(EPEL)](https://fedoraproject.org/wiki/EPEL), a community effort to
40
+create and maintain additional packages for the RHEL distribution.
51 41
 
52 42
 Firstly, you need to install the EPEL repository. Please follow the
53 43
 [EPEL installation
54 44
 instructions](https://fedoraproject.org/wiki/EPEL#How_can_I_use_these_extra_packages.3F).
55 45
 
56
-The `docker-io` package provides Docker on EPEL.
46
+There is a package name conflict with a system tray application
47
+and its executable, so the Docker RPM package was called `docker-io`.
48
+
49
+To proceed with `docker-io` installation, you may need to remove the
50
+`docker` package first.
57 51
 
58
-If you already have the (unrelated) `docker` package
59
-installed, it will conflict with `docker-io`.
60
-There's a [bug report](
61
-https://bugzilla.redhat.com/show_bug.cgi?id=1043676) filed for it.
62
-To proceed with `docker-io` installation, please remove `docker` first.
52
+    $ sudo yum -y remove docker
63 53
 
64
-Next, let's install the `docker-io` package which
65
-will install Docker on our host.
54
+Next, let's install the `docker-io` package which will install Docker on our host.
66 55
 
67
-    $ sudo yum -y install docker-io
56
+    $ sudo yum install docker-io
68 57
 
69 58
 To update the `docker-io` package
70 59
 
71 60
     $ sudo yum -y update docker-io
72 61
 
62
+Please continue with the [Starting the Docker daemon](#starting-the-docker-daemon).
63
+
64
+## Starting the Docker daemon
65
+
73 66
 Now that it's installed, let's start the Docker daemon.
74 67
 
75 68
     $ sudo service docker start
... ...
@@ -93,8 +100,8 @@ Continue with the [User Guide](/userguide/).
93 93
 ## Custom daemon options
94 94
 
95 95
 If you need to add an HTTP Proxy, set a different directory or partition for the
96
-Docker runtime files, or make other customizations, read our systemd article to
97
-learn how to [customize your systemd Docker daemon options](/articles/systemd/).
96
+Docker runtime files, or make other customizations, read our Systemd article to
97
+learn how to [customize your Systemd Docker daemon options](/articles/systemd/).
98 98
 
99 99
 
100 100
 ## Issues?