Skip to content

Commit cb23159

Browse files
committed
[doc] A bit more doc about the DCS mock setup
1 parent 4636d9e commit cb23159

File tree

1 file changed

+18
-0
lines changed

1 file changed

+18
-0
lines changed

core/integration/README.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -29,6 +29,7 @@ CCDB plugin calls PDP-provided executable which creates a General Run Parameters
2929
## DCS
3030

3131
DCS plugin communicates with the ALICE Detector Control System (DCS).
32+
In particular, it communicates with a gRPC endpoint exposed by `ecs2dcsgateway` (developed by the DCS team), which then passes the requests to the DCS.
3233

3334
### DCS operations
3435

@@ -151,6 +152,23 @@ From the AliECS user point of view, state sequences can be defined as the follow
151152
- `dcs_sor_state_sequence`
152153
- `dcs_eor_state_sequence`
153154

155+
#### Testing tips
156+
157+
Typical valid sequences are:
158+
159+
```
160+
{
161+
"dcs_pfr_state_sequence": "1000:RUN_OK",
162+
"dcs_sor_state_sequence": "1000:SOR_PROGRESSING,3000:RUN_OK",
163+
"dcs_eor_state_sequence": "1000:EOR_PROGRESSING,3000:RUN_OK"
164+
}
165+
```
166+
167+
`PFR_AVAILABLE` and `SOR_AVAILABLE` are typically send by DCS via the heartbeat stream, so requesting them as an answer to an operation request does not reflect the behaviour of the production system.
168+
169+
To trigger a `TIMEOUT` event, one should not request a `TIMEOUT` state in the sequence, but rather put a too long delay compared to the provided gRPC timeout.
170+
Both in the production and the mock setup, `TIMEOUT` events are generated by `ecs2dcsgateway` when a detector does not respond to a request within the specified timeout.
171+
154172
## DD Scheduler
155173

156174
DD scheduler plugin informs the Data Distribution software about the pool of FLPs taking part in data taking.

0 commit comments

Comments
 (0)