Please read the instructions fully before starting. The order of operations is important. The upgrade may fail if done out of order.
This guide is intended for Ganeti Web Manager in versions 0.11 and higher. If you have older installation that you want to upgrade, please read carefully Deprecated: Upgrading page.
This guide will walk you through upgrading Ganeti Web Manager. Our upgrade process uses South, a database migration tool that will update your database.
- Back up the database
- Make sure newest Ganeti Web Manager is available in OSUOSL repository at http://ftp.osuosl.org/pub/osl/ganeti-webmgr/
- Run your setup script with
Follow the guide for your version.
0.11 and later¶
Since 0.11, Ganeti Web Manager uses special setup script for installing and upgrading.
By using this script (and due to other major changes in Ganeti Web Manager architecture),
you now have to use different management script. It gets installed into
Ganeti Web Manager‘s virtual environment as
django-admin.py. Once you’ve activated your
virtual environment, it will be in your path.
In order to upgrade your database run:
$ django-admin.py migrate --delete-ghost-migrations --settings "ganeti_webmgr.ganeti_web.settings"
Settings now have a few ways of configuring, designed to make life easier for those deploying Ganeti Web Manager, especially if your unfamilar with python.
Settings now live in
/opt/ganeti_webmgr/config/config.yml. You can now use
yaml to configure your settings. By default this config file does not exist, so
be sure to add your config file there.
An example yaml config file can be found in the
configuration documentation, and can also be found in
ganeti_webmgr/ganeti_web/settings/ in a file named
If you prefer configuration using the typical django
settings.py file, fear
not, that will still work, however it has changed a bit.
You will need to remove any imports of other settings files from it, and you
will need to add it to the
ganeti_webmgr/ganeti_web/settings/ folder as
settings.py. Take a look at
settings.py.dist in that same folder for an