diff --git a/doc/image-building.rst b/doc/image-building.rst index 24714ab009..f96747ef3f 100644 --- a/doc/image-building.rst +++ b/doc/image-building.rst @@ -188,11 +188,13 @@ image, the operator would add the following block to Known issues ============ -1. Can't build base image because docker fails to install systemd. +1. Can't build base image because docker fails to install systemd or httpd. There are some issues between docker and AUFS. The simple workaround to - avoid the issue is that add ``-s devicemapper`` to ``DOCKER_OPTS``. Get - more information about the issue from DockerBug_. + avoid the issue is that add ``-s devicemapper`` or ``-s btrfs`` to + ``DOCKER_OPTS``. Get more information about `the issue from the Docker bug + tracker `_ and `how to + configure Docker with BTRFS backend `_. 2. Mirrors are unreliable. @@ -298,5 +300,4 @@ variables that will be picked up from the user env:: Also these variables could be overwritten using ``--build-args``, which have precedence. -.. _DockerBug: https://github.com/docker/docker/issues/6980 .. _drivers: https://wiki.openstack.org/wiki/Neutron#Plugins diff --git a/doc/quickstart.rst b/doc/quickstart.rst index cbaf152899..ebdeedd963 100644 --- a/doc/quickstart.rst +++ b/doc/quickstart.rst @@ -117,6 +117,9 @@ For Ubuntu 14.04 which uses upstart instead of systemd, run the following: mount --make-shared /run +.. NOTE:: If centos/fedora/oraclelinux container images are built on an Ubuntu + host, the backend storage driver must not be AUFS (see the known issues in + :doc:`image-building`). On the target hosts you also need an updated version of the Docker python libraries: