Metadata-Version: 2.1
Name: masakari-monitors
Version: 5.0.1.dev4
Summary: Monitors for Masakari
Home-page: http://www.openstack.org/
Author: OpenStack
Author-email: openstack-dev@lists.openstack.org
License: UNKNOWN
Platform: UNKNOWN
Classifier: Environment :: OpenStack
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Requires-Dist: libvirt-python (>=1.2.5)
Requires-Dist: openstacksdk (>=0.11.0)
Requires-Dist: oslo.concurrency (>=3.8.0)
Requires-Dist: oslo.config (!=4.3.0,!=4.4.0,>=4.0.0)
Requires-Dist: oslo.i18n (!=3.15.2,>=2.1.0)
Requires-Dist: oslo.log (>=3.22.0)
Requires-Dist: oslo.middleware (>=3.27.0)
Requires-Dist: oslo.privsep (!=1.17.0,>=1.9.0)
Requires-Dist: oslo.service (>=1.10.0)
Requires-Dist: oslo.utils (>=3.20.0)
Requires-Dist: pbr (!=2.1.0,>=2.0.0)
Requires-Dist: python-masakariclient (>=3.0.1)
Requires-Dist: python-openstackclient (!=3.10.0,>=3.3.0)
Requires-Dist: six (>=1.9.0)

===============================
masakari-monitors
===============================

Monitors for Masakari
=====================

Monitors for Masakari provides Virtual Machine High Availability (VMHA) service
for OpenStack clouds by automatically detecting the failure events
such as VM process down, provisioning process down, and nova-compute host failure.
If it detect the events, it sends notifications to the masakari-api.

Original version of Masakari: https://github.com/ntt-sic/masakari

Tokyo Summit Session: https://www.youtube.com/watch?v=BmjNKceW_9A

Monitors for Masakari is distributed under the terms of the Apache License,
Version 2.0. The full terms and conditions of this license are
detailed in the LICENSE file.

* Free software: Apache license
* Documentation: http://docs.openstack.org/developer/masakari-monitors
* Source: http://git.openstack.org/cgit/openstack/masakari-monitors
* Bugs: http://bugs.launchpad.net/masakari-monitors


Configure masakari-monitors
---------------------------

#. Clone masakari using::

   $ git clone https://github.com/openstack/masakari-monitors.git

#. Create masakarimonitors directory in /etc/.

#. Run setup.py from masakari-monitors::

   $ sudo python setup.py install

#. Copy masakarimonitors.conf and process_list.yaml files from
   masakari-monitors/etc/ to /etc/masakarimonitors folder and make necessary
   changes to the masakarimonitors.conf and process_list.yaml files.
   To generate the sample masakarimonitors.conf file, run the following
   command from the top level of the masakari-monitors directory::

   $ tox -egenconfig

#. To run masakari-processmonitor, masakari-hostmonitor and
   masakari-instancemonitor simply use following binary::

   $ masakari-processmonitor
   $ masakari-hostmonitor
   $ masakari-instancemonitor

If you are intend to use bash scripts of masakari-processmonitor and
masakari-hostmonitor, use following steps to install them.
However, those bash shell scripts are deprecated as of the Ocata release and
will be removed in the Queens release.
Use above masakari-hostmonitors implemented in python instead.

#. Clone masakari using::

   $ git clone https://github.com/openstack/masakari-monitors.git

#. Create masakarimonitors directory in /etc/.

#. Remove '.sample' from files hostmonitor.conf.sample,
   processmonitor.conf.sample and proc.list.sample which exist at
   masakari-monitors/etc/.

#. Copy hostmonitor.conf, processmonitor.conf and proc.list files from
   masakari-monitors/etc/ to /etc/masakarimonitors folder and make necessary
   changes to the hostmonitor.conf, processmonitor.conf and proc.list files.

#. To run bash scripts of masakari-processmonitor and masakari-hostmonitor
   simply use following binary::

   $ masakari-processmonitor.sh /etc/masakarimonitors/processmonitor.conf /etc/masakarimonitors/proc.list
   $ masakari-hostmonitor.sh /etc/masakarimonitors/hostmonitor.conf


Features
--------

* TODO



