From e4a659e0beda46c2c1e429448f7fb79457c36c0b Mon Sep 17 00:00:00 2001 From: Naren Narendra Date: Thu, 11 Feb 2016 20:27:48 -0500 Subject: [PATCH] Clarify Ansible installation for distros in docs. For CentOS, install from distro packaging by default. Explain how to install on DEB based systems from packaging when they update to a newer version of Ansible. Finally, clean up the ordering of the dependencies for a pip based install. TrivialFix Change-Id: I9564a03c2e75fd30b5ec9c7d64f5defb709d7fde --- doc/quickstart.rst | 35 +++++++++++++++++++++-------------- 1 file changed, 21 insertions(+), 14 deletions(-) diff --git a/doc/quickstart.rst b/doc/quickstart.rst index 664adedcef..e5c73a879e 100644 --- a/doc/quickstart.rst +++ b/doc/quickstart.rst @@ -181,25 +181,18 @@ Kolla deploys OpenStack using `Ansible `__. Install Ansible from distribution packaging if the distro packaging has recommended version available. -Currently all implemented distro versions of Ansible are too old to use distro -packaging. Once distro packaging is updated install from packaging using: +Some implemented distro versions of Ansible are too old to use distro +packaging. Currently, CentOS and RHEL package Ansible 1.9.4 which is +suitable for use with Kolla. + +On CentOS or RHEL systems, this can be done using: :: yum -y install ansible -On DEB based systems this can be done using: - -:: - - apt-get install ansible - -If the distro packaged version of Ansible is too old, install Ansible using -pip: - -:: - - pip install -U ansible +Many DEB based systems do not meet Kolla's Ansible version requirements. +It is recommended to use pip to install Ansible 1.9.4. Some ansible dependencies, like pycrypto, may need gcc installed on the build system. Install it using system packaging tools if it's not installed already: @@ -212,6 +205,20 @@ system. Install it using system packaging tools if it's not installed already: # Ubuntu sudo apt-get install gcc +Finally Ansible 1.9.4 may be installed using: + +:: + + pip install -U ansible==1.9.4 + +If DEB based systems include a version of Ansible that meets Kolla's +version requirements it can be installed by: + +:: + + apt-get install ansible + + Deploy a registry (required for multinode) ------------------------------------------