Skip to content
Automated smoke testing for OpenStack
Ruby CSS JavaScript Shell
Find file
Failed to load latest commit information.
app Fail xen jobs if dom0 plugin installation fails.
config Add support for Ceilometer/Heat.
contrib/monit Added resque_worker monit example.
db Add support for Ceilometer/Heat.
doc Updated flow. Configuration pic.
lib Add support for go links.
public Make favicon.ico have a transparent background.
script Add script to pause workers.
test Allow public access to /config_templates info.
vendor/plugins Initial Rails 3.0.6 commit.
.rvmrc Support Kytoon and add new XenServer runner.
Capfile Capify the Smoker.
Gemfile Bump to kytoon 1.4.3.
Gemfile.lock Bump to kytoon 1.4.3. Update README.
Rakefile Initial Rails 3.0.6 commit.


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
Something went wrong with that request. Please try again.