Synchronize setup and deployment for the Director.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

This Repository Is Deprecated!

The validations were moved under TripleO to this repository:

The issues and suggestions are tracked on the TripleO launchpad:

with the validations tag.

The rest of the Clapper repository is kept here for historical reasons.


Synchronize setup and deployment for the Director.

Ansible-based Validations

Recently, we focused on writing automated validations that require little human setup or interference. These are driven by Ansible we plan to provide an API that will let us use these from the TripleO web UI and command line clients.

Running a validation

For now, you need to run them manually. All the validations live in the ansible-tests/validations directory.

NOTE We only support Ansible 2.0 and higher.

To run a validation you need to:

$ git clone
$ source ~/stackrc
$ cd clapper/ansible-tests
$ ls validations  # pick a validation to run
$ ansible-playbook -i validations/some_validation.yaml

Contributing validations or ideas

Submit an issue or a pull request to this repository. Alternatively, you can email

When writing a validation, check out our Writing Validations guide.

Standalone Tools

Checking instackenv.json and network-environment.yaml

After executing the below command, you can start validation.

openstack baremetal import --json instackenv.json

The script checks the json file for missing passwords and usernames, it also checks that the MAC addresses contained within the file are unique. Lastly, it tests connections to bare metal nodes and confirm they are accessible.

The only argument for is -f to input a json file. By default this will search for instackenv.json.

In order to use the IPMI access checking feature, you’ll need to run the following command to install ipmitool on the undercloud node:

sudo yum -y install ipmitool


The script takes the network-environment.yaml file which will be used to launch the overcloud as its input and checks for several things:

  • Subnets do not overlap
  • Allocation Pools should be part of the appropriate subnet
  • VLAN IDs are unique per network

Overcloud Controller Settings

After deploying the overcloud, it is possible to check the controller's settings against current best practices for several configuration file by executing the script on it. For example, if your overcloud controller node has IP address

ssh heat-admin@ 'python' < ./

Discovery Diff Validation

Provides difference in configuration based on data collected in ironic-inspectorprovides difference in configuration based on data collected in ironic-inspector


  • Update the hosts as per guidelines
  • Rename validations/files/env_vars.json.sample to validations/files/env_vars.json
  • Update the configuration to reflect the environment specific values
  • Run the validation
mv validations/files/env_vars.json.sample validations/files/env_vars.json
vi validations/files/env_vars.json  #update the configuration
ansible-playbook -v -i hosts validations/discovery_diff.yaml