A test in Fuego is defined by: * jenkins files:    * /var/lib/jenkins/jobs/<test_name>/config.xml - expected to be static      * asks user to select 'Device' (from list of targets)      * asks user to select 'TESTPLAN' (from list of testplans)      * provides form for: 'Reboot', 'Rebuild', 'Target_Cleanup'      * specifies shell command sequence to cause build        * this references the script for the test, at:           * $FUEGO_TESTS_PATH/<test_name>/<script_name>.sh      * in the publishers section, it defines:        * script for post-test opeations           * functions.sh & post_test $TESTDIR    * /var/lib/jenkins/jobs/<test_name>/nextBuildNumber - changes for each run    * these files are found at:      * /home/jenkins/fuego/jobs/<test_name> * fuego files:    * in /home/jenkins/fuego/jobs/<test_name>      * <test>-script.sh      * tarball      * reference.log      * parser.py

test elements table [edit section]

= test elements table =Here is the same information in table form

A test consists of the following files or items:{{{#!Table||File or item||format||location||description||test type||||config.xml  ||Jenkins XML||/var/lib/jenkins/jobs/{test_name} (aka /home/jenkins/fuego/jobs/{test_name}||Has the Jenkins (front-end) configuration for the test||all||||tarfile     ||tar format ||/home/jenkins/tests/{test_name}||Has the source code for the test program||all||||patches     ||patch format|| /home/jenkins/tests/{test_name}||Zero or more patches to customize the test program (applied during the unpack phase||all||||base script ||shell script||/home/jenkins//tests/{test_name}||Is the shell script that implements the different test phases in Fuego||all||||test spec   ||JSON        ||/home/jenkins/fuego/engine/overlays/test_specs||Has groups of variables (and their values) that can be used with this test||all||||test plan(s)||JSON        ||/home/jenkins/fuego/engine/overlays/testplans/testplan_default.json (and others)||Has the testplan(s) for this test||all||||p/n logs    ||text        ||/home/jenkins/tests/{test_name}||Are logs with the results (positive or negative) parsed out, for determination of test pass/fail||functional only||||parser.py   ||python      || /home/jenkins/tests/{test_name}||Python program to parse benchmark metrics out of the log, and provide a dictionary to the Fuego plotter||benchmarks only||||reference.log||Fuego-specific|| /home/jenkins/{test_name}||Has the threshold values and comparison operators for benchmark metrics measured by the test||benchmarks only||||line added to tests.info||JSON|| /home/jenkins/fuego/jobs/tests.info||provides the names of metrics to be plotted for this benchmark||benchmarks only||

}}}

(See also [[Adding a test]], [[Benchmark parser notes]], [[parser.py]], [[reference.log]]