failover RecordStream

failover is a RecordStream implementation that switches the acquisition to a fallback source in case of the connection to the first source is lost or no records are received in a configurable interval. The connection goes back to the primary stream as soon as data comes in again. The failover RecordStream is provided by the gempa plugin rsfailover located in @DATADIR@/plugins/rsfailover.so of the recordstream software package.

Note

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

Application

Data processing with redundant data sources.

Setup

Note

failover can be combined with other RecordStream implementations available in SeisComP, router RecordStream or CAPS.

  1. Add the plugin to the global module configuration (global.cfg):

    plugins = ${plugins}, rsfailover
    
  2. Configure the record source (global.cfg):

    recordstream = failover://@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 (@SYSTEMCONFIGDIR@/failover.conf):

    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, e.g.

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