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.