Merge "Updated list of upstream contributions in Blazar"
[promise.git] / docs / release / configguide / feature.configuration.rst
1 .. This work is licensed under a Creative Commons Attribution 4.0 International License.
2 .. http://creativecommons.org/licenses/by/4.0
3
4 Blazar installation with OpenStack Ansible
5 ==========================================
6 .. note::
7    This guide provides steps for manual installation of Blazar using OpenStack
8    Ansible. These instructions are valid for Ubuntu 18.04 All-in-one (AIO).
9
10 Install and bootstrap Ansible (master branch) as the root user:
11
12 .. code:: bash
13
14    # git clone https://git.openstack.org/openstack/openstack-ansible /opt/openstack-ansible
15    # cd /opt/openstack-ansible
16
17 .. note::
18    At the time of writing, work is still ongoing upstream in OpenStack.
19    Therefore, it is recommended to set ANSIBLE_ROLE_FETCH_MODE to git-clone.
20
21 .. code:: bash
22
23    # export ANSIBLE_ROLE_FETCH_MODE=git-clone
24    # scripts/bootstrap-ansible.sh
25    # scripts/bootstrap-aio.sh
26
27 Enable Blazar:
28
29 .. code:: bash
30
31    # cp etc/openstack_deploy/conf.d/blazar.yml.aio /etc/openstack_deploy/conf.d/
32    # cd /etc/openstack_deploy/conf.d
33    # mv blazar.yml.aio blazar.yml
34
35 Run Ansible playbooks:
36
37 .. code:: bash
38
39    # cd /opt/openstack-ansible/playbooks
40    # openstack-ansible setup-hosts.yml
41    # openstack-ansible setup-infrastructure.yaml
42    # openstack-ansible setup-openstack.yml
43
44 Once the playbooks have successfully executed, it is possible to make some
45 modifications to the Blazar Ansible role in /etc/ansible/roles/os_blazar
46 and re-install the Blazar service by executing:
47
48 .. code:: bash
49
50    # cd /opt/openstack-ansible/playbooks
51    # openstack-ansible os-blazar-install.yml