https://github.com/openstack/masakari

Virtual Machine High Availability (VMHA) service for OpenStack. Mirror of code maintained at opendev.org.
https://github.com/openstack/masakari

service

Last synced: about 1 year ago
JSON representation

Virtual Machine High Availability (VMHA) service for OpenStack. Mirror of code maintained at opendev.org.

• Host: GitHub
• URL: https://github.com/openstack/masakari
• Owner: openstack
• License: apache-2.0
• Created: 2016-06-23T06:57:38.000Z (about 10 years ago)
• Default Branch: master
• Last Pushed: 2025-04-02T10:50:22.000Z (over 1 year ago)
• Last Synced: 2025-04-13T00:49:29.592Z (about 1 year ago)
• Topics: service
• Language: Python
• Homepage: https://opendev.org/openstack/masakari
• Size: 1.56 MB
• Stars: 60
• Watchers: 8
• Forks: 26
• Open Issues: 0
• Metadata Files:
  • Readme: README.rst
  • Contributing: CONTRIBUTING.rst
  • License: LICENSE

Awesome Lists containing this project

README

          
========

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.

* Free software: Apache license 2.0

* Documentation: https://docs.openstack.org/masakari/latest

* Release notes: https://docs.openstack.org/releasenotes/masakari/

* Source: https://opendev.org/openstack/masakari

* Bugs: https://bugs.launchpad.net/masakari

Configure masakari-api

----------------------

#. Create masakari user:

   .. code-block:: shell-session

      openstack user create --password-prompt masakari

      (give password as masakari)

#. Add admin role to masakari user:

   .. code-block:: shell-session

      openstack role add --project service --user masakari admin

#. Create new service:

   .. code-block:: shell-session

      openstack service create --name masakari --description "masakari high availability" instance-ha

#. Create endpoint for masakari service:

   .. code-block:: shell-session

      openstack endpoint create --region RegionOne masakari --publicurl http://:/v1/%\(tenant_id\)s

#. Clone masakari using

   .. code-block:: shell-session

      git clone https://github.com/openstack/masakari.git

#. Run setup.py from masakari

   .. code-block:: shell-session

      sudo python setup.py install

#. Create directory ``/etc/masakari``

#. Copy ``masakari.conf``, ``api-paste.ini`` and ``policy.yaml`` file

   from ``masakari/etc/`` to ``/etc/masakari`` folder

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

   .. code-block:: shell-session

      masakari-api

Configure masakari database

---------------------------

#. Create 'masakari' database

#. After running setup.py for masakari (``sudo python setup.py install``),

   run ``masakari-manage`` command to sync the database

   .. code-block:: shell-session

      masakari-manage db sync

Features

--------

* TODO