Add README.rst

This patch adds README.rst of masakari-monitors.

Change-Id: I521c3f248d0931d736b7ebcaa84137a2b5939eeb
Implements: bp pythonize-host-and-process-monitor

README.rst

@@ -4,15 +4,85 @@ masakari-monitors
 
 Monitors for Masakari
 
-Please fill here a long description which must be at least 3 lines wrapped on
-80 cols, so that distribution package maintainers can use it in their packages.
-Note that this is a hard requirement.
+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
 --------