No description, website, or topics provided.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.



This is a toolset around OpenStack Nova and Neutron.
The tool can create overviews in various different ways and email owners of vm's (based on the email in the description field of the tenant) On hypervisors this tool can also inspect libvirt for running instances and check Openvswitch / vlans.

Running novacek

Novacek can run anywhere where the appropriate libraries are installed (see requirements.txt)
Credentials will be pulled from the environment like other OpenStack tools:
As an alternative to environment variables the tool will also look at the neutron.conf and try to use credentials specified there.

Commandline options:

Option Description
-l list instances of the server you are currently logged into
-l -p also ping the instances
-l -H $hypervisor list instances on hypervisor $hypervisor
-l -Z $zone list all instances in zone $zone, ALL will return all instances
-f choose formatting of result, noborder or table
-c choose which fields to return: Host,Zone,Name,ID,Tenant,IP,VLAN,Flavor,Virsh_ID,PING ...
-m $message -H $hypervisor mail the users of hypervisor X their machines with a $message REQUIRES EMAIL TO BE SET IN DESCRIPTION OF TENANT
  • Example 1: Reset the state off all instances on a hypervisor and hard reboot them:
    for x in $(python -c ID -l -f noborder -H $hvname); do nova reset-state --active $x; nova reboot --hard $x; done

  • Example 2: mail all tenants on a hypervisor:
    python -m "Things gonna break" -H $hvname

Running test_hypervisor

test_hypervisor will check libvirt and openvswitch VLAN settings.
Note that these checks are very environment specific, if you run anything else then neutron/ML2/ovs it will probably not work.
Feel free to extend these checks.

Additional requirements

  • The python_libvirt library is needed if you want to check the libvirt status of an instance on a hypervisor
  • To do a check if the vlan's are properly set you need the easyOVS library.
    This toolset can be found here:

Sample output Hypervisor

Host Zone Name ID Tenant IP VLAN Flavor Virsh_ID PING
hv1 zone4 instance1 XXX team_a 53 m1.small -1 ['DOWN']
hv1 zone4 instance2 XXX team_b 54 m1.small 1 ['UP']
hv1 zone4 instance3 XXX team_c 52 m1.medium 2 ['UP']
hv1 zone4 instance4 XXX team_c 52 m1.medium 3 ['UP']


The tool was specifically build for Spilgames internal setup and is not tested on other setups.
We are running Openstack Icehouse from RDO on SL6 with Neutron and ML2.
If you want to extend functionality please do a merge request.
As long as it does not break anything we are open for changes.