Automated smoke testing for OpenStack
Ruby CSS JavaScript Shell


Smoke test the OpenStack


A web application with a REST based HTTP interface to help smoke test OpenStack. SmokeStack is focused on integration testing of OpenStack services and currently supports Nova, Keystone, and Glance, and Swift. SmokeStack is built on:

  • Rails 3.2
  • Resque: a redis backed job queue
  • Job runner templates: The default job runner uses FireStack/Kytoon to spin up groups of servers. Backends support using: Libvirt, OpenStack clouds, and XenServer
  • Configuration management to install and configure everything (Puppet)
  • Packages to install software (multiple distros are supported)

For more information and examples see the wiki:


Requires Ruby, Rubygems, and Ruby on Rails 3.2.

gem install rails -v3.2

The application was developed with MySQL. The following gems are required:


Unpack the rails app and run the following commands to create the database.

rake db:create
rake db:migrate

Start some linux workers to configure Linux machines:

mkdir tmp/pids
rake resque:workers QUEUE=libvirt COUNT=3

Start the API server:

rails server

At this point the web application should be running at http://localhost:3000.

Quickstart on Fedora 16

# install ruby, gems & mysql
sudo yum install -y rubygems ruby-devel mysql-server redis mysql-devel gcc gcc-c++

# install bundler then install gems via bundle
sudo gem install -y bundle --no-ri --no-rdoc

# cd to SmokeStack app installation directory
cd /opt/smokestack
bundle install

# initialize the db
cp config/database.yml.sample config/database.yml
bundle exec rake db:create db:migrate

# setup kytoon
ssh-keygen # don't use passphrase
# FIXME - add details on creating .kytoon.conf for running jobs
# in tab 1: launch some workers
bundle exec rake resque:workers QUEUE="libvirt" COUNT=3

# in tab 2: run rails
bundle exec rails server

At this point you can view the website at http://localhost:3000 with username/password of admin/cloud

Serving via Apache/Passenger

sudo gem install passenger --no-ri --no-rdoc

# install apache and libraries needed to run
sudo yum install -y httpd openssl-devel curl-devel httpd-devel apr-devel

sudo passenger-install-apache2-module

# follow instuctions to configure modules & site for Apache...

# create a production db 
RAILS_ENV=production bundle exec rake db:create db:migrate