refstack-client/README.rst
Catherine Diep 9ce4f345d1 Update the README file.
Add testing instructions to the README file.  Also add the missing
gitreview file.

Change-Id: Ia670c83b4d832522eee8716fe97a648f69810189
2014-07-30 18:20:53 -07:00

1.2 KiB

refstack-client

refstack-client is a command line utility that allows you to execute Tempest test runs based on configurations you specify. When finished running Tempest it sends the passed test data back to the Refstack API server.

Usage (Ubuntu)

We've created an "easy button" for Ubuntu.

$ sh ./setup_ubuntu_env.sh

Start testing

  1. Prepare a tempest configuration file that is customized to your cloud environment.

  2. Change the directory to the refstack-client directory (i.e. cd ~/refstack-client).

  3. Source to use the correct Python environment.

    source test_runner/bin/activate

  4. Execute test by typing:

    refstack-client/refstack-client -c "Path of the tempest configuration fileto use"

    Note:

    1. Adding -v option will show the summary output.
    2. Adding -vv option will show the Tempest test result output.
    3. Adding -t option will only test a particular test case or a test group. This option can be used for quick verification of the target test cases (i.e. -t "tempest.api.identity.admin.test_roles").
    4. Adding --url option will upload the test results to a Refstack API server instead of the default Refstack API server.