Virtual Machine High Availability (VMHA) service for OpenStack.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
uchenily 8b122a8627 fix a typo notiification => notification 4 weeks ago
api-ref/source fix a typo notiification => notification 4 weeks ago
devstack Replace git.openstack.org URLs with opendev.org URLs 5 months ago
doc Reorganize masakari documentation 3 months ago
etc/masakari Support noauth2 auth_strategy 3 months ago
masakari fix a typo notiification => notification 4 weeks ago
playbooks/devstack Add functional CI job and tests for segments 10 months ago
releasenotes Update master for stable/train 4 months ago
roles/devstack-config/tasks Add functional CI job and tests for segments 10 months ago
.coveragerc Initial Cookiecutter Commit. 3 years ago
.gitignore Reorganize masakari documentation 3 months ago
.gitreview OpenDev Migration Patch 9 months ago
.mailmap Initial Cookiecutter Commit. 3 years ago
.stestr.conf Switch to using stestr 1 year ago
.zuul.yaml Add Python 3 Train unit tests 5 months ago
CONTRIBUTING.rst Optimize the link address 2 years ago
HACKING.rst Register and Document policy in code 1 year ago
LICENSE Initial Cookiecutter Commit. 3 years ago
MANIFEST.in Drop MANIFEST.in - it's not needed by pbr 3 years ago
README.rst Replace git.openstack.org URLs with opendev.org URLs 5 months ago
babel.cfg Initial Cookiecutter Commit. 3 years ago
bindep.txt add libpq-dev and python-dev to build psycopg2 5 months ago
lower-constraints.txt Add progress details for recovery workflows 10 months ago
requirements.txt Switch from oslosphinx to openstackdocstheme 9 months ago
setup.cfg Reorganize masakari documentation 3 months ago
setup.py Updated from global requirements 2 years ago
test-requirements.txt Switch from oslosphinx to openstackdocstheme 9 months ago
tox.ini Reorganize masakari documentation 3 months ago

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" instance-ha
  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