Virtual Machine High Availability (VMHA) service for OpenStack.
Clone or download
Permalink
Failed to load latest commit information.
api-ref/source Fix typo in api-ref/source/failover-segments.inc file May 8, 2018
devstack Added devstack support for masakari-dashboard Jul 31, 2018
doc Add hooks for recovery method customization plugins Aug 2, 2018
etc/masakari Add masakari-custom-recovery-methods.conf in etc/masakari Aug 13, 2018
masakari Add hooks for recovery method customization plugins Aug 2, 2018
releasenotes Update reno for stable/rocky Aug 9, 2018
.coveragerc Initial Cookiecutter Commit. Jun 28, 2016
.gitignore Register and Document policy in code Jul 27, 2018
.gitreview Added .gitreview Jun 23, 2016
.mailmap Initial Cookiecutter Commit. Jun 28, 2016
.stestr.conf Switch to using stestr Jul 3, 2018
.testr.conf Initial Cookiecutter Commit. Jun 28, 2016
.zuul.yaml switch documentation job to new PTI Aug 17, 2018
CONTRIBUTING.rst Optimize the link address Jun 8, 2017
HACKING.rst Register and Document policy in code Jul 27, 2018
LICENSE Initial Cookiecutter Commit. Jun 28, 2016
MANIFEST.in Drop MANIFEST.in - it's not needed by pbr Oct 13, 2016
README.rst Merge "Make readme more readable" Apr 10, 2018
babel.cfg Initial Cookiecutter Commit. Jun 28, 2016
lower-constraints.txt Switch to using stestr Jul 3, 2018
requirements.txt Make accept-language tests work with webob 1.8.x May 21, 2018
setup.cfg Add hooks for recovery method customization plugins Aug 2, 2018
setup.py Updated from global requirements Apr 2, 2017
test-requirements.txt Switch to using stestr Jul 3, 2018
tox.ini Add hooks for recovery method customization plugins Aug 2, 2018

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

  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