diff --git a/doc/quickstart.rst b/doc/quickstart.rst index 664adedcefe9a183ea11cb1f324a1725bea57cda..e5c73a879e45584ff4b7c3ac97fb27d26a4d42ee 100644 --- a/doc/quickstart.rst +++ b/doc/quickstart.rst @@ -181,36 +181,43 @@ Kolla deploys OpenStack using `Ansible <http://www.ansible.com>`__. 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: +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: :: - apt-get install ansible + # Centos 7 + yum -y install gcc -If the distro packaged version of Ansible is too old, install Ansible using -pip: + # Ubuntu + sudo apt-get install gcc + +Finally Ansible 1.9.4 may be installed using: :: - pip install -U ansible + pip install -U 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: +If DEB based systems include a version of Ansible that meets Kolla's +version requirements it can be installed by: :: - # Centos 7 - yum -y install gcc + apt-get install ansible - # Ubuntu - sudo apt-get install gcc Deploy a registry (required for multinode) ------------------------------------------