From c8904e69857b10e44f8729fa388c0dd2c7c34819 Mon Sep 17 00:00:00 2001
From: Sam Yaple <sam@yaple.net>
Date: Thu, 6 Aug 2015 01:41:38 +0000
Subject: [PATCH] Updated some requirements about docker
We were requiring docker 1.7 for a few reasons at one point. Those
reasons are no longer valid and this change reflects that.
Additionally, this adds some clarifications on the issues with Ubuntu
and AUFS.
Change-Id: I56ca1b08f0abecb6f7644bf63ca939f588ed3ee2
---
docs/dev-quickstart.md | 40 +++++++++++-----------------------------
1 file changed, 11 insertions(+), 29 deletions(-)
diff --git a/docs/dev-quickstart.md b/docs/dev-quickstart.md
index b637aec43e..ffa9a44502 100644
--- a/docs/dev-quickstart.md
+++ b/docs/dev-quickstart.md
@@ -23,37 +23,19 @@ dependencies:
cd kolla
sudo pip install -r requirements.txt
-In order to run Kolla, it is mandatory to run a version of `docker`
-that is 1.7.0-dev or later. Docker 1.5.0 has a defect in `--pid=host`
-support where the libvirt container cannot be stopped. Docker 1.6.0 lacks
-specific features needed by the master of Kolla. Docker 1.7.0-dev introduces
-mount propogation which is necessary for Neutron thin containers
-and bindmounting of the /dev filesystem which is mandatory for the cinder
-container.
+In order to run Kolla, it is mandatory to run a version of `docker` that is
+1.6.0 or later. Docker 1.5.0 has a defect in `--pid=host` support where the
+libvirt container cannot be stopped and crashes nova-compute on start.
-If a version of Docker less than 1.7.0-dev is running on your system, stop it:
+For most systems you can install the latest stable version of Docker with the
+following command:
+ curl -sSL https://get.docker.io | bash
- sudo systemctl stop docker
- sudo killall -9 docker
-
-If using an RPM based system, use the Docker 1.7.0-dev RPMs provided by the
-Fedora project:
-
- sudo rpm -Uvh --nodeps https://kojipkgs.fedoraproject.org//packages/docker/1.7.0/6.git56481a3.fc23/x86_64/docker-1.7.0-6.git56481a3.fc23.x86_64.rpm
-
-For Debian based systems, use the Docker installation tool provided by Docker,
-Inc.:
-
- curl -sSL https://test.docker.com/ | sh
-
-For Ubuntu based systems, use the Docker installation tool provided by Docker,
-Inc.:
-
- curl -sSL https://test.docker.com/ubuntu | sh
-
-For Ubuntu based systems, do not use aufs when starting Docker daemon. Instead
-use other storage options, e.g., btrfs. This is because cap_set_file is not
-permitted on aufs when building docker images.
+For Ubuntu based systems, do not use AUFS when starting Docker daemon unless
+you are running the Utopic (3.19) kernel. AUFS requires CONFIG_AUFS_XATTR=y
+set when building the kernel. On Ubuntu, versions prior to 3.19 did not set that
+flag. If you are unable to upgrade your kernel, you should use a different
+storage backend such as btrfs.
Next, install the OpenStack python clients if they are not installed: