596b3d142e
Updated operator guide documentation for 1. segregated sections appropriately 2. referred masakariclient for CLI section 3. added detailed 'Install and configure for Ubuntu' section 4. added detailed 'Verify operation' section 5. used sphinx-build instead of the pbr sphinx extention for building docs as instructed by the PTI[1] 6. cleaned up build_sphinx related entries in setup.cfg [1]: https://governance.openstack.org/tc/reference/project-testing-interface.html#documentation Change-Id: Iec93bebdbc7ffe1ccd27bb11f474384ff06a559c
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 adminCreate new service:
openstack service create --name masakari --description "masakari high availability" instance-haCreate 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\)sClone masakari using
git clone https://github.com/openstack/masakari.gitRun setup.py from masakari
sudo python setup.py installCreate directory
/etc/masakariCopy
masakari.conf,api-paste.iniandpolicy.jsonfile frommasakari/etc/to/etc/masakarifolderTo 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), runmasakari-managecommand to sync the databasemasakari-manage db sync
Features
- TODO