Virtual Machine High Availability (VMHA) service for OpenStack.
Go to file
Jenkins 93556d3116 Merge "Make 'error' instances recovery configurable" 2017-08-17 06:08:52 +00:00
devstack Fix identity_admin 2017-06-06 17:24:13 +00:00
doc/source Initial Cookiecutter Commit. 2016-06-28 13:28:27 +09:00
etc/masakari Add missing namespaces in masakari-config-generator.conf 2016-11-18 11:53:22 +00:00
masakari Merge "Make 'error' instances recovery configurable" 2017-08-17 06:08:52 +00:00
releasenotes Merge "Make 'error' instances recovery configurable" 2017-08-17 06:08:52 +00:00
.coveragerc Initial Cookiecutter Commit. 2016-06-28 13:28:27 +09:00
.gitignore Initial Cookiecutter Commit. 2016-06-28 13:28:27 +09:00
.gitreview Added .gitreview 2016-06-23 06:57:16 +00:00
.mailmap Initial Cookiecutter Commit. 2016-06-28 13:28:27 +09:00
.testr.conf Initial Cookiecutter Commit. 2016-06-28 13:28:27 +09:00
CONTRIBUTING.rst Optimize the link address 2017-06-08 18:37:08 +07:00
HACKING.rst Merge "Update the documentation link for doc migration" 2017-08-16 07:05:10 +00:00
LICENSE Initial Cookiecutter Commit. 2016-06-28 13:28:27 +09:00
MANIFEST.in Drop MANIFEST.in - it's not needed by pbr 2016-10-13 16:55:15 +05:30
README.rst Remove 'on_shared_storage' parameter from nova evacuate 2017-07-21 05:44:49 +00:00
babel.cfg Initial Cookiecutter Commit. 2016-06-28 13:28:27 +09:00
requirements.txt Updated from global requirements 2017-06-20 11:45:10 +00:00
setup.cfg Remove support for py34 2017-07-11 15:33:14 +07:00
setup.py Updated from global requirements 2017-04-02 01:04:58 +00:00
test-requirements.txt Use os-testr instead of testr 2017-07-05 17:37:52 +05:30
tox.ini Enable global hacking checks and remove local checks 2017-08-04 04:55:18 +00:00

README.rst

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.

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

  1. Create masakari directory in /etc/
  2. 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