Common DFOS tools:
Documentation

dfos = Data Flow Operations System, the common tool set for DFO

Initialization file .dfosrc

Purpose

The initialization file .dfosrc contains all environment variables which are shared amongst DFOS tools. E.g., $DFO_RAW_DIR is the directory root with raw data which may be defined e.g. as /dataqc/uves/raw. Important for the DFOS system is

All common tools can then rely on the same convention. If no DFO variable is defined, the tools will stop. If the variables don't make sense, their reaction is unpredictable. So please check for proper variable settings before submitting problem reports.

Proper sourcing for dfos in general

Here is the current scheme for sourcing initialisation files on the QC machines:

sourcing sequence:
login: .bashrc .pecs files .qcrc .dfosrc

The first three steps are all set up by a standard DFS installation. Step number 4 must be enabled by editing .qcrc to contain "source $HOME/.dfosrc" at the end. If set up this way, a single sourcing of .bashrc makes the whole environment available to e.g. a cronjob tool.

How to fill

printenv | grep DFO

The template file is filled with valid entry for the GIRAFFE account. Some of the variables don't need to be changed (database server names etc.).

In general it's a good idea to follow the file structure examplified as close as possible. But for the DFOS tools it is sufficient to have the environment variables defined as such. Likely, a simple replacement of 'muc03' by your machine name, and 'giraffe' by your account name, may already produce a valid system.

Please note that in the present phase of implementation the structure and content of .dfosrc may incrementally change. To make sure that your version is logically compliant with the most recent version, check out the GIRAFFE version here.


Last update: April 26, 2021 by rhanusch