Welcome to ganetimgr’s documentation!

What is ganetimgr?

ganetimgr is a Django project that serves as an administration frontend for (multiple) Ganeti clusters. It is developed as the frontend of a VPS service. There’s an introduction page for the project at https://grnet.github.io/ganetimgr/

_images/ganetimgr_create_instance.png

A simplified architecture of ganetimgr is depicted here:

+------------------------+           +---------------+
|                        |           |               |
|                        |     +-----+ ganeti cluster|
|         Django         |     |     |               |
|                        |     |     +---------------+
|                        |     |            ...
+------------------------+     |            ...
|     gevent watcher     |     |            ...
|                        |     |     +---------------+
+------------------------+     |     |               |
|  Caching  |ganeti REST +-----+     + ganeti cluster|
|           |API client  +-----------+               |
+-----------+------------+           +---------------+

Installation

You can go through the installation at the Install ganetimgr section.

Upgrading

If running an older version, look through the Upgrade Notes before upgrading to a new one.

Compatibility

ganetimgr has been tested with ganeti versions 2.4-2.15. Due to the nature of the Ganeti RAPI, ganetimgr should be able to communicate with any Ganeti v.2.X cluster.

While most of the functionality is available with vanilla Ganeti setups, there are some features that require changes to Ganeti in order to work properly, see patched software

Development

If you’re interested in development/testing ganetimgr you might find useful information in the Development documentation.