Docs: Adding Blazar installation guide using OpenStack Ansible
[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 Get the Blazar extra code:
18
19 .. code:: bash
20
21   # git pull https://git.openstack.org/openstack/openstack-ansible refs/changes/56/549956/31
22
23 .. note::
24    At the time of writing, work is still ongoing upstream in OpenStack.
25    Therefore, it is recommended to set ANSIBLE_ROLE_FETCH_MODE to git-clone.
26
27 .. code:: bash
28
29    # export ANSIBLE_ROLE_FETCH_MODE=git-clone
30    # scripts/bootstrap-ansible.sh
31    # scripts/bootstrap-aio.sh
32
33 Enable Blazar:
34
35 .. code:: bash
36
37    # cp etc/openstack_deploy/conf.d/blazar.yml.aio /etc/openstack_deploy/conf.d/
38    # cd /etc/openstack_deploy/conf.d
39    # mv blazar.yml.aio blazar.yml
40
41 Run Ansible playbooks:
42
43 .. code:: bash
44
45    # cd /opt/openstack-ansible/playbooks
46    # openstack-ansible setup-hosts.yml
47    # openstack-ansible setup-infrastructure.yaml
48    # openstack-ansible setup-openstack.yml
49
50 Once the playbooks have successfully executed, it is possible to make some
51 modifications to the Blazar Ansible role in /etc/ansible/roles/os_blazar
52 and re-install the Blazar service by executing:
53
54 .. code:: bash
55
56    # cd /opt/openstack-ansible/playbooks
57    # openstack-ansible os-blazar-install.yml