Unvirt 1.0.0: Packaged scripts for managing Libvirt

[rmk]

Unvirt is a set of scripts to be used with Libvirt for properly starting and stopping domains (virtual machines).  The scripts are designed to bring your instances online when your array is brought up and shut them down prior to stopping the array.

 

Installation:

[*]Download this package: https://dl.dropboxusercontent.com/u/15034469/unraid/unvirt-1.0.0-noarch-unRAID.tgz

[*]Place a copy of the package in /boot/extra

[*]Either reboot unRAID or run 'installpkg /boot/extra/unvirt-1.0.0-noarch-unRAID.tgz' via SSH/Telnet

 

Usage:

 

Unvirt expects are particular directory structure and naming schema.

[*]Create a directory in /mnt/user called 'virtual_machines'

[*]Each domain (VM) needs to be in a separate directory.  For example, create a new directory: /mnt/user/test_vm.  This directory must contain test_vm.xml to define your domain.

[*]Start your array, all the domains will be started.

[*]Stop your array, the domains will be given 60 seconds each to shutdown gracefully before they are hard terminated

 

You can control both the location of the virtual machines directory and shutdown timeout by creating a config file.

 

/boot/config/plugins/libvirt/libvirt.cfg:

 

# Timeout value in seconds to wait for graceful VM shutdown
TIMEOUT=60

# Top level directory for your domains.  Must contain sub directories
# for each domain with a .xml file of the same name of the directory
# present.
VM_ROOT_DIR=/mnt/user/virtual_machines

 

Suggestions and feedback is welcome.