212d254da1
Starting since version 2.14, Nova automatically detects whether the server data is on shared storage or not. Removed 'on_shared_storage' parameter from nova evacuate call and bumped nova api version from 2.9 to 2.14 so that shared storage deployment can be detected by nova. Also added a related note in README.rst to point out. Operators should configure shared storage to use maskari otherwise instance data will be lost after evacuation. Change-Id: I0b0581a5c84143fc91c9fc6e2c440096013c7438
81 lines
2.5 KiB
ReStructuredText
81 lines
2.5 KiB
ReStructuredText
===============================
|
|
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/developer/masakari
|
|
* Source: https://git.openstack.org/cgit/openstack/masakari
|
|
* Bugs: https://bugs.launchpad.net/masakari
|
|
|
|
|
|
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 masakari directory in /etc/
|
|
|
|
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
|