Chapter 5. Using ostestr to Run Tempest
Ostestr is an OpenStack wrapper for the testr test runner.
5.1. Running Smoke Tests
Smoke testing is a type of preliminary testing which only covers the most important functionality. While they are not comprehensive, running smoke tests can save time if they do identify a problem.
To run the smoke tests:
# ostestr '.*smoke'
5.2. Passing Tests Using Whitelist Files
A whitelist file is a file which contains regular expressions to select tests to include. Regular expressions are separated by a newline.
To use a whitelist file:
# ostestr --whitelist-file <whitelist_file>
Alternatively:
# ostestr -w <whitelist_file>
5.3. Skipping Tests Using Blacklist Files
A blacklist file is a file which contains regular expressions to select tests to exclude. Regular expressions are separated by a newline.
To use a blacklist file:
# ostestr --blacklist-file <blacklist_file>
Alternatively:
# ostestr -b <blacklist_file>
5.4. Running Tests in Parallel Concurrently, or Serially
Run the tests serially:
# ostestr --serial
Run the tests in parallel (this is the default):
# ostestr --parallel
Specify the number of workers to use when running tests in parallel:
# ostestr --concurrency <workers>
Alternatively:
# ostestr -c <workers>
By default, this is set to the number of CPUs.
