openstack
/
masakari
Code Issues Proposed changes
Virtual Machine High Availability (VMHA) service for OpenStack.
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
611 Commits
12 Branches
25 Tags
9.0 MiB
Python 98.9%
Shell 1.1%
 
 
master
stable/2023.1
stable/wallaby
stable/xena
stable/yoga
stable/zed
stable/ussuri
stable/victoria
stable/train
stable/stein
stable/queens
stable/pike
rocky-eol
xena-em
15.0.0
15.0.0.0rc1
14.0.2
13.0.3
12.0.3
wallaby-em
14.0.1
13.0.2
12.0.2
11.0.3
13.0.1
12.0.1
11.0.2
14.0.0
14.0.0.0rc1
victoria-em
13.0.0
13.0.0.0rc1
ocata-eol
ussuri-em
12.0.0
12.0.0.0rc1
11.0.1
10.0.3
9.1.3
train-em
10.0.2
9.1.2
8.1.2
11.0.0
11.0.0.0rc1
8.1.1
10.0.1
9.1.1
stein-em
9.1.0
8.1.0
7.1.0
10.0.0
10.0.0.0rc1
9.0.0
9.0.0.0rc1
rocky-em
8.0.0
8.0.0.0rc1
7.0.0
7.0.0.0rc1
7.0.0.0b1
6.0.0
6.0.0.0rc2
6.0.0.0rc1
6.0.0.0b3
6.0.0.0b2
6.0.0.0b1
5.0.0
5.0.0.0b3
newton-eol
4.0.0
4.0.0.0rc2
4.0.0.0rc1
3.0.1
3.0.0.0rc1
2.0.0
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from 'master'
${ noResults }
Go to file
Zuul c6afc1bc8f Merge "add pre-commit" 6 days ago
api-ref/source add api-ref for masakari vmoves 4 months ago
devstack Fix auth_url setting for devstack 2 years ago
doc add api-ref for masakari vmoves 4 months ago
etc/masakari Merge "Remove a sample file of masakari.conf" 2 years ago
masakari extend wait period for process notification 1 week ago
playbooks/devstack [CI] Let Masakari jobs be used from other projects 2 years ago
releasenotes Merge "releasenote for Masakari VMove" 3 months ago
roles/devstack-config/tasks Fix files to pass linting 3 years ago
tools Enable database migration unit tests 2 years ago
.coveragerc Initial Cookiecutter Commit. 7 years ago
.gitignore Reorganize masakari documentation 4 years ago
.gitreview OpenDev Migration Patch 4 years ago
.mailmap Initial Cookiecutter Commit. 7 years ago
.pre-commit-config.yaml add pre-commit 1 week ago
.stestr.conf Switch to using stestr 5 years ago
.yamllint Use some better linting 3 years ago
.zuul.yaml [CI] Move queue setting to project level 9 months ago
CONTRIBUTING.rst [community goal] Update contributor documentation 2 years ago
HACKING.rst add pre-commit 1 week ago
LICENSE Initial Cookiecutter Commit. 7 years ago
MANIFEST.in Drop MANIFEST.in - it's not needed by pbr 7 years ago
README.rst Merge "Simplify endpoints created by devstack plugin" 2 years ago
bindep.txt Replace python-dev with python3-dev in bindep 11 months ago
requirements.txt Use new get_rpc_client API from oslo.messaging 5 months ago
setup.cfg vm moves for host notification 4 months ago
setup.py Cleanup py27 support 10 months ago
test-requirements.txt Use some better linting 3 years ago
tox.ini Fix tox4 issues 6 months ago

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

  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.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

Features

  • TODO