Skip to main content
https://governance.openstack.org/tc/badges/masakari.svg

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
  5. Clone masakari using

    git clone https://opendev.org/openstack/masakari
  6. Run setup.py from masakari

    sudo python3 setup.py 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:

    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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

masakari-21.0.0.tar.gz (364.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

masakari-21.0.0-py3-none-any.whl (354.2 kB view details)

Uploaded Python 3

File details

Details for the file masakari-21.0.0.tar.gz.

File metadata

  • Download URL: masakari-21.0.0.tar.gz
  • Upload date:
  • Size: 364.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.14

File hashes

Hashes for masakari-21.0.0.tar.gz
Algorithm Hash digest
SHA256 16f3c53d2b0c9fdcc201e6191101844ab131bed6abde1dd316a59d2a217dc476
MD5 32f7356a1d7e1934c82c53f2593519ad
BLAKE2b-256 40b16ba7860788fa94c2fc5a10c6a9d53415bc3eb70575e91aabfb7f3b6a45ee

See more details on using hashes here.

File details

Details for the file masakari-21.0.0-py3-none-any.whl.

File metadata

  • Download URL: masakari-21.0.0-py3-none-any.whl
  • Upload date:
  • Size: 354.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.14

File hashes

Hashes for masakari-21.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 7c43042e26f06fbd93ae79729193ab86e79e73cebdb1af6d616074ec748b1e71
MD5 c6b75143a6f2c002d347d4947b57fc3c
BLAKE2b-256 fe85abd6d2307e75bb4faf971d5e5ac146b0468c4d4d4efb3ae6836252e792d4

See more details on using hashes here.

Release history Release notifications | RSS feed

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page