Chapter 5. Using ostestr to Run Tempest

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'

# ostestr '.*smoke'

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>

# ostestr --whitelist-file <whitelist_file>

Alternatively:

ostestr -w <whitelist_file>

# ostestr -w <whitelist_file>

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>

# ostestr --blacklist-file <blacklist_file>

Alternatively:

ostestr -b <blacklist_file>

# ostestr -b <blacklist_file>

Run the tests serially:

ostestr --serial

# ostestr --serial

Run the tests in parallel (this is the default):

ostestr --parallel

# ostestr --parallel

Specify the number of workers to use when running tests in parallel:

ostestr --concurrency <workers>

# ostestr --concurrency <workers>

Alternatively:

ostestr -c <workers>

# ostestr -c <workers>

By default, this is set to the number of CPUs.