c5ae3e773d
Remove a grocer's apostrophe and reword some tortured English. Change-Id: I6b3fc8be56ca5ce113f806033fa1647544c6fa82
133 lines
4.1 KiB
ReStructuredText
133 lines
4.1 KiB
ReStructuredText
.. _run-playbooks:
|
|
|
|
=============
|
|
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.
|
|
|
|
#. Ensure that all the files edited in the ``/etc/openstack_deploy`` directory are
|
|
Ansible `YAML compliant <http://docs.ansible.com/ansible/YAMLSyntax.html>`_.
|
|
|
|
#. Check the integrity of your YAML files.
|
|
|
|
.. note::
|
|
|
|
To check your YAML syntax online, you can use the `YAML Lint program <http://www.yamllint.com/>`_.
|
|
|
|
#. Change to the ``/opt/openstack-ansible/playbooks`` directory, and run the
|
|
following command:
|
|
|
|
.. code-block:: console
|
|
|
|
# openstack-ansible setup-infrastructure.yml --syntax-check
|
|
|
|
#. 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
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
.. figure:: figures/installation-workflow-run-playbooks.png
|
|
:width: 100%
|
|
|
|
#. Change to the ``/opt/openstack-ansible/playbooks`` directory.
|
|
|
|
#. Run the host setup playbook:
|
|
|
|
.. code-block:: console
|
|
|
|
# openstack-ansible setup-hosts.yml
|
|
|
|
Confirm satisfactory completion with zero items unreachable or
|
|
failed:
|
|
|
|
.. code-block:: console
|
|
|
|
PLAY RECAP ********************************************************************
|
|
...
|
|
deployment_host : ok=18 changed=11 unreachable=0 failed=0
|
|
|
|
|
|
#. Run the infrastructure setup playbook:
|
|
|
|
.. code-block:: console
|
|
|
|
# openstack-ansible setup-infrastructure.yml
|
|
|
|
Confirm satisfactory completion with zero items unreachable or
|
|
failed:
|
|
|
|
.. code-block:: console
|
|
|
|
PLAY RECAP ********************************************************************
|
|
...
|
|
deployment_host : ok=27 changed=0 unreachable=0 failed=0
|
|
|
|
|
|
#. Run the following command to verify the database cluster:
|
|
|
|
.. code-block:: console
|
|
|
|
# ansible galera_container -m shell \
|
|
-a "mysql -h localhost -e 'show status like \"%wsrep_cluster_%\";'"
|
|
|
|
Example output:
|
|
|
|
.. code-block:: console
|
|
|
|
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.
|
|
|
|
#. Run the OpenStack setup playbook:
|
|
|
|
.. code-block:: console
|
|
|
|
# openstack-ansible setup-openstack.yml
|
|
|
|
Confirm satisfactory completion with zero items unreachable or
|
|
failed.
|