Metadata-Version: 2.1
Name: masakari-monitors
Version: 3.0.2.dev2
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.3
Classifier: Programming Language :: Python :: 3.4
Requires-Dist: libvirt-python (>=1.2.5)
Requires-Dist: oslo.concurrency (>=3.8.0)
Requires-Dist: oslo.config (>=3.10.0)
Requires-Dist: oslo.i18n (>=2.1.0)
Requires-Dist: oslo.log (>=1.14.0)
Requires-Dist: oslo.middleware (>=3.0.0)
Requires-Dist: oslo.privsep (>=1.9.0)
Requires-Dist: oslo.service (>=1.10.0)
Requires-Dist: oslo.utils (>=3.11.0)
Requires-Dist: pbr (>=1.8)
Requires-Dist: python-masakariclient (>=2.0.1.dev5)
Requires-Dist: python-openstackclient (>=3.3.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.

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

#. Create masakarimonitors directory in /etc/.

#. Run setup.py from masakari-monitors.

command::
    $ 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:

command::
    $ tox -egenconfig

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

command::
   $ 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.

command::
    $ 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:

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


Features
--------

* TODO



