Content Comparison

...

           In RPM env, they are located at DAOS_TEST_SHARED_DIR if this env variable is set, otherwise,  by default will be installed at ~/daos_test, this directory will be automatically created if not existed.

• Before running a test, you must identify the number of cluster nodes that are to be usedrequired.  To do this you edit , open the yaml file for the test you want to run ($PREFIX/lib/daos/TESTING/ftest/*/*.yaml).  In the yaml file you’ll You’ll see placeholders for machine names e. E.g. boroserver-A.  If the test requires more than 1 host you’ll see boroserver-A and boroserver-B, etc. using the yaml array syntax (e.g. each array item begins with a dash).  Edit these names replacing the A, B, … with a  real cluster node e.g. boro-17 that you have reserved.  You can replace the whole name as well, e.g. boro-A becomes wolf-18.  Depending on how many tests you want to run you may need to edit a number of the yaml filesYou'll need to have enough servers/clients depending on how many are specified in the yaml.

• Tests are started with the launch.py script in the $PREFIX/lib/daos/TESTING/ftest directory along with a test tag.  Groups of tests are identified by tags. 

  Using the SimpleCreateDeleteTest as an example again –tests in this file are tagged with ‘simplecreate’.  So to run these tests you would enter: ./launch.py simplecreate.   Tests are given multiple tags of increasing specificity.  So SimpleCreateDeleteTest includes the simplecreate tag (most specific) but also the pool tag (least specific).  The simplecreate tag is presently associated with dozens of test cases, running the pool tag would run all the pool test cases currently around 1000. 

  For example, tests in $PREFIX/lib/daos/TESTING/ftest/pool/simple_create_delete_test.py are tagged with all, pool, and simple_create. The all tag is associated with all tests, the pool tag is associated with most pool-related tests, and the simple_create tag is associated with only the tests in this file. To run the simple_create tests, execute:

  Code Block
  language bash
  ./launch.py -ts boro-xx -tc boro-xx simple_create

  See Using launch.py for more details on running tests.

  Info
  If you were to make the tragic mistake of specifying the all tag, the tests would run for a day at least

  .If you are running a test to reproduce a defect, the writer of the defect will provide the name of the yaml file to edit and the tag to run the test

  .

  
  

TODO:

• Add section and instructions for generating a public/private key pair and using ssh-copy-id to install it on all machines you will be using in the test suite.
• Add instructions on how to add passwordless sudo on the accounts the launcher will be run on for the target hosts.
• Add instructions based on Distro of which files to copy from utils/systemd into /usr/lib/systemd to allow the test harness to use systemctl and how to modify them to run as your user.
• Move these instructions into a file doc/dev/testing.md to make it accessible to other developers.Add and update examples for invoking tests as the description is no longer accurate.
• Add instructions on modifying your PYTHONPATH for the tests to have access to the daos python bindings in the in-tree build. 
• Add instructions on creating /etc/daos paths needed since test harness does not use sudo on mkdir commands even though it uses sudo on cp commands.
• Add instructions to create all of the necessary groups needed by the unit files