Metadata-Version: 2.1
Name: masakari-monitors
Version: 7.0.2.dev1
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: automaton (>=1.9.0)
Requires-Dist: libvirt-python (!=4.1.0,>=3.5.0)
Requires-Dist: lxml (!=3.7.0,>=3.4.1)
Requires-Dist: openstacksdk (>=0.13.0)
Requires-Dist: oslo.cache (>=1.26.0)
Requires-Dist: oslo.concurrency (>=3.26.0)
Requires-Dist: oslo.config (>=5.2.0)
Requires-Dist: oslo.i18n (>=3.15.3)
Requires-Dist: oslo.log (>=3.36.0)
Requires-Dist: oslo.middleware (>=3.31.0)
Requires-Dist: oslo.privsep (>=1.23.0)
Requires-Dist: oslo.service (!=1.28.1,>=1.24.0)
Requires-Dist: oslo.utils (>=3.33.0)
Requires-Dist: pbr (!=2.1.0,>=2.0.0)
Requires-Dist: six (>=1.10.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



