openstack-ansible/doc/source/install-guide/install-foundation.rst
Alexandra 89963f63b8 Docs: Installation section - cleanup
As per discussion in the OSA docs summit session, clean up
of installation guide. This fixes typos, minor RST mark up
changes, and passive voice.

Change-Id: Ia3758de04391ceefc2beccab8a1cddf0626cb43a
2016-05-03 09:56:59 +00:00

2.0 KiB

Home OpenStack-Ansible Installation Guide

Chapter 5. Foundation playbooks

Figure 5.1. Installation work flow

image

The main Ansible foundation playbook prepares the target hosts for infrastructure and OpenStack services and performs the following operations:

  • Perform deployment host initial setup
  • Build containers on target hosts
  • Restart containers on target hosts
  • Install common components into containers on target hosts

Running the foundation playbook

Before continuing, validate the configuration files using the guidance in "Checking the integrity of your configuration files".

  1. Change to the /opt/openstack-ansible/playbooks directory.

  2. Run the host setup playbook:

    # openstack-ansible setup-hosts.yml

    Confirm satisfactory completion with zero items unreachable or failed:

    PLAY RECAP ********************************************************************
    ...
    deployment_host                :  ok=18   changed=11   unreachable=0    failed=0
  3. If using HAProxy:

    Note

    To run HAProxy on multiple hosts, use keepalived to make HAProxy highly available. The keepalived role downloads during the bootstrap-ansible stage. If not, re-run the following command before running the HAProxy playbook:

    # pushd /opt/openstack-ansible; scripts/bootstrap-ansible.sh; popd

    or

    # ansible-galaxy install -r ../ansible-role-requirements.yml

Run the playbook to deploy HAProxy:

# openstack-ansible haproxy-install.yml