RunningTheXSEDETests

How to run the XSEDE Tests against a bootstrapped grid

For the following instructions, we will give an example command line for each step.

  • The svn repository for XSEDE tests:
    • svn://mater.cs.virginia.edu/af15/vv3xu/xsede_tests
    • Anonymous checkout: svn co svn://mater.cs.virginia.edu/af15/vv3xu/xsede_tests
    • If you want to be able to check in test changes, contact vana for a personalized account.
  • Change into the xsede_tests directory: cd ~/xsede_tests
  • Copy the inputfile.example to inputfile.txt: cp inputfile.example inputfile.txt
  • Edit the inputfile.txt to match the type of bootstrapped grid you want to set up.
    • Note that some of the following steps may require you to use some of the information from this file.
    • If you want to run against an existing grid, then that will definitely dictate some of the contents of this file.
  • Run the first part of the bootstrap process:
    • bash ~/xsede/xsede_tests/library/grid-bootstrap-single.sh /users/admin admin /groups/testers simpleGrid
    • This gives you a grid with a running container, an admin account, and two test accounts (test1:password1 and test2:password2).
    • This script also leaves you logged in as the admin. The tests are not intended to run with wide-open permissions like that, so be sure to login as one of the test accounts.
  • Run the second part of the bootstrap process to create demo users and setup the account in inputfile.txt:
    • If you want to have a unique user in inputfile.txt that is not a test account for running your tests, this step creates that account.
    • The demo users are needed for running multi-user tests. The script will set up the ten accounts listed in the example input file.
    • NON_INTERACTIVE=true bash ~/xsede/xsede_tests/first_steps/setup_test_infrastructure.sh /containers/khandroma {chosenPassword}
    • The {chosenPassword} should be replaced with whatever password you want your normal user to have.
  • Then before running the tests, log out of any prior credentials and login with a normal user:
    • grid logout --all
    • grid login --username=test1 --password=password1
    • or... grid login --username={myUniqueUser} --password={chosenPassword}
  • To run the entire test suite: bash regression_test.sh
  • To run just GFFS tests: bash regression_test.sh GFFS
  • To run just EMS tests: bash regression_test.sh EMS
  • Helpful notes:
    • There is a top-level README.txt file that provides additional documentation and some caveats.