gdi2caps

CAPS import module for Guralp GDI server.

Description

The Güralp Data Interconnect plugin(GDI) requests data from one or multiple GDI servers and sends it to a CAPS server. The communication between a GDI server and the plugin itself is based on the GDI client library whereas outgoing packets are send through the CAPS client library. Depending on the configuration outgoing packets are converted on-the-fly into MSEED by the CAPS client library. The plugin supports the following GDI sample formats:

  • INT32

  • INT16

  • IEEE32FLOAT

  • TEXT

Backfilling

By default backfilling of unordered packets is enabled and the buffer size is set to 180 seconds. With backfilling enabled The CAPS client library ensures that all packets within this time window are send in order to the remote CAPS server. The buffer size can be changed in the plugin configuration. A value of zero disables the backfilling.

Connection handling

CAPS Connection

All packets forwarded to the CAPS client library are stored in a local packet buffer and are removed when they have been acknowledged by the remote CAPS server. If a packet could not be send the plugin closes the connection and tries to reconnect in a certain interval. If the packet buffer is exceeded the packet is droped and the client library returns with an error.

GDI Connection

For each configured GDI connection the plugin opens a connection to the remote GDI server. The plugin requests real time data only, the retrievel of “historic” data is not supported yet. Every second the plugin checks the connection state. If the state is GDI_State_Out_Of_Sync it closes the connection and tries to reconnect in a certain interval.

Configuration

Note

  • gdi2caps is a standalone module and does not inherit global options.

  • Modules/plugins may require a license file. The default path to license files is @DATADIR@/licenses/ which can be overridden by module configuration of the parameter gempa.licensePath. Example:

    gempa.licensePath = @CONFIGDIR@/licenses
    
etc/defaults/gdi2caps.cfg
etc/gdi2caps.cfg
~/.seiscomp/gdi2caps.cfg
mapping

Type: strings

List of station name mappings separated by comma. Each list entry has the format [name]:[alias]

mseed

Type: boolean

Enable MSEED encoding. Default is false.

selectors

Type: list:string

Format: [loc.cha, …]. Wildcards are supported.

caps.address

Type: string

CAPS server address. Format is [address[:port]].

caps.backFillingBufferSize

Type: int

Unit: s

Length of backfilling buffer. Whenever a hole is detected, records will be held in a buffer and not sent out. Records are flushed from front to back if the buffer size is exceeded. Default is 180.

Note

profiles.$name.* $name is a placeholder for the name to be used.

profiles.$name.source

Type: string

GDI server address in format [host]:[port]. If port is omitted, 1565 is assumed.

profiles.$name.identifier

Type: string

GDI connection identifying name. If two connections using the same name the first connection will be closed from the server. If omitted, the hostname is used.

profiles.$name.mapping

Type: strings

List of station name mappings separated by comma. Each entry has the format [name]:[alias]

profiles.$name.selectors

Type: list:string

List of selectors separated by comma. Each entry has the format [loc.cha]. Wildcards are supported.

Bindings

address

Type: string

GDI server address in format [host]:[port]. If port is omitted, 1565 is assumed.

identifier

Type: string

GDI connection identifying name. If two connections using the same name the first connection will be closed from the server. If omitted, the hostname is used.

mapping

Type: strings

List of station name mappings separated by comma. Each list entry has the format [name]:[alias]

selectors

Type: list:string

List of selectors separated by comma. Each entry has the format [loc.cha]. Wildcards are supported.