Virtual Machine High Availability (VMHA) service for OpenStack.
Go to file
bhagyashris 4299b38883 Enable mutable config in Masakari
New releases of oslo.config support a 'mutable' parameter to Opts.
This is only respected when the new method mutate_config_files is
called instead of reload_config_files. Masakari delegates making
this call to oslo.service, so how do we switch?
Icec3e664f3fe72614e373b2938e8dee53cf8bc5e allows services to tell
oslo.service they want mutate_config_files to be called by passing a
parameter, which this patch does.

This allows Masakari to benefit from
I1e7a69de169cc85f4c09954b2f46ce2da7106d90, where the 'debug' option
(owned by oslo.log) is made mutable. We should be able to turn debug
logging on and off by changing the config and sending SIGHUP.
Also in this patch configuration parameter
'retry_notification_new_status_interval' is marked as mutable.

Part of bp:mutable-config

Change-Id: Icf4438b98420eb0e9d35a19cf88831f359c74fe5
2018-05-11 16:10:46 +05:30
api-ref/source Masakari API Specifications 2017-11-27 05:29:45 +00:00
devstack Merge "Change masakari service-type from 'ha' to 'instance-ha'" 2018-05-11 07:48:14 +00:00
doc Masakari operator's documentation 2017-11-27 05:31:21 +00:00
etc/masakari Add missing namespaces in masakari-config-generator.conf 2016-11-18 11:53:22 +00:00
masakari Enable mutable config in Masakari 2018-05-11 16:10:46 +05:30
releasenotes Enable mutable config in Masakari 2018-05-11 16:10:46 +05:30
.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
.zuul.yaml add lower-constraints job 2018-04-20 16:23:35 -04:00
CONTRIBUTING.rst Optimize the link address 2017-06-08 18:37:08 +07:00
HACKING.rst Hacking: do not translate log messages 2017-09-25 14:34:25 +05:30
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 Merge "Make readme more readable" 2018-04-10 10:06:11 +00:00
babel.cfg Initial Cookiecutter Commit. 2016-06-28 13:28:27 +09:00
lower-constraints.txt add lower-constraints job 2018-04-20 16:23:35 -04:00
requirements.txt add lower-constraints job 2018-04-20 16:23:35 -04:00
setup.cfg Ship files like other openstack projects 2018-04-05 14:17:47 +00:00
setup.py Updated from global requirements 2017-04-02 01:04:58 +00:00
test-requirements.txt Updated from global requirements 2018-03-23 20:25:03 +00:00
tox.ini add lower-constraints job 2018-04-20 16:23:35 -04: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
  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