router recordstream

router is a RecordStream implementation that routes requests for particular channels to a configured RecordStream source.

Configuration

  1. Load plugin with

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

    recordstream.service=router
    recordstream.source=@SYSTEMCONFIGDIR@/router.conf
    
  3. Create the routing table

    Write the URI to the data provider and the network codes in the routing table file, e.g. `router.conf`. It is a simple text file where each line containes a target URI and a list of channel IDs which may have wildcards. The first applicable request applies.

    Example of `router.conf` below:

    fdsnws://service.iris.edu GE.CISI.*
    fdsnws://geofon.gfz-potsdam.de GE.*
    # all others come from local CAPS server:
    caps://localhost:18002 *
    

Note

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

Examples

  1. Use one local host for providing real-time and archived data from the CX network and different remote servers for the GE network.

    recordstream parameters:

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

    `router.conf` example:

    caps://localhost CX.*
    combined://slink/geofon.gfz-potsdam.de:18000;arclink/geofon.gfz-potsdam.de:18001 GE.*
    
  2. Get real-time data from caps. Instead of storing all data locally, they can be fetched from remote servers, when older than 10800 seconds. The servers depend on the network. Some data, in this case from the CX network, remain locally stored.

    recordstream parameters:

    recordstream.service=combined
    recordstream.source=caps/localhost:18002;router/@SYSTEMCONFIGDIR@/router.conf??rtMax=10800
    

    `router.conf` example:

    fdsnws://eida.bgr.de GR.*
    fdsnws://geofon.gfz-potsdam.de GE.*
    
    caps://localhost CX.*