Virtual Machine High Availability (VMHA) service for OpenStack.
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Go to file
Zuul c6afc1bc8f Merge "add pre-commit" 6 days ago
api-ref/source add api-ref for masakari vmoves 4 months ago
devstack Fix auth_url setting for devstack 2 years ago
doc add api-ref for masakari vmoves 4 months ago
etc/masakari Merge "Remove a sample file of masakari.conf" 2 years ago
masakari extend wait period for process notification 1 week ago
playbooks/devstack [CI] Let Masakari jobs be used from other projects 2 years ago
releasenotes Merge "releasenote for Masakari VMove" 3 months ago
roles/devstack-config/tasks Fix files to pass linting 3 years ago
tools Enable database migration unit tests 2 years ago
.coveragerc Initial Cookiecutter Commit. 7 years ago
.gitignore Reorganize masakari documentation 4 years ago
.gitreview OpenDev Migration Patch 4 years ago
.mailmap Initial Cookiecutter Commit. 7 years ago
.pre-commit-config.yaml add pre-commit 1 week ago
.stestr.conf Switch to using stestr 5 years ago
.yamllint Use some better linting 3 years ago
.zuul.yaml [CI] Move queue setting to project level 9 months ago
CONTRIBUTING.rst [community goal] Update contributor documentation 2 years ago
HACKING.rst add pre-commit 1 week ago
LICENSE Initial Cookiecutter Commit. 7 years ago Drop - it's not needed by pbr 7 years ago
README.rst Merge "Simplify endpoints created by devstack plugin" 2 years ago
bindep.txt Replace python-dev with python3-dev in bindep 11 months ago
requirements.txt Use new get_rpc_client API from oslo.messaging 5 months ago
setup.cfg vm moves for host notification 4 months ago Cleanup py27 support 10 months ago
test-requirements.txt Use some better linting 3 years ago
tox.ini Fix tox4 issues 6 months ago



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:

Tokyo Summit Session:

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" instance-ha
  4. Create endpoint for masakari service:

    openstack endpoint create --region RegionOne masakari --publicurl http://<ip-address>:<port>/v1/%\(tenant_id\)s
  5. Clone masakari using

    git clone
  6. Run from masakari

    sudo python install
  7. Create directory /etc/masakari

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

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


Configure masakari database

  1. Create 'masakari' database

  2. After running for masakari (sudo python install), run masakari-manage command to sync the database

    masakari-manage db sync


  • TODO