Warning

This version of 27.02.2013 - does not support update only the new installation. Or you can upgrade an existing but it will have to delete the file webvirtmgr.db and recreate datebase ./manage.py syncdb

WebVirtMgr panel - v1.6

• Add support VM name with dash ("-")
• Add support VM and Host name with dash (".")
• Delete VM optional HDD image.
• Add Support NoVNC (need install - CentOS/RedHat/Fedora: python-websockify, Ubuntu: novnc)
• Add page infrastructure (View all Hosts and VMs)
• Add button "Enable noVNC" on VM page (Set VNC password for noNVC)
• Add button "New Flavor" - create custom flavor (after update need - ./manage.py syncdb)

1. Introduction

WebVirtMgr is a libvirt-based Web interface for managing virtual machines. It allows you to create and configure new domains, and adjust a domain's resource allocation. A VNC viewer presents a full graphical console to the guest domain. KVM is currently the only hypervisor supported.

Technology:

The application logic is written in Python & Django. The LIBVIRT Python bindings are used to interacting with the underlying hypervisor.

License

WebVirtMgr is licensed under the Apache Licence, Version 2.0 (http://www.apache.org/licenses/LICENSE-2.0.html).

2. Installation

Fedora 17 and above

Run:

$ su -c 'yum -y install git Django python-virtinst httpd mod_python mod_wsgi python-websockify python-setuptools'

Ubuntu 12.04 and above

Run:

$ sudo apt-get install git python-django virtinst apache2 libapache2-mod-python libapache2-mod-wsgi novnc
$ sudo service novnc stop
$ sudo update-rc.d -f novnc remove

CentOS 6.2, RedHat 6.2 and above

Run:

$ su -c 'rpm -Uvh http://dl.fedoraproject.org/pub/epel/6/i386/epel-release-6-8.noarch.rpm'
$ su -c 'yum -y install git python-virtinst httpd mod_python mod_wsgi Django python-websockify python-setuptools'

3. Setup

Run:

$ git clone git://github.com/retspen/webvirtmgr.git
$ cd webvirtmgr
$ ./manage.py syncdb

Enter the user information:

You just installed Django's auth system, which means you don't have any superusers defined.
Would you like to create one now? (yes/no): yes (Put: yes)
Username (Leave blank to use 'admin'): admin (Put: your username or login)
E-mail address: [email protected] (Put: your email)
Password: xxxxxx (Put: your password)
Password (again): xxxxxx (Put: confirm password)
Superuser created successfully.

Run app for test:

$ ./manage.py runserver x.x.x.x:8000 (x.x.x.x - your IP address server)

Enter in your browser:

http://x.x.x.x:8000 (x.x.x.x - your IP address server)

4. Setup Web (Choose only one method: Virtual Host or WSGI)

###1. Virtual Host

Add file webvirtmgr.conf in conf.d directory (Ubuntu: "/etc/apache2/conf.d" or RedHat,Fedora,CentOS: "/etc/httpd/conf.d"):

<VirtualHost *:80>
    ServerAdmin [email protected]
    ServerName dummy-host.example.com

    SetHandler python-program
    PythonHandler django.core.handlers.modpython
    SetEnv DJANGO_SETTINGS_MODULE webvirtmgr.settings
    PythonOption django.root /webvirtmgr
    PythonDebug On
    PythonPath "['/var/www'] + sys.path"
    
    ErrorLog ${APACHE_LOG_DIR}/webvirtmgr-error_log
    CustomLog ${APACHE_LOG_DIR}/webvirtmgr-access_log common
</VirtualHost>

Copy the folder and change owner (Ubuntu: "www-data:www-data", Fedora, Redhat, CentOS: "apache:apache"):

$ sudo cp -r webvirtmgr /var/www/
$ sudo chown -R www-data:www-data /var/www/webvirtmgr/

Reload apache:

# service apache2 reload

###2. WSGI

Add file webvirtmgr.conf in conf.d directory (Ubuntu: "/etc/apache2/conf.d" or RedHat,Fedora,CentOS: "/etc/httpd/conf.d"):

WSGIScriptAlias / /var/www/webvirtmgr/wsgi/django.wsgi
Alias /static /var/www/webvirtmgr/virtmgr/static/
<Directory /var/www/webvirtmgr/wsgi>
  Order allow,deny
  Allow from all
</Directory>

5. Gunicorn and Runit (Only for geeks)

WSGI for gunicorn:

webvirtmgr/wsgi.py

Add line 'gunicorn', in file settings.py:

INSTALLED_APPS = (
...
'gunicorn',
)

Runit script for webvirtmgr (/etc/sv/webvirtmgr/run):

#!/bin/bash

GUNICORN=/usr/local/bin/gunicorn
ROOT=/var/www/webvirtmgr
PID=/var/run/gunicorn.pid

APP=wsgi:application

if [ -f $PID ]; then
   rm $PID
fi

cd $ROOT
exec $GUNICORN -c $ROOT/gunicorn.conf.py --pid $PID $APP

6. Update

$ cd /path to/webvirtmgr
$ git pull

Support: [email protected]