Metadata-Version: 2.1
Name: vmms
Version: 0.0.8
Summary: VM Migration Scheduler for OpenStack
Home-page: https://www.openstack.org/
Author: OpenStack
Author-email: openstack-discuss@lists.openstack.org
Classifier: Environment :: OpenStack
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12

=====================
VM Migration Scheduler
=====================

VM Migration Scheduler (vmms) is an OpenStack service for scheduling and managing
virtual machine migrations.

Features
--------

* Schedule VM migrations for specific times
* Track migration status (scheduled, error, migrated)
* RESTful API for managing migrations
* Keystone authentication integration
* Worker daemon for processing scheduled migrations
* WSGI application support

Installation
------------

Use the Debian package.

Configuration
-------------

The service requires a configuration file typically located at
``/etc/vmms/vmms.conf``.

Example configuration::

    [DEFAULT]
    [database]
    connection=sqlite:///var/lib/vmms/vmmsdb.db

    [keystone_authtoken]
    www_authenticate_uri = http://keystone:5000
    auth_url = http://keystone:5000
    auth_type = password
    project_domain_name = Default
    user_domain_name = Default
    project_name = service
    username = vmms
    password = vmms_password

Usage
-----

Start the API service using uwsgi.

Start the worker daemon::

    vmms-worker

API Endpoints
-------------

* ``POST /v1/vms`` - Add VM to migration scheduler
* ``GET /v1/vms`` - List all VM migrations
* ``DELETE /v1/vms/{id}`` - Remove VM from migration scheduler

