Metadata-Version: 2.0
Name: masakari
Version: 4.0.0.0rc1
Summary: Virtual Machine High Availability (VMHA) service for OpenStack
Home-page: https://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: Babel (!=2.4.0,>=2.3.4)
Requires-Dist: iso8601 (>=0.1.11)
Requires-Dist: jsonschema (!=2.5.0,<3.0.0,>=2.0.0)
Requires-Dist: keystoneauth1 (>=2.21.0)
Requires-Dist: keystonemiddleware (>=4.12.0)
Requires-Dist: microversion-parse (>=0.1.2)
Requires-Dist: oslo.config (!=4.4.0,!=4.3.0,>=4.0.0)
Requires-Dist: oslo.db (>=4.23.0)
Requires-Dist: oslo.i18n (>=2.1.0,!=3.15.2)
Requires-Dist: oslo.log (>=3.22.0)
Requires-Dist: oslo.messaging (!=5.25.0,>=5.24.2)
Requires-Dist: oslo.middleware (>=3.27.0)
Requires-Dist: oslo.policy (>=1.23.0)
Requires-Dist: oslo.service (>=1.10.0)
Requires-Dist: oslo.utils (>=3.20.0)
Requires-Dist: oslo.versionedobjects (>=1.17.0)
Requires-Dist: pbr (!=2.1.0,>=2.0.0)
Requires-Dist: python-novaclient (>=9.0.0)
Requires-Dist: setuptools (!=34.0.2,!=34.1.1,!=34.0.3,!=34.1.0,!=34.0.0,!=34.0.1,!=34.3.1,!=24.0.0,!=34.3.0,!=34.2.0,>=16.0,!=34.3.2)
Requires-Dist: six (>=1.9.0)
Requires-Dist: stevedore (>=1.20.0)
Requires-Dist: taskflow (>=2.7.0)

===============================
Masakari
===============================

Virtual Machine High Availability (VMHA) service for OpenStack

Masakari provides Virtual Machine High Availability (VMHA) service
for OpenStack clouds by automatically recovering the KVM-based Virtual
Machine(VM)s from failure events such as VM process down,
provisioning process down, and nova-compute host failure.
It also provides API service for manage and control the automated
rescue mechanism.

NOTE:
Use masakari only if instance path is configured on shared storage system
i.e, 'instances_path' config option of nova has a path of shared directory
otherwise instance data will be lost after the evacuation of instance from
failed host if,
* instance is booted from image
* flavor using ephemeral disks is used

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

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

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 2.0
* Documentation: https://docs.openstack.org/developer/masakari
* Source: https://git.openstack.org/cgit/openstack/masakari
* Bugs: https://bugs.launchpad.net/masakari


Configure masakari-api
----------------------

1. Create masakari user:
$ openstack user create --password-prompt masakari
(give password as masakari)

2. Add admin role to masakari user:
$ openstack role add --project service --user masakari admin

3. Create new service:
$ openstack service create --name masakari --description "masakari high availability" masakari

4. Create endpoint for masakari service:
$ openstack endpoint create --region RegionOne masakari --publicurl http://<ip-address>:<port>/v1/%\(tenant_id\)s --adminurl http://<ip-address>:<port>/v1/%\(tenant_id\)s --internalurl http://<ip-address>:<port>/v1/%\(tenant_id\)s

5. Clone masakari using
$ git clone https://github.com/openstack/masakari.git

6. Run setup.py from masakari
$ sudo python setup.py install

7. Create masakari directory in /etc/

8. Copy masakari.conf, api-paste.ini and policy.json file from masakari/etc/ to
   /etc/masakari folder

9. To run masakari-api simply use following binary:
$ masakari-api


Configure masakari database
---------------------------

1. Create 'masakari' database

2. After running setup.py for masakari '$ sudo python setup.py install'
    run 'masakari-manage' command to sync the database
    $ masakari-manage db sync


Features
--------

* TODO



