failover recordstream

failover is a RecordStream implementation that switches the acquisition to a fallback source in case of the connection gets closed or no records have received since a configurable interval. The connection goes back to the primary stream as soon as data comes in again.

Note

This plugin requires at least the SeisComP3 release Jakarta-2017.334. Please check your installed version of SeisComP3, e.g. using scm -V.

Configuration

  1. Load plugin with

    plugins = ${plugins}, rsfailover
    
  2. Configure the record source

    recordstream.service=failover
    recordstream.source=@SYSTEMCONFIGDIR@/failover.conf
    

    Available configuration Parameters are:

    Parameter

    Default

    Description

    timeout

    5

    Failover timeout in seconds

    connectionTimeout

    5

    Initial connection timeout in seconds

  3. Create the failover list

    The failover list is a simple text file where each line contains a target URI. The priority of the streams is from top to bottom in descending order. Below an example for a failover list file failover.conf:

    caps://localhost:18002
    balanced://slink/geofon.gfz-potsdam.de;slink/service.iris.edu
    

Note

failover can be combined with other RecordStream implementations available in SeisComP3 or in CAPS.