========
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:
.. code-block:: shell-session
openstack user create --password-prompt masakari
(give password as masakari)
#. Add admin role to masakari user:
.. code-block:: shell-session
openstack role add --project service --user masakari admin
#. Create new service:
.. code-block:: shell-session
openstack service create --name masakari --description "masakari high availability" instance-ha
#. Create endpoint for masakari service:
.. code-block:: shell-session
openstack endpoint create --region RegionOne masakari --publicurl http://<ip-address>:<port>/v1/%\(tenant_id\)s
#. Clone masakari using
.. code-block:: shell-session
git clone https://github.com/openstack/masakari.git
#. Run setup.py from masakari
.. code-block:: shell-session
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:
.. code-block:: shell-session
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
.. code-block:: shell-session
masakari-manage db sync
Features
--------
* TODO
Raw data
{
"_id": null,
"home_page": "https://docs.openstack.org/masakari/latest/",
"name": "masakari",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": null,
"author": "OpenStack",
"author_email": "openstack-discuss@lists.openstack.org",
"download_url": "https://files.pythonhosted.org/packages/40/11/baf4211b2500303d9b670a6a3e9882f57ac914d4d82d9e9c7d49d3c45281/masakari-18.0.0.tar.gz",
"platform": null,
"description": "========\nMasakari\n========\n\nVirtual Machine High Availability (VMHA) service for OpenStack\n\nMasakari provides Virtual Machine High Availability (VMHA) service\nfor OpenStack clouds by automatically recovering the KVM-based Virtual\nMachine(VM)s from failure events such as VM process down,\nprovisioning process down, and nova-compute host failure.\nIt also provides API service for manage and control the automated\nrescue mechanism.\n\nNOTE:\nUse masakari only if instance path is configured on shared storage system\ni.e, 'instances_path' config option of nova has a path of shared directory\notherwise instance data will be lost after the evacuation of instance from\nfailed host if,\n* instance is booted from image\n* flavor using ephemeral disks is used\n\nOriginal version of Masakari: https://github.com/ntt-sic/masakari\n\nTokyo Summit Session: https://www.youtube.com/watch?v=BmjNKceW_9A\n\nMasakari is distributed under the terms of the Apache License,\nVersion 2.0. The full terms and conditions of this license are\ndetailed in the LICENSE file.\n\n* Free software: Apache license 2.0\n* Documentation: https://docs.openstack.org/masakari/latest\n* Release notes: https://docs.openstack.org/releasenotes/masakari/\n* Source: https://opendev.org/openstack/masakari\n* Bugs: https://bugs.launchpad.net/masakari\n\n\nConfigure masakari-api\n----------------------\n\n#. Create masakari user:\n\n .. code-block:: shell-session\n\n openstack user create --password-prompt masakari\n (give password as masakari)\n\n#. Add admin role to masakari user:\n\n .. code-block:: shell-session\n\n openstack role add --project service --user masakari admin\n\n#. Create new service:\n\n .. code-block:: shell-session\n\n openstack service create --name masakari --description \"masakari high availability\" instance-ha\n\n#. Create endpoint for masakari service:\n\n .. code-block:: shell-session\n\n openstack endpoint create --region RegionOne masakari --publicurl http://<ip-address>:<port>/v1/%\\(tenant_id\\)s\n\n#. Clone masakari using\n\n .. code-block:: shell-session\n\n git clone https://github.com/openstack/masakari.git\n\n#. Run setup.py from masakari\n\n .. code-block:: shell-session\n\n sudo python setup.py install\n\n#. Create directory ``/etc/masakari``\n\n#. Copy ``masakari.conf``, ``api-paste.ini`` and ``policy.yaml`` file\n from ``masakari/etc/`` to ``/etc/masakari`` folder\n\n#. To run masakari-api simply use following binary:\n\n .. code-block:: shell-session\n\n masakari-api\n\nConfigure masakari database\n---------------------------\n\n#. Create 'masakari' database\n\n#. After running setup.py for masakari (``sudo python setup.py install``),\n run ``masakari-manage`` command to sync the database\n\n .. code-block:: shell-session\n\n masakari-manage db sync\n\nFeatures\n--------\n\n* TODO\n\n\n\n",
"bugtrack_url": null,
"license": null,
"summary": "Virtual Machine High Availability (VMHA) service for OpenStack",
"version": "18.0.0",
"project_urls": {
"Homepage": "https://docs.openstack.org/masakari/latest/"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "413f70d6e2de8a3c63917f421766e86b9b9bafc89c2b159c856eaf86340e1252",
"md5": "35d10a8e0be2a0a4b208163ccfefae5d",
"sha256": "066af4f91b84e064e239ccb0220f9d855391aa1a1bacbc3e1d57b8162e306b60"
},
"downloads": -1,
"filename": "masakari-18.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "35d10a8e0be2a0a4b208163ccfefae5d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 357218,
"upload_time": "2024-10-02T11:24:02",
"upload_time_iso_8601": "2024-10-02T11:24:02.037747Z",
"url": "https://files.pythonhosted.org/packages/41/3f/70d6e2de8a3c63917f421766e86b9b9bafc89c2b159c856eaf86340e1252/masakari-18.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "4011baf4211b2500303d9b670a6a3e9882f57ac914d4d82d9e9c7d49d3c45281",
"md5": "df2d2cadcb5c740ec3c8971f5176be73",
"sha256": "8c127cd63b81e3b93ba26e7f7b9049bc7410e08a3fd7499d356c74bf46494ada"
},
"downloads": -1,
"filename": "masakari-18.0.0.tar.gz",
"has_sig": false,
"md5_digest": "df2d2cadcb5c740ec3c8971f5176be73",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 364559,
"upload_time": "2024-10-02T11:24:03",
"upload_time_iso_8601": "2024-10-02T11:24:03.752411Z",
"url": "https://files.pythonhosted.org/packages/40/11/baf4211b2500303d9b670a6a3e9882f57ac914d4d82d9e9c7d49d3c45281/masakari-18.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-02 11:24:03",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "masakari"
}
JSON