From a56def68d94d6ff6c5714dcdd0873ca125414c50 Mon Sep 17 00:00:00 2001 From: Olivier Bourdon Date: Thu, 15 Mar 2018 13:51:06 +0100 Subject: [PATCH] Add some troubleshooting informations This error could be somewhat difficult to find and as this documentation file contains the instructions for a Quick Start the quicker the issue is found and solved the better Change-Id: I3c184b0af8729f00dbb15f7b5ad610645a901836 --- doc/source/user/aio/quickstart.rst | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/doc/source/user/aio/quickstart.rst b/doc/source/user/aio/quickstart.rst index 0d43fa0090..10301def7e 100644 --- a/doc/source/user/aio/quickstart.rst +++ b/doc/source/user/aio/quickstart.rst @@ -167,6 +167,29 @@ following to bootstrap Ansible: # scripts/bootstrap-ansible.sh +Notes: + You might encounter an error while running the Ansible bootstrap script + when building some of the Python extension (like pycrypto) which says: + + .. code-block:: shell-session + + configure: error: cannot run C compiled programs. + + The reason of this failure might be resulting from a noexec mount flag + used for the filesystem associated with /tmp which you can check by + running the following command: + + .. code-block:: shell-session + + # mount | grep $(df /tmp | tail -n +2 | awk '{print $1}') | grep noexec + + If this is the case you can specify an alternate path which does not + have this mount option set: + + .. code-block:: shell-session + + # TMPDIR=/var/tmp scripts/bootstrap-ansible.sh + In order for all the services to run, the host must be prepared with the appropriate disks, packages, network configuration and a base configuration for the OpenStack Deployment. For the default AIO scenario, this preparation