slink2caps

Data retrieval to CAPS using SeedLink plugins.

Description

slink2caps uses the available SeedLink plugins to feed data from other sources into caps. Data can be retrieved from any sources for which a SeedLink plugins exists. The data will be converted into MiniSeed format.

Transient packets

The plugin data acquisition and the CAPS outgoing connection is not synchronized so that packets might be received by plugins but could not be forwarded to CAPS since the plugin is not allowed to send data to the server or the server is not reachable. In this case packets are in transient state and would be lost on shutdown. To prevent packet loss the plugin stores all transient packets to disk during shutdown by default. Set the parameter bufferFile to use an alternative location.

Note

Keep in mind to remove the buffer file before plugin start to reset the data acquisition completely.

Configuration

etc/defaults/global.cfg
etc/defaults/slink2caps.cfg
etc/global.cfg
etc/slink2caps.cfg
~/.seiscomp/global.cfg
~/.seiscomp/slink2caps.cfg

slink2caps inherits global options.

Note

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

gempa.licensePath = @CONFIGDIR@/licenses
buffer

Type: path

Path to buffer file where transient packets are stored on disk during shutdown. Transient means packets that have been received from input plugins, e.g., chain_plugin but have not been acknowledged by CAPS. Without local storage on disk those packets would be lost. During start the plugin reads the buffer file and tries to send the packets again. Please keep in mind to remove the buffer file before plugin start in case of the data acquisition should be reset. Default is @ROOTDIR@/var/lib/slink2caps/buffer.mseed.

Note

seedlink.* Data input control

seedlink.config

Type: path

Path to Seedlink configuration file. Use the respective name if seedlink runs as an alias. Default is @ROOTDIR@/var/lib/seedlink/seedlink.ini.

seedlink.name

Type: string

Name of Seedlink configuration section. Use the respective name if seedlink runs as an alias. Default is seedlink.

Note

output.* Data output control

output.stdout

Type: boolean

Write miniSEED records to stdout instead of pushing them to CAPS. Default is false.

output.host

Type: string

Hostname or IP of the CAPS server. Default is localhost.

output.port

Type: int

Port of the CAPS server accepting the plugin data. Default is 18003.

output.timeout

Type: int

Unit: s

Timeout when sending a packet. If the timeout expires the connection will be closed and re-established. Default is 60.

output.recordBufferSize

Type: int

Unit: B

Size of CAPS output queue buffer in bytes. Default is 131072.

Command Line

Generic

-h, --help

show help message.

-V, --version

show version information

--config-file arg

Use alternative configuration file. When this option is used the loading of all stages is disabled. Only the given configuration file is parsed and used. To use another name for the configuration create a symbolic link of the application or copy it, eg scautopick -> scautopick2.

--plugins arg

Load given plugins.

-D, --daemon

Run as daemon. This means the application will fork itself and doesn’t need to be started with &.

-f, --seedlink-config arg

Path to Seedlink configuration file. Default: @ROOTDIR@/var/lib/seedlink/seedlink.ini

-n, --section-name arg

Name of Seedlink configuration section. Default: seedlink.

Verbosity

--verbosity arg

Verbosity level [0..4]. 0:quiet, 1:error, 2:warning, 3:info, 4:debug

-v, --v

Increase verbosity level (may be repeated, eg. -vv)

-q, --quiet

Quiet mode: no logging output

--print-component arg

For each log entry print the component right after the log level. By default the component output is enabled for file output but disabled for console output.

--component arg

Limits the logging to a certain component. This option can be given more than once.

-s, --syslog

Use syslog logging back end. The output usually goes to /var/lib/messages.

-l, --lockfile arg

Path to lock file.

--console arg

Send log output to stdout.

--debug

Debug mode: –verbosity=4 –console=1

--trace

Trace mode: –verbosity=4 –console=1 –print-component=1 –print-context=1

--log-file arg

Use alternative log file.

Output

-H, --host arg

Data output host. Default: localhost.

-p, --port arg

Data output port. Default: 18003.

-c, --stdout

Write records to stdout.