.. highlight:: rst .. _slink2caps: ########## slink2caps ########## **Data retrieval to CAPS using SeedLink plugins.** Description =========== *slink2caps* uses the available :term:`SeedLink` plugins to feed data from other sources into :ref:`CAPS`. Data can be retrieved from any sources for which a :term:`SeedLink` plugins exists. The data will be converted into :ref:`sec-pt-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 :confval:`bufferFile` to use an alternative location. .. note:: Keep in mind to remove the buffer file before plugin start to reset the data acquisition completely. Module Configuration ==================== | :file:`etc/defaults/global.cfg` | :file:`etc/defaults/slink2caps.cfg` | :file:`etc/global.cfg` | :file:`etc/slink2caps.cfg` | :file:`~/.seiscomp/global.cfg` | :file:`~/.seiscomp/slink2caps.cfg` slink2caps inherits :ref:`global options`. .. note:: Modules/plugins may require a license file. The default path to license files is :file:`@DATADIR@/licenses/` which can be overridden by global configuration of the parameter :confval:`gempa.licensePath`. Example: :: gempa.licensePath = @CONFIGDIR@/licenses .. confval:: 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* .. confval:: 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``. .. confval:: 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* .. confval:: output.stdout Type: *boolean* Write miniSEED records to stdout instead of pushing them to CAPS. Default is ``false``. .. confval:: output.address Type: *string* Data output URL [[caps\|capss]:\/\/][user:pass\@]host[:port]. This parameter superseds the host and port parameter of previous versions and takes precedence. Default is ``localhost:18003``. .. confval:: output.host Type: *string* Data output host. Deprecated: Use output.address instead. Default is ``localhost``. .. confval:: output.port Type: *int* Data output port. Deprecated: Use output.address instead. Default is ``18003``. .. confval:: 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``. .. confval:: output.bufferSize Type: *uint* Unit: *bytes* Size \(bytes\) of the packet buffer Default is ``131072``. .. confval:: output.backFillingBufferSize Type: *int* Unit: *s* Length of backfilling buffer. Whenever a gap 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 ``0``. .. confval:: journal.file Type: *string* File to store stream states Default is ``@ROOTDIR@/var/run/rs2caps/journal``. .. confval:: journal.flush Type: *uint* Unit: *s* Flush stream states to disk every n seconds Default is ``10``. .. confval:: journal.waitForAck Type: *uint* Unit: *s* Wait when a sync has been forced, up to n seconds Default is ``60``. .. confval:: journal.waitForLastAck Type: *uint* Unit: *s* Wait on shutdown to receive acknownledgement messages, up to n seconds Default is ``5``. .. confval:: statusLog.enable Type: *boolean* Log information status information e.g. max bytes buffered Default is ``false``. .. confval:: statusLog.flush Type: *uint* Flush status every n seconds to disk Default is ``10``. Command-Line Options ==================== Generic ------- .. option:: -h, --help show help message. .. option:: -V, --version show version information .. option:: --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, e.g. scautopick \-> scautopick2. .. option:: --plugins arg Load given plugins. .. option:: -D, --daemon Run as daemon. This means the application will fork itself and doesn't need to be started with \&. .. option:: -f, --seedlink-config arg Path to Seedlink configuration file. Default: \@ROOTDIR\@\/var\/lib\/seedlink\/seedlink.ini .. option:: -n, --section-name arg Name of Seedlink configuration section. Default: seedlink. Verbosity --------- .. option:: --verbosity arg Verbosity level [0..4]. 0:quiet, 1:error, 2:warning, 3:info, 4:debug .. option:: -v, --v Increase verbosity level \(may be repeated, eg. \-vv\) .. option:: -q, --quiet Quiet mode: no logging output .. option:: --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. .. option:: --component arg Limits the logging to a certain component. This option can be given more than once. .. option:: -s, --syslog Use syslog logging back end. The output usually goes to \/var\/lib\/messages. .. option:: -l, --lockfile arg Path to lock file. .. option:: --console arg Send log output to stdout. .. option:: --debug Debug mode: \-\-verbosity\=4 \-\-console\=1 .. option:: --trace Trace mode: \-\-verbosity\=4 \-\-console\=1 \-\-print\-component\=1 \-\-print\-context\=1 .. option:: --log-file arg Use alternative log file. Output ------ .. option:: -H, --host arg Data output host. Default: localhost. .. option:: -p, --port arg Data output port. Default: 18003. .. option:: -c, --stdout Write records to stdout.