action.skip

drunc-controller

This app is responsible for propagating commands to its children, and ensuring that they are correctly defined. It is spawned directly when you use process_manager's boot.

Starting

You should not attempt to execute drunc-controller, unless you know what you are doing.

The root-controller is in charge of communicating with all of the segment controllers, and the segment controllers (subcontrollers) are in charge of communicating with all the segment applications. You can interface with the controllers directly through either drunc-unified-shell or drunc-controller-shell. The port through which the communication is sent is defined in the connectivity service, or can be accessed through the controller's logs.

drunc-controller-shell

Starting

Is done by issuing: 

drunc-controller-shell grpc://hostname:port

where you will have to replace the hostname and the port appropriately.

Commands

This interface is very similar to the drunc-unified-shell. All the commands one can execute from the shell are listed below.

conf, start, enable-triggers, change-rate, disable-triggers, drain-dataflow, stop-trigger-sources, stop and scrap

More details on the available FSM commands is provided here.

  • See conf's documentation here

  • See start's documentation here

  • See enable-triggers's documentation here

  • See change-rate's documentation here

  • See disable-triggers's documentation here

  • See drain-dataflow's documentation here

  • See stop-trigger-sources's documentation here

  • See stop's documentation here

  • See scrap's documentation here

connect

See connect's documentation here

disconnect

See disconnect's documentation here

exclude

See exclude's documentation here

expert-command

See expert-command's documentation here

exit

Works the same way as quit.

help

Gives you help with commands that have been documented. This can be used as just help to declare all the commands that are available at any given time, or as help <command> describes what <command> does and its arguments.

include

See include's documentation here

quit

This closes the connection to the controller.

recompute-status

See recompute-status's documentation here

status

See status's documentation here

surrender-control

See surrender-control's documentation here

take-control

See surrender-control's documentation here

who-is-in-charge

See surrender-control's documentation here

whoami

See whoami's documentation here

Last git commit to the markdown source of this page:

Author: John Freeman

Date: Thu Apr 17 11:25:17 2025 -0500

If you see a problem with the documentation on this page, please file an Issue at https://github.com/DUNE-DAQ/drunc/issues