openstack/masakari
Code Issues Proposed changes
Virtual Machine High Availability (VMHA) service for OpenStack.
353 Commits 12 Branches 40 Tags 9.6 MiB
Python 98.8%
Shell 1.1%
e8a18eee83
Go to file
OpenDev Sysadmins e8a18eee83 OpenDev Migration Patch 
This commit was bulk generated and pushed by the OpenDev sysadmins
as a part of the Git hosting and code review systems migration
detailed in these mailing list posts:

http://lists.openstack.org/pipermail/openstack-discuss/2019-March/003603.html
http://lists.openstack.org/pipermail/openstack-discuss/2019-April/004920.html

Attempts have been made to correct repository namespaces and
hostnames based on simple pattern matching, but it's possible some
were updated incorrectly or missed entirely. Please reach out to us
via the contact information listed at https://opendev.org/ with any
questions you may have.
2019-04-19 19:36:34 +00:00
api-ref/source Add progress details for recovery workflows 2019-03-08 10:52:51 +05:30
devstack Merge "Replace openstack.org git:// URLs with https://" 2019-04-10 00:42:35 +00:00
doc Switch from oslosphinx to openstackdocstheme 2019-04-10 09:07:04 -05:00
etc/masakari fix oslo-config-generator conf 2019-03-12 15:53:17 +08:00
masakari Merge "Functional tests to check recovery workflow details" 2019-03-22 04:07:39 +00:00
playbooks/devstack Add functional CI job and tests for segments 2019-03-05 12:22:07 +05:30
releasenotes Switch from oslosphinx to openstackdocstheme 2019-04-10 09:07:04 -05:00
roles/devstack-config/tasks Add functional CI job and tests for segments 2019-03-05 12:22:07 +05:30
.coveragerc Initial Cookiecutter Commit. 2016-06-28 13:28:27 +09:00
.gitignore Merge "Remove testrepository" 2018-12-18 06:52:22 +00:00
.gitreview OpenDev Migration Patch 2019-04-19 19:36:34 +00:00
.mailmap Initial Cookiecutter Commit. 2016-06-28 13:28:27 +09:00
.stestr.conf Switch to using stestr 2018-07-03 12:02:08 -04:00
.zuul.yaml OpenDev Migration Patch 2019-04-19 19:36:34 +00:00
babel.cfg 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 Register and Document policy in code 2018-07-27 12:15:14 +05:30
LICENSE Initial Cookiecutter Commit. 2016-06-28 13:28:27 +09:00
lower-constraints.txt Add progress details for recovery workflows 2019-03-08 10:52:51 +05:30
MANIFEST.in Drop MANIFEST.in - it's not needed by pbr 2016-10-13 16:55:15 +05:30
README.rst Update README 2018-11-27 05:42:04 +00:00
requirements.txt Switch from oslosphinx to openstackdocstheme 2019-04-10 09:07:04 -05:00
setup.cfg Change openstack-dev to openstack-discuss 2018-12-04 11:35:40 +08:00
setup.py Updated from global requirements 2017-04-02 01:04:58 +00:00
test-requirements.txt Switch from oslosphinx to openstackdocstheme 2019-04-10 09:07:04 -05:00
tox.ini Switch from oslosphinx to openstackdocstheme 2019-04-10 09:07:04 -05: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" 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