Added manual installation documentation
Change-Id: I18e1b706dfa95614bafca8c2ed13d279befe46f9
This commit is contained in:
Ifat Afek
parent
1c1fbb4cc7
commit
0e0621bc5c
@ -2,22 +2,40 @@
|
||||
Installation
|
||||
============
|
||||
|
||||
-------------------------------
|
||||
Enable Vitrage and data sources
|
||||
-------------------------------
|
||||
Vitrage Installation
|
||||
====================
|
||||
|
||||
To Install Vitrage, use **either** devstack installation or manual installation
|
||||
|
||||
--------------------------
|
||||
Enable Vitrage in Devstack
|
||||
--------------------------
|
||||
|
||||
* `Enabling Vitrage in devstack <https://github.com/openstack/vitrage/blob/master/devstack/README.rst>`_
|
||||
|
||||
* `Enabling Vitrage in horizon <https://github.com/openstack/vitrage-dashboard/blob/master/README.rst>`_
|
||||
|
||||
---------------------------------------------------
|
||||
Manual Installation of Vitrage (not using Devstack)
|
||||
---------------------------------------------------
|
||||
|
||||
* `Vitrage manual installation <https://github.com/openstack/vitrage/blob/master/doc/source/vitrage-manual-installation.rst>`_
|
||||
|
||||
* `Vitrage-dashboard manual installation <https://github.com/openstack/vitrage-dashboard/blob/master/doc/source/vitrage-dashboard-manual-installation.rst>`_
|
||||
|
||||
|
||||
External Monitor Installation
|
||||
=============================
|
||||
|
||||
To install Nagios or Zabbix external monitors:
|
||||
|
||||
* `Nagios devstack installation <http://docs.openstack.org/developer/vitrage/nagios-devstack-installation.html>`_
|
||||
|
||||
* `Zabbix devstack installation <http://docs.openstack.org/developer/vitrage/zabbix_vitrage.html>`_
|
||||
|
||||
|
||||
-------------
|
||||
Configuration
|
||||
-------------
|
||||
=============
|
||||
|
||||
* `Nagios Plugin Configuration <http://docs.openstack.org/developer/vitrage/nagios-config.html>`_
|
||||
|
||||
|
||||
172
doc/source/vitrage-manual-installation.rst
Normal file
172
doc/source/vitrage-manual-installation.rst
Normal file
@ -0,0 +1,172 @@
|
||||
===========================
|
||||
Vitrage Manual Installation
|
||||
===========================
|
||||
|
||||
Install Vitrage
|
||||
===============
|
||||
|
||||
Install vitrage and python-vitrageclient
|
||||
----------------------------------------
|
||||
|
||||
To install the Ocata release:
|
||||
|
||||
.. code:: bash
|
||||
|
||||
sudo pip install vitrage==1.5.1
|
||||
sudo pip install python-vitrageclient==1.1.1
|
||||
|
||||
|
||||
Or, to install the latest version:
|
||||
|
||||
.. code:: bash
|
||||
|
||||
sudo pip install vitrage
|
||||
sudo pip install python-vitrageclient
|
||||
|
||||
|
||||
Configure Vitrage
|
||||
=================
|
||||
|
||||
Create the Vitrage folders
|
||||
--------------------------
|
||||
|
||||
Create /etc/vitrage folder and sub folders, **with permission 755**
|
||||
|
||||
.. code:: bash
|
||||
|
||||
mkdir /etc/vitrage
|
||||
chmod 755 /etc/vitrage
|
||||
|
||||
mkdir /etc/vitrage/static_datasources
|
||||
chmod 755 /etc/vitrage/static_datasources
|
||||
|
||||
mkdir /etc/vitrage/templates
|
||||
chmod 755 /etc/vitrage/templates
|
||||
|
||||
sudo mkdir /var/log/vitrage
|
||||
sudo chmod 755 /var/log/vitrage
|
||||
|
||||
Copy `policy.json`_ to /etc/vitrage/
|
||||
|
||||
Copy `api-paste.ini`_ to /etc/vitrage/
|
||||
|
||||
Copy the `datasources_values`_ folder with its content
|
||||
|
||||
**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
|
||||
|
||||
.. _policy.json: ../../etc/vitrage/policy.json
|
||||
.. _api-paste.ini: ../../etc/vitrage/api-paste.ini
|
||||
.. _datasources_values: ../../etc/vitrage/datasources_values
|
||||
|
||||
Create the vitrage.conf file
|
||||
----------------------------
|
||||
|
||||
Create /etc/vitrage/vitrage.conf file with the following information:
|
||||
|
||||
.. code:: bash
|
||||
|
||||
[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>:35357
|
||||
auth_type = password
|
||||
|
||||
|
||||
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.
|
||||
|
||||
.. code:: bash
|
||||
|
||||
[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`:
|
||||
|
||||
.. code:: bash
|
||||
|
||||
[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:
|
||||
|
||||
.. code:: bash
|
||||
|
||||
[DEFAULT]
|
||||
notification_topics = notifications,vitrage_notifications
|
||||
notification_driver=messagingv2
|
||||
|
||||
|
||||
Initialize Vitrage
|
||||
==================
|
||||
|
||||
Create the Vitrage account
|
||||
--------------------------
|
||||
|
||||
.. code:: bash
|
||||
|
||||
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
|
||||
---------------------------
|
||||
|
||||
.. code:: bash
|
||||
|
||||
openstack service create rca --name vitrage --description="Root Cause Analysis Service"
|
||||
openstack endpoint create --region <region> --publicurl http://<ip>:8999 --internalurl http://<ip>:8999 --adminurl http://<ip>:8999 vitrage
|
||||
|
||||
|
||||
Start the Vitrage Services
|
||||
==========================
|
||||
|
||||
Run the following commands:
|
||||
|
||||
.. code:: bash
|
||||
|
||||
vitrage-graph
|
||||
vitrage-api
|
||||
vitrage-notifier
|
||||
|
||||
|
||||
Install the Vitrage Dashboard
|
||||
=============================
|
||||
|
||||
Follow vitrage-dashboard_ installation procedure
|
||||
|
||||
.. _vitrage-dashboard: https://github.com/openstack/vitrage-dashboard/tree/master/doc/source/installation.rst
|
||||
Loading…
Reference in New Issue
Block a user