Users - see the documentation
This software defines a flexible run control infrastructure for a distributed DAQ system defined in a set of configuration files used at run time for DUNE. Operation of the experiment is defined through a finite state machine (FSM) which describes the operational state of the DAQ.
The project is still under development, and as such will still have bugs or features that users may not want. If you encounter any of these please raise an issue and describe it clearly so that we can resolve it easily.
If you are trying to run drunc you must have a DUNE-DAQ environment, with cvmfs available. See setup instructions here to setup an nightly or a static release.
Once you have drunc, you can look at the quick start instructions.
If you need more details:
- Process manager
- Controller
- Unified shell (merges the controller and process manager shells)
There are more in depth descriptions of part of the system here:
Finally, we have a FAQ, have a look there if you have a problem!
If are developing a user interface for drunc, you can get help here:
- Messaging format (valid for all the
druncendpoints) - Process manager endpoint description
- Controller endpoint description
- Graph (interactive UML class/package diagrams)
There is more developer information in the drunc wiki.
- New or reopened PRs are automatically converted to draft. Complete the developer checklist before marking the PR Ready for review.
- Changed files determine the PR labels. When the PR is ready, the workflow requests all matching reviewers except the author and posts a review tracker with a reviewer checklist.
- Reviewers tick the checklist in the bot's tracker comment. Once complete, post
/checklist-completein a new PR comment to rerun the checklist check. Existing review requests and checklist ticks are preserved on routing reruns. The workflow acknowledges the command with an eyes reaction, then adds thumbs up if the retry script exits successfully (including skipped retries), or thumbs down if it fails. These reactions report the retry script's outcome, not the rerun checklist's result. - An approval triggers a one-time comment with the final steps to follow before merging.
... are here