Warning, /HLTrigger/Configuration/test/readme.md is written in an unsupported language. File is not indexed.
0001 The `test/` directory of the `HLTrigger/Configuration` package contains
0002
0003 - scripts to copy HLT menus from the `ConfDB` database into CMSSW,
0004 as both `cff` fragments (loadable via `cmsDriver.py`) and standalone `cfg` configurations (usable with `cmsRun`);
0005
0006 - scripts to run tests with these HLT menus
0007 (a version of these tests runs in CMSSW integration buils as the so-called "HLT-Validation" tests);
0008
0009 - a unit test to verify the availability of the EDM input files used in the HLT tests maintained in CMSSW by the Trigger Studies Group
0010 (see `testAccessToEDMInputsOfHLTTests` below).
0011
0012 _Important_ : when the names of the EDM files hard-coded in
0013 `HLTrigger/Configuration/test/cmsDriver.csh` and/or
0014 `Configuration/HLT/python/addOnTestsHLT.py` are changed, make sure to
0015 (1) commit your local changes, and then
0016 (2) execute the script `HLTrigger/Configuration/test/testAccessToEDMInputsOfHLTTests_update_filelist.sh`
0017 in order to update the file `HLTrigger/Configuration/test/testAccessToEDMInputsOfHLTTests_filelist.txt`.
0018 The latter contains the list of files queried by the unit test `testAccessToEDMInputsOfHLTTests` (see below),
0019 which will then be cached in the IB-EOS area at the CERN T2.
0020
0021 ---
0022
0023 Unit test: `testAccessToEDMInputsOfHLTTests`
0024 ---
0025
0026 This unit test executes `cmsRun` jobs to verify the availability
0027 of the EDM files listed in `HLTrigger/Configuration/test/testAccessToEDMInputsOfHLTTests_filelist.txt`.
0028
0029 To run the unit test via `scram`, execute
0030 ```bash
0031 scram b runtests_testAccessToEDMInputsOfHLTTests
0032 ```
0033 To run the unit test locally, execute
0034 ```bash
0035 cd "${CMSSW_BASE}"/src/HLTrigger/Configuration/test && \
0036 SCRAM_TEST_PATH=. ./testAccessToEDMInputsOfHLTTests.sh
0037 ```
0038
0039 The unit test does not modify the content of the file `testAccessToEDMInputsOfHLTTests_filelist.txt`.
0040 The latter can be updated by manually executing the script `testAccessToEDMInputsOfHLTTests_update_filelist.sh`.
0041
0042 - The file `testAccessToEDMInputsOfHLTTests_filelist.txt` lists
0043 the Logical File Name (LFN) of the EDM files used in HLT tests for
0044 (1) the main CMSSW development branches (name format: `CMSSW_[0-9]*_[0-9]*_X`), and
0045 (2) the HEAD of local CMSSW in use.
0046
0047 - The script `testAccessToEDMInputsOfHLTTests_update_filelist.sh` ignores other branches,
0048 as well as local modifications which have not been committed yet.
0049
0050 - The file `testAccessToEDMInputsOfHLTTests_filelist.txt` lists only EDM files which are either
0051 (1) cached in the IB-EOS area at the CERN T2, or
0052 (2) accessible remotely via the redirector `cms-xrd-global.cern.ch`.
0053
0054 Here are the steps one normally executes to update the
0055 EDM input files and the unit test `testAccessToEDMInputsOfHLTTests`.
0056
0057 - Update the input EDM files where needed,
0058 e.g. `addOnTestsHLT.py` and/or `cmsDriver.csh`.
0059
0060 - Test, and commit the changes.
0061
0062 - Run `testAccessToEDMInputsOfHLTTests_update_filelist.sh`
0063 (this will update `testAccessToEDMInputsOfHLTTests_filelist.txt`, if needed).
0064
0065 - Run the unit test (e.g. `scram b runtests_testAccessToEDMInputsOfHLTTests`).
0066
0067 - Commit the changes to `testAccessToEDMInputsOfHLTTests_filelist.txt`, if any.