2.0 - Test series setup

[pflarr]

This step of the test run process sets up the basic information and directories for a test series and each test run.

Series ID's

• The directory $PAV_ENV/series should contain numbered directories containing information about each test series.
• Series numbers in the .ids file and directory names should be zero padded to 10 digits. When referred to by users the zero padding should not be needed.
• This directory should be auto cleaned according to general config's _resultcleanup variable.
• Each directory should be named with the ID number of a test series.
• The directory $PAV_ENV/series/.ids is a file that should contain a list of available test series numbers (zero padded), separated by newlines.
  • Pav access to this file should always be via an exclusive lock.
    • Series directories should always be created or deleted WHILE holding this lock.
  • If the file is empty of numbers or doesn't exist, it should be truncated, then sequentially filled with numbers, skipping any that correspond to existing series directories.
  • When numbers are used from the file, they should be overwritten with white space. The white space will be removed when the file is empty and regenerated.

Test ID's

Test ID's are sequentially generated at series start time, and appended to the series id with a '.' separator. For example, test 9 in series 3 would have the number '3.9'.

• For each run, a run directory should be created under in $PAV_ENV/series/<series ID>/<run ID>/.
• A working_space directory should be created under that.
• An empty run.status file should be created too.