openstack/kolla-ansible
Code Issues Proposed changes

Documentation improvements.

Browse Source 
The version changes in docker are needed to support named volumes
which are replacing data containers in our implementation. Docker
is no unblocked upstream for us thanks to our new kolla_docker
module so I removed the cap on that as well.

Change-Id: I847979b9f7c9e42a55273b5ee926a4aff19a7bec
This commit is contained in:
SamYaple 2016-01-03 17:03:08 +00:00
parent 912ecd0dfc
commit 64a75735cc
1 changed files with 11 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

24
doc/quickstart.rst
View File

@ -41,18 +41,15 @@ format. The guestfs system in the CentOS family of containers cannot read
these images because a dependent package supermin in CentOS needs to be these images because a dependent package supermin in CentOS needs to be
updated to add .xz compressed format support. updated to add .xz compressed format support.
Ubuntu: For Ubuntu based systems where Docker is used, do not use AUFS when Ubuntu: For Ubuntu based systems where Docker is used it is recommended to use
starting Docker daemon, unless running Ubuntu uses 3.19 kernel or above. the latest available lts kernel. The latest lts kernel available is the wily
AUFS requires CONFIG\_AUFS\_XATTR=y set when building the kernel. On kernel (version 4.2). While all kernels should work for Docker, some older
Ubuntu, versions prior to 3.19 did not set this flag to be compatible with kernels may have issues with some of the different Docker backends such as AUFS
Docker. In order to update kernel in Ubuntu 14.04 LTS to 3.19, run: and OverlayFS. In order to update kernel in Ubuntu 14.04 LTS to 4.2, run:
:: ::
sudo apt-get install linux-image-generic-lts-vivid sudo apt-get install linux-image-generic-lts-wily
If unable to upgrade the kernel, the Kolla community recommends using a
different storage backend such as btrfs when running Docker daemon.
.. NOTE:: Install is *very* sensitive about version of components. Please .. NOTE:: Install is *very* sensitive about version of components. Please
review carefully because default Operating System repos are likely out of review carefully because default Operating System repos are likely out of
@ -62,8 +59,8 @@ different storage backend such as btrfs when running Docker daemon.
Component Min Version Max Version Comment Component Min Version Max Version Comment
===================== =========== =========== ========================= ===================== =========== =========== =========================
Ansible 1.9.4 none On deployment host Ansible 1.9.4 none On deployment host
Docker 1.8.2 1.8.2 On target nodes Docker 1.9.0 none On target nodes
Docker Python 1.2.0 none On target nodes Docker Python 1.6.0 none On target nodes
Python Jinja2 2.6.0 none On deployment host Python Jinja2 2.6.0 none On deployment host
===================== =========== =========== ========================= ===================== =========== =========== =========================
@ -108,8 +105,9 @@ work with docker 1.8.2, to check you docker version run this command:
docker --version docker --version
Docker 1.8.3 and later are incompatible with Kolla. If the version installed Docker 1.8.3 and later are incompatible with Kolla Liberty. Versions greater
is 1.8.3 or later, consider downgrading by using these commands: than 1.8.2 are functional with master branch (Mitaka). If the version installed
is 1.8.3 or later and you are running Liberty, downgrade using these commands:
:: ::