openstack-ansible/deploy-guide/source/run-playbooks.rst

Run playbooks

The installation process requires running three main playbooks:

• The openstack.osa.setup_hosts Ansible foundation playbook prepares the target hosts for infrastructure and OpenStack services, builds and restarts containers on target hosts, and installs common components into containers on target hosts.
• The openstack.osa.setup_infrastructure Ansible infrastructure playbook installs infrastructure services: Memcached, the repository server, Galera and RabbitMQ.
• The openstack.osa.setup_openstack OpenStack playbook installs OpenStack services, including Identity (keystone), Image (glance), Block Storage (cinder), Compute (nova), Networking (neutron), etc.

Checking the integrity of the configuration files

Before running any playbook, check the integrity of the configuration files.

1. Ensure that all the files edited in the /etc/openstack_deploy directory are Ansible YAML compliant.

2. Check the integrity of your YAML files.

   Note

   To check your YAML syntax online, you can use the YAML Lint program.

3. Run the following command:

   # openstack-ansible openstack.osa.setup_infrastructure --syntax-check

4. Recheck that all indentation is correct. This is important because the syntax of the configuration files can be correct while not being meaningful for OpenStack-Ansible.

Run the playbooks to install OpenStack

1. Run the host setup playbook:

   # openstack-ansible openstack.osa.setup_hosts

   Confirm satisfactory completion with zero items unreachable or failed:

   PLAY RECAP ********************************************************************
   ...
   deployment_host                :  ok=18   changed=11   unreachable=0    failed=0

2. Run the infrastructure setup playbook:

   # openstack-ansible openstack.osa.setup_infrastructure

   Confirm satisfactory completion with zero items unreachable or failed:

   PLAY RECAP ********************************************************************
   ...
   deployment_host                : ok=27   changed=0    unreachable=0    failed=0

3. Run the following command to verify the database cluster:

   Note

   In order to run ad-hoc commands, you need to execute command from the location of openstack-ansible repository (ie /opt/openstack-ansible) or explicitly load required envirnoment variables for Ansible configuration through source /usr/local/bin/openstack-ansible.rc.

   # ansible galera_container -m shell \
     -a "mysql -h localhost -e 'show status like \"%wsrep_cluster_%\";'"

   Example output:

   node3_galera_container-3ea2cbd3 | success | rc=0 >>
   Variable_name             Value
   wsrep_cluster_conf_id     17
   wsrep_cluster_size        3
   wsrep_cluster_state_uuid  338b06b0-2948-11e4-9d06-bef42f6c52f1
   wsrep_cluster_status      Primary
   
   node2_galera_container-49a47d25 | success | rc=0 >>
   Variable_name             Value
   wsrep_cluster_conf_id     17
   wsrep_cluster_size        3
   wsrep_cluster_state_uuid  338b06b0-2948-11e4-9d06-bef42f6c52f1
   wsrep_cluster_status      Primary
   
   node4_galera_container-76275635 | success | rc=0 >>
   Variable_name             Value
   wsrep_cluster_conf_id     17
   wsrep_cluster_size        3
   wsrep_cluster_state_uuid  338b06b0-2948-11e4-9d06-bef42f6c52f1
   wsrep_cluster_status      Primary

   The wsrep_cluster_size field indicates the number of nodes in the cluster and the wsrep_cluster_status field indicates primary.

4. Run the OpenStack setup playbook:

   # openstack-ansible openstack.osa.setup_openstack

   Confirm satisfactory completion with zero items unreachable or failed.