FogHorn is a cucumber-based testing framework used to validate OpenStack system deployments. Its aim is to simplify testing of underlying OpenStack sub-systems in order to validate that everything has been deployed and configured properly.

• Ruby (this has been tested on Ruby 1.9.3)
• RubyGems
• Bundler

Once all the required software has been installed, run the following command:

bundle install

This will install the Fog client, the Cucumber framework and other dependencies.

To configure the framework to point to your specific OpenStack system make sure the following environment variables are defined:

• FOGHORN_OS_AUTH_HOS: the IP address or hostname where Keystone is running.
• FOGHORN_OS_AUTH_PORT: the port on which Keystone is listening (defautls to 35357).
• FOGHORN_OS_TENANT: the tenant used to authenticate and perform various operations.
• FOGHORN_OS_USER: the user ID to authenticate with.
• FOGHORN_OS_PASSWORD: the password

To run the test suite, run the following command:

bundle exec cucumber