Page tree

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.

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


  • 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.


    log_size: 104857600
    ldap_retry_time: 10

    netgroup_check_time: 60 
    dirs_not_to_creat: ["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 on port 50100

    log_path: /var/log/hidra
    log_name: datareceiver.log
    procname: hidra-receiver
    whitelist: None

    target_dir: /storage_system/dir1
    data_stream_port: 50100

  • No labels