Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The configuration is split into two parts:

  • The base configuration which is static for the whole facility (conf/base_receiver.conf)
  • The detector/application specific configuration (conf/datareceiver.conf)

By default the base config contains information like log file size, the ldap uri and hidra internal static settings

The specific config settings are added on top of the base ones, meaning that if a config parameter set it set in both, the specific config overwrites the base config. Same is true for config parameters on the command line.

No Format
 base config --overwritten by-- specific config --overwritten by-- command line arguments

Configuration

  • conf/datareceiver.conf is used as default configuration file
    → either modify this file or create a new config file and use --config_file <config_file> when starting the datareceiver
  • Set up logging:
    • log_path:
      • Path where logfile will be created.
    • log_name:
      • Filename used for logging.
    • log_size:
      •  File size before rollover in B (linux only).
  • Set up general settings:
    • username:
      • If systemd is used: user as which the service should be running.
    • procname:
      • Name with which the service should be running.
    • ldapuri:
      • LDAP node and port needed to check whitelist.
  • Set up data receiver:

    • whitelist:

      • List of hosts allowed to receive data from

        • empty list: no data is received
        • None: all incoming data is received
    • target_dir:
      • Where incoming data will be stored to
    • data_stream_ip:
      • Local IP to connect dataStream to
    • data_stream_port:
      • TCP port of data pipe
    • ldap_retry_time:
      • Time (in s) to wait for the next netgroup check if the last check retuned an empty list (e.g. LDAP timeout). Has to be bigger than 2.

    • netgroup_check_time:
      • Time (in s) to wait till the next netgroup check to look for netgroup changes. Has to be bigger than 2.

    • dirs_not_to_create:
      • Subdirectories which should not be created when data is stored.

Examples:


Code Block
languagepyyml
titlebase_receiver.confyaml
general:
    log_size: = 104857600
    ldapuri: = ldap_host.desy.de:1234
    ldap_retry_time: = 10

    netgroup_check_time: = 60 
    dirs_not_to_createcreat: = ["commissioning", "current", "local"]

Example 1

  • Linux
  • Log files should be written to /var/log/hidra
  • Data sent from all hosts is accepted
  • Received data is stored to /storage_system/dir1
  • The receiver listens to IP of myreceiver.desy.de on port 50100

 


log_path
Code Block
languagepyyml
titledatareceiver.conf
yaml
general:
         = log_path: /var/log/hidra
log_name          = log_name: datareceiver.log
 procname          = procname: hidra-receiver
 whitelist   whitelist: None

datareceiver:
  = None 
target_dir        = : /storage_system/dir1
     data_stream_ip:    = myreceiver.desy.de
    data_stream_port:  = 50100