Skip to content

Latest commit

 

History

History
123 lines (86 loc) · 5.12 KB

FAQ.md

File metadata and controls

123 lines (86 loc) · 5.12 KB
Raw

Frequently asked questions

← Go back to Advanced Topics | ↑ Go to the Table of Content ↑

Git

Are there instructions how to use Git ?

See here.

Coding Guidelines

Where are the Coding Guidelines ?

They are here.

How do I check my code or apply the guidelines ?

See here.

Build

How do I add a dependency to my module ?

We use standard CMake and you should get acquainted with this tool. In the CMakeLists.txt of your module, add the missing dependency to the command target_link_libraries (i.e. the name of the library without "lib" and ".so". For AliceO2 libraries see the next question.

How do I make my module depend on library XXX from AliceO2 ?

Add the library name to the list O2_LIBRARIES_NAMES in FindAliceO2.cmake

Run

Why are my QC processes using 100% CPU ?

When running o2-qc or other qc binaries, the system will show that the processes use 100% of the CPU. This is due to the DPL default rate for the event loop of devices with inputs.

Simply start your binary with --rate 10000 and it should solve the problem. The rate might have to be adapted to your workflow :

o2-qc-run-producer | o2-qc --config json://${QUALITYCONTROL_ROOT}/etc/basic.json --rate 10000

Why are some of my log messages not appearing ?

If they are Debug messages, it is expected. To enable debug messages, edit your config file :

      "infologger": {                     "": "Configuration of the Infologger (optional).",
        "filterDiscardDebug": "false",    "": "Set to 1 to discard debug and trace messages (default: false)",

There are more options in the "Advanced" section of this guide.

QCDB

How to see which objects are stored in the CCDB ?

The easiest is to use the QCG (QC GUI). If you use the central test CCDB, you can use the central test QCG. Simply direct your browser to https://qcg-test.cern.ch.

If for some reason you don't want or can't use the QCG, the CCDB provides a web interface accessible at http://ccdb-test.cern.ch:8080/browse/.

How to delete objects from the CCDB ?

The nuclear option

By accessing http://ccdb-test.cern.ch:8080/truncate/path/to/folder/.* you will delete all the objects at the given path. Careful with that please ! Don't delete data of others.
In production it will of course not be possible to do so.

A set of run exported from the logbook

Use o2-qc-repo-delete-objects-in-runs. The --help will tell you all you need to know about this tool. --print-list is very useful to see what will be deleted.

Here is an example:

o2-qc-repo-delete-objects-in-runs --url http://localhost:8083 --path qc/EMC/.* --runs-csv-file /tmp/runs_standalone_bad_LHC22m.csv

By time period

Use o2-qc-repo-delete-time-interval. The --help will tell you all you need to know about this tool. --print-list is very useful to see what will be deleted.

Here is an example:

o2-qc-repo-delete-time-interval --url http://localhost:8083 --path qc_async/EMC/MO/AsyncTrend --from 0 --to 1654706422910

My objects are not stored due to their size. What can I do ?

You see warnings in the logs:

Warning - object qc/DET/MO/xxx/xxx is bigger than the maximum allowed size (2097152B) - skipped

This is because the maximum allowed size for an object is 2MiB. It can be increased by updating the following item in the config:

{
  "qc": {
    "config": {
      "database": {
        "maxObjectSize": "2097152",       "": "[Bytes, default=2MB] Maximum size allowed, larger objects are rejected."

← Go back to Advanced Topics | ↑ Go to the Table of Content ↑