vitrage/doc/source/install/install-rdo.rst

Install and configure for Red Hat Enterprise Linux and CentOS

This section describes how to install and configure the Root Cause Analysis service for Red Hat Enterprise Linux 7 and CentOS 7.

Manual

Install Vitrage

Install Vitrage and python-vitrageclient

1. Install Vitrage:

$ sudo pip install vitrage

$ sudo pip install python-vitrageclient

To install a specific version, add the version number:

$ sudo pip install vitrage==VITRAGE_VERSION

$ sudo pip install python-vitrageclient==VITRAGE_CLIENT_VERSION

Release version	Vitrage version	Client version
Ocata	1.5.1	1.1.1
Pike	1.8.2	1.4.0
Queens	...	...

Configure Vitrage

Create the Vitrage folders

1. Create /etc/vitrage folder and sub folders, with permission 755:

$ mkdir /etc/vitrage
$ chmod 755 /etc/vitrage

$ mkdir /etc/vitrage/static_datasources
$ chmod 755 /etc/vitrage/static_datasources

$ sudo mkdir /var/log/vitrage
$ sudo chmod 755 /var/log/vitrage

Copy api-paste.ini to /etc/vitrage/

Copy the datasources_values folder with its content under /etc/vitrage/

Note: You don't need to copy all files in this folder, only the ones that belong to datasources you plan to use. The only file that must be copied is vitrage.yaml

Create the vitrage.conf file

Create /etc/vitrage/vitrage.conf file with the following information:

[DEFAULT]
# debug = False
transport_url = <transport-url>
# notifiers = nova

[service_credentials]
auth_url = http://<ip>:5000
region_name = RegionOne
project_name = admin
password = <password>
project_domain_id = default
user_domain_id = default
username = admin
auth_type = password

[keystone_authtoken]
auth_uri = http://<ip>:5000
project_domain_name = Default
project_name = service
user_domain_name = Default
password = <password>
username = vitrage
auth_url = http://<ip>:5000
auth_type = password

Replace <ip> with your controller node's IP. Set the list of datasource you would like to use for Vitrage.

Note: In order for a datasource to be supported, the underlying component (like Neutron, Heat, Zabbix, etc.) should be installed separately.

[datasources]
types = nova.host,nova.instance,nova.zone,static,aodh,cinder.volume,neutron.network,neutron.port,heat.stack,doctor

Configure notifications from other datasources

Notifications from Aodh

In order to configure notifications from Aodh to Vitrage, set the following in `/etc/aodh/aodh.conf`:

[oslo_messaging_notifications]
driver = messagingv2
topics = notifications,vitrage_notifications

Notifications from other OpenStack components

In order to configure notifications from OpenStack components (Nova, Cinder, Neutron, Heat and Aodh) to Vitrage, set the following in their conf files:

[DEFAULT]
notification_topics = notifications,vitrage_notifications
notification_driver=messagingv2

[notifications] versioned_notifications_topics = versioned_notifications,vitrage_notifications notification_driver = messagingv2

Initialize Vitrage

Create the Vitrage account

openstack user create vitrage --password password --domain=Default
openstack role add admin --user vitrage --project service
openstack role add admin --user vitrage --project admin

Create the Vitrage endpoint

openstack service create rca --name vitrage --description="Root Cause Analysis Service"
openstack endpoint create vitrage --region <region> public http://<ip>:8999
openstack endpoint create vitrage --region <region> internal http://<ip>:8999
openstack endpoint create vitrage --region <region> admin http://<ip>:8999

Start the Vitrage Services

Run the following commands:

vitrage-graph
vitrage-api
vitrage-notifier
vitrage-persistor
vitrage-ml

Install the Vitrage Dashboard

Follow the vitrage-dashboard installation procedure.

Automatic

Automatic installation for RDO is in progress; the patch can be found on the RDO Gerrit