Video Transcript
Hello, this is Amir Shehata with another quick tip on the LUTF.
Today we'll go over how the LUTF integrates in the Lustre test infrastructure.
There are multiple ways to run the lustre test scripts but for the sake of this discussion we'll stick with the documented method, shared in the link below.
http://wiki.lustre.org/Testing_HOWTO
At the top Lustre tests directory there are two files of interest:
lutf.sh
lutf_start.sh
I'm not going to go into the implementation details, except to mention that the lutf.sh file is intended to be run from the auster script.
While the lutf_start.sh file is meant to be run as a standalone. But if you do, you'll need to setup the environment variables auster sets up.
The "testing how to" link shared details, the testing setup pretty well.
When you run the lutf from auster, you need to provide a configuration file which outlines the test nodes. For the LUTF there are 3 extra environment variables to take a note of: the master port, the telnet port and the shell mode. You can go back to quick tip #3 for more details.
It is not necessary to set these environment variables since they will be defaulted in case they are missing.
I just want to spend a minute talking about the LUTF_SHELL environment variable. If you recall this can take on 3 values: batch, interactive and daemon. If it's not specified it will default to batch and run whatever scripts are requested.
Interactive is most useful while developing test scripts.
Batch is most useful when running the test scripts.
Daemon is used for agents when run through auster.
The lutf_start.sh uses the environment variables to generate the LUTF YAML configuration file. That's the easiest way to get the configuration file. You can then modify the configuration file as you please.
Let's look at the steps to run an LUTF batch test.
First you'll need to setup your test environment as shows in the how to link.
Second you need to create your auster configuration file. Again you can use the one in the how to link and if you wish you can add the 3 LUTF specific environment variables.
Then run auster:
./auster -f lutfcfg -rsv -d /opt/results/ lutf --suite samples --only sample_02
It's as simple as that.
The only caveat is this. In the auster configuration file you'll need to export the variables in order for the LUTF's python scripts to pick them up.
You can run a batch of test scripts from the LUTF interactive mode. Let's take a quick look at how we can do that:
This runs the samples suite.
You can also run all the suites by doing: