openstack-ansible/deploy-guide/source/run-playbooks.rst
Mike Carden c5ae3e773d [DOC] Fix minor language errors
Remove a grocer's apostrophe and reword some tortured English.

Change-Id: I6b3fc8be56ca5ce113f806033fa1647544c6fa82
2016-12-01 15:30:09 +11:00

4.1 KiB

Run playbooks

The installation process requires running three main playbooks:

  • The setup-hosts.yml 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 setup-infrastructure.yml Ansible infrastructure playbook installs infrastructure services: Memcached, the repository server, Galera, RabbitMQ, and rsyslog.
  • The setup-openstack.yml OpenStack playbook installs OpenStack services, including Identity (keystone), Image (glance), Block Storage (cinder), Compute (nova), Networking (neutron), Orchestration (heat), Dashboard (horizon), Telemetry (ceilometer and aodh), Object Storage (swift), and Bare Metal (ironic).

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. Change to the /opt/openstack-ansible/playbooks directory, and run the following command:

    # openstack-ansible setup-infrastructure.yml --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. 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. Run the infrastructure setup playbook:

    # openstack-ansible setup-infrastructure.yml

    Confirm satisfactory completion with zero items unreachable or failed:

    PLAY RECAP ********************************************************************
    ...
    deployment_host                : ok=27   changed=0    unreachable=0    failed=0
  4. Run the following command to verify the database cluster:

    # 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.

  5. Run the OpenStack setup playbook:

    # openstack-ansible setup-openstack.yml

    Confirm satisfactory completion with zero items unreachable or failed.