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:

openstack user create --password-prompt masakari
(give password as masakari)

Add admin role to masakari user:

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

Create new service:

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

Create endpoint for masakari service:

openstack endpoint create --region RegionOne masakari --publicurl http://<ip-address>:<port>/v1/%\(tenant_id\)s

Clone masakari using

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

Run setup.py from masakari
```
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:
```
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
```
masakari-manage db sync
```

Features

TODO

Metadata

Release files for masakari 16.0.0.0rc1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for masakari 16.0.0.0rc1
File	Size	Uploaded
masakari-16.0.0.0rc1.tar.gz	363.4 kB	Sep 15, 2023	Details

Built distribution (wheel)

Table of built distributions (wheels) for masakari 16.0.0.0rc1
File	Interpreter	ABI	Platform	Reset
masakari-16.0.0.0rc1-py3-none-any.whl 360.9 kB Sep 15, 2023	Python 3	none	any	Details

Total release size: 724.3 kB

Release files / masakari-16.0.0.0rc1.tar.gz

Download URL	masakari-16.0.0.0rc1.tar.gz
Size	363.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`ccb2dcac46b2b3a78a6238670ea7c89858fae9ebd452eca12ae8af8b8bba37eb`
BLAKE2b-256 checksum How to use checksums	`c20e9ae558259ecb8c7b4bf7db41a43ef7e6534a16d23f398b1eed8c197134fa`
Upload date	Sep 15, 2023
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/4.0.2 CPython/3.11.4`

Release files / masakari-16.0.0.0rc1-py3-none-any.whl

Download URL	masakari-16.0.0.0rc1-py3-none-any.whl
Size	360.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`b4e098ebfdc444ba9b9c28980ae514985e8aa6a04691c1e0d2d788f1f2a5053c`
BLAKE2b-256 checksum How to use checksums	`f22d4c7f57961ea29a5250da31c2c5da2c948388cb6dc59991fd5a6915271081`
Upload date	Sep 15, 2023
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/4.0.2 CPython/3.11.4`