You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

630 lines
32 KiB
HTML

<!DOCTYPE html>
<html >
<head>
<meta charset="utf-8" />
<title>slarchive &#8212; SeisComP Release documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script src="../_static/jquery.js"></script>
<script src="../_static/underscore.js"></script>
<script src="../_static/doctools.js"></script>
<script src="../_static/language_data.js"></script>
<link rel="shortcut icon" href="../_static/favicon.ico"/>
<link rel="index" title="Index" href="../genindex.html" />
<link rel="search" title="Search" href="../search.html" />
<link rel="next" title="slinktool" href="slinktool.html" />
<link rel="prev" title="seedlink" href="seedlink.html" />
</head>
<body>
<div class="header">
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">5.3.0</span>
</div>
</div>
</div>
<div class="nav">
<div class="container">
<div class="content"><a class="pull-right" id="sidebar-toggle">TOC</a>
<div class="related" role="navigation" aria-label="related navigation">
<ul>
<li class="right">
<a href="../genindex.html" title="General Index"
accesskey="I">
index
</a>
</li>
<li class="right">
<a href="slinktool.html" title="slinktool"
accesskey="N">
next
</a>
</li>
<li class="right">
<a href="seedlink.html" title="seedlink"
accesskey="P">
previous
</a>
</li>
<li class="nav-item nav-item-0">
<a href="../index.html">Home</a>
</li>
<li class="nav-item nav-item-1">
<a href="../modules.html" >Modules</a>
</li>
<li class="nav-item nav-item-2">
<a href="../toc/acquisition.html" accesskey="U">Acquisition</a>
</li>
</ul>
</div>
</div>
</div>
</div>
<div class="container">
<div class="fitted content" id="anchors-container">
<div class="body" role="main">
<div class="section" id="slarchive">
<span id="id1"></span><h1>slarchive<a class="headerlink" href="#slarchive" title="Permalink to this headline"></a></h1>
<p><strong>SeedLink client for data stream archiving</strong></p>
<div class="section" id="description">
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline"></a></h2>
<p>slarchive connects to a SeedLink server, requests data streams and writes received
packets into directory/file structures (archives). The precise layout
of the directories and files is defined in a format string.</p>
<p>The implemented layouts are:</p>
<ul class="simple">
<li><p><a class="reference internal" href="#slarchive-section-sds"><span class="std std-ref">SDS</span></a>: The SeisComP Data Structure, default in <cite>SeisComP</cite></p></li>
<li><p>BUD: Buffer of Uniform Data structure</p></li>
<li><p>DLOG: The old SeisComP/datalog structure for backwards compatibility</p></li>
</ul>
<p>The duration for which the data are kept in archive is controlled by the bindings
parameter <a class="reference internal" href="#confval-keep"><code class="xref std std-confval docutils literal notranslate"><span class="pre">keep</span></code></a>. slarchive itself does not clean the archive. For removing
old data execute <code class="file docutils literal notranslate"><span class="pre">$SEISCOMP_ROOT/var/lib/slarchive/purge_datafiles</span></code>. A
regular clean-up is suggested by</p>
<div class="highlight-rst notranslate"><div class="highlight"><pre><span></span>seiscomp print crontab
</pre></div>
</div>
<p>The resulting line, e.g.</p>
<div class="highlight-rst notranslate"><div class="highlight"><pre><span></span>20 3 <span class="ge">* *</span> * /home/sysop/seiscomp/var/lib/slarchive/purge_datafiles &gt;/dev/null 2&gt;&amp;1
</pre></div>
</div>
<p>can be adjusted and added to crontab.</p>
</div>
<div class="section" id="background-execution">
<h2>Background Execution<a class="headerlink" href="#background-execution" title="Permalink to this headline"></a></h2>
<p>When starting slarchive in <cite>SeisComP</cite> as a daemon module in the background SDS is
considered and the packets are written without modification:</p>
<div class="highlight-rst notranslate"><div class="highlight"><pre><span></span>$ seiscomp start slarchive
</pre></div>
</div>
</div>
<div class="section" id="command-line-execution">
<h2>Command-Line Execution<a class="headerlink" href="#command-line-execution" title="Permalink to this headline"></a></h2>
<p>Writing to <strong>other layouts</strong> or to <strong>multiple archives</strong> and other options are
supported when executing slarchive on the command line.
E.g. to write to more than one archive simply specify multiple format definitions
(or presets).</p>
<p>For more command-line option read the help:</p>
<div class="highlight-rst notranslate"><div class="highlight"><pre><span></span>$ slarchive -h
</pre></div>
</div>
</div>
<div class="section" id="multiple-instances">
<h2>Multiple Instances<a class="headerlink" href="#multiple-instances" title="Permalink to this headline"></a></h2>
<p>slarchive allows generating aliases, e.g. for running in multiple instances with
different module and bindings configurations. For creating/removing aliases use the
<a class="reference internal" href="../base/management.html#sec-management-commands"><span class="std std-ref">seiscomp script</span></a>, e.g.</p>
<div class="highlight-rst notranslate"><div class="highlight"><pre><span></span>$ seiscomp alias create slarchive2 slarchive
</pre></div>
</div>
</div>
<div class="section" id="sds-definition">
<span id="slarchive-section-sds"></span><h2>SDS definition<a class="headerlink" href="#sds-definition" title="Permalink to this headline"></a></h2>
<p>SDS is the basic directory and file layout in <cite>SeisComP</cite> for waveform archives. The
archive base directory is defined by <a class="reference internal" href="#confval-archive"><code class="xref std std-confval docutils literal notranslate"><span class="pre">archive</span></code></a>. The SDS layout is defined
as:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>&lt;SDSdir&gt;
+ year
+ network code
+ station code
+ channel code
+ one file per day and location, e.g. NET.STA.LOC.CHAN.D.YEAR.DOY
</pre></div>
</div>
<p>File example: <code class="file docutils literal notranslate"><span class="pre">&lt;SDSdir&gt;/Year/NET/STA/CHAN.TYPE/NET.STA.LOC.CHAN.TYPE.YEAR.DAY</span></code>.</p>
<table class="docutils align-default">
<colgroup>
<col style="width: 19%" />
<col style="width: 81%" />
</colgroup>
<thead>
<tr class="row-odd"><th class="head"><p>Field</p></th>
<th class="head"><p>Description</p></th>
</tr>
</thead>
<tbody>
<tr class="row-even"><td><p>SDSdir</p></td>
<td><p>Arbitrary base directory</p></td>
</tr>
<tr class="row-odd"><td><p>YEAR</p></td>
<td><p>4 digit YEAR</p></td>
</tr>
<tr class="row-even"><td><p>NET</p></td>
<td><p>Network code/identifier, 1-8 characters,
no spaces</p></td>
</tr>
<tr class="row-odd"><td><p>STA</p></td>
<td><p>Station code/identifier, 1-8 characters,
no spaces</p></td>
</tr>
<tr class="row-even"><td><p>CHAN</p></td>
<td><p>Channel code/identifier, 1-8 characters,
no spaces</p></td>
</tr>
<tr class="row-odd"><td><p>TYPE</p></td>
<td><p>1 character, indicating the data type,
provided types are:</p>
<div class="line-block">
<div class="line"><strong>D</strong> Waveform data</div>
<div class="line"><strong>E</strong> Detection data</div>
<div class="line"><strong>L</strong> Log data</div>
<div class="line"><strong>T</strong> Timing data</div>
<div class="line"><strong>C</strong> Calibration data</div>
<div class="line"><strong>R</strong> Response data</div>
<div class="line"><strong>O</strong> Opaque data</div>
</div>
</td>
</tr>
<tr class="row-even"><td><p>LOC</p></td>
<td><p>Location identifier, 1-8 characters,
no spaces</p></td>
</tr>
<tr class="row-odd"><td><p>DAY</p></td>
<td><p>3 digit day of year, padded with zeros</p></td>
</tr>
</tbody>
</table>
</div>
<div class="section" id="module-configuration">
<span id="slarchive-configuration"></span><h2>Module Configuration<a class="headerlink" href="#module-configuration" title="Permalink to this headline"></a></h2>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>slarchive is a <a class="reference internal" href="../base/glossary.html#term-standalone-module"><span class="xref std std-term">standalone module</span></a> and does not inherit <a class="reference internal" href="global.html#global-configuration"><span class="std std-ref">global options</span></a>.</p>
</div>
<div class="line-block">
<div class="line"><code class="file docutils literal notranslate"><span class="pre">etc/defaults/slarchive.cfg</span></code></div>
<div class="line"><code class="file docutils literal notranslate"><span class="pre">etc/slarchive.cfg</span></code></div>
<div class="line"><code class="file docutils literal notranslate"><span class="pre">~/.seiscomp/slarchive.cfg</span></code></div>
</div>
<dl class="confval">
<dt id="confval-address">
<code class="sig-name descname">address</code><a class="headerlink" href="#confval-address" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">127.0.0.1</span></code></p>
<p>Type: <em>string</em></p>
<p>Host of the Seedlink server to connect to. If the acquisition
is running on one system nothing needs to be changed.</p>
</dd></dl>
<dl class="confval">
<dt id="confval-port">
<code class="sig-name descname">port</code><a class="headerlink" href="#confval-port" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">18000</span></code></p>
<p>Type: <em>int</em></p>
<p>The port of the Seedlink server to connect to. If the acquisition
is running on one system this port must match the configured
local Seedlink port.</p>
</dd></dl>
<dl class="confval">
<dt id="confval-archive">
<code class="sig-name descname">archive</code><a class="headerlink" href="#confval-archive" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">var/lib/archive</span></code></p>
<p>Type: <em>string</em></p>
<p>Path to waveform archive where all data is stored. Relative paths
(as the default) are treated relative to the installation
directory ($SEISCOMP_ROOT).</p>
</dd></dl>
<dl class="confval">
<dt id="confval-buffer">
<code class="sig-name descname">buffer</code><a class="headerlink" href="#confval-buffer" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">1000</span></code></p>
<p>Type: <em>int</em></p>
<p>Number of records (512 byte units) to buffer before flushing to
disk.</p>
</dd></dl>
<dl class="confval">
<dt id="confval-delay">
<code class="sig-name descname">delay</code><a class="headerlink" href="#confval-delay" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">30</span></code></p>
<p>Type: <em>int</em></p>
<p>Unit: <em>s</em></p>
<p>The network reconnect delay (in seconds) for the connection
to the SeedLink server. If the connection breaks for any
reason this will govern how soon a reconnection should be
attempted. The default value is 30 seconds.</p>
</dd></dl>
<dl class="confval">
<dt id="confval-networkTimeout">
<code class="sig-name descname">networkTimeout</code><a class="headerlink" href="#confval-networkTimeout" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">900</span></code></p>
<p>Type: <em>int</em></p>
<p>Unit: <em>s</em></p>
<p>The network timeout (in seconds) for the connection to the
SeedLink server. If no data [or keep alive packets?] are received
in this time range the connection is closed and re-established
(after the reconnect delay has expired). The default value is
600 seconds. A value of 0 disables the timeout.</p>
</dd></dl>
<dl class="confval">
<dt id="confval-idleTimeout">
<code class="sig-name descname">idleTimeout</code><a class="headerlink" href="#confval-idleTimeout" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">300</span></code></p>
<p>Type: <em>int</em></p>
<p>Unit: <em>s</em></p>
<p>Timeout for closing idle data stream files in seconds. The idle
time of the data streams is only checked when some packets has
arrived. If no packets arrived no idle stream files will be
closed. There is no reason to change this parameter except for
the unusual cases where the process is running against an open
file number limit. Default is 300 seconds.</p>
</dd></dl>
<dl class="confval">
<dt id="confval-keepalive">
<code class="sig-name descname">keepalive</code><a class="headerlink" href="#confval-keepalive" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0</span></code></p>
<p>Type: <em>int</em></p>
<p>Unit: <em>s</em></p>
<p>Interval (in seconds) at which keepalive (heartbeat) packets
are sent to the server. Keepalive packets are only sent if
nothing is received within the interval. This requires a
Seedlink version &gt;= 3.</p>
</dd></dl>
<dl class="confval">
<dt id="confval-validation.certs">
<code class="sig-name descname">validation.certs</code><a class="headerlink" href="#confval-validation.certs" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">var/lib/certs</span></code></p>
<p>Type: <em>string</em></p>
<p>Path to cerificate store where all certificates and CRLs are stored. Relative
paths(as the default) are treated relative to the installation
directory ($SEISCOMP_ROOT).
If the signature check is enabled slarchive loads all files at start. The store
uses the OpenSSl store format. From the offical OpenSSL documentation:
“The directory should contain one certificate or CRL per file in PEM format,
with a file name of the form hash.N for a certificate, or hash.rN for a CRL.
The .N or .rN suffix is a sequence number that starts at zero, and is incremented
consecutively for each certificate or CRL with the same hash value. Gaps in the
sequence numbers are not supported, it is assumed that there are no more objects
with the same hash beyond the first missing number in the sequence.The .N or .rN suffix
is a sequence number that starts at zero, and is incremented consecutively for
each certificate or CRL with the same hash value. Gaps in the sequence numbers
are not supported, it is assumed that there are no more objects with the same
hash beyond the first missing number in the sequence.”
The hash value can be obtained as follows:</p>
<p>openssl x509 -hash -noout -in &lt;file&gt;</p>
</dd></dl>
<dl class="confval">
<dt id="confval-validation.mode">
<code class="sig-name descname">validation.mode</code><a class="headerlink" href="#confval-validation.mode" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">ignore</span></code></p>
<p>Type: <em>string</em></p>
<p>Signatures are expected to be carried in blockette 2000
as opaque data. Modes:</p>
<p>ignore : Signatures will be ignored and no further actions
will be taken.
warning: Signatures will be checked and all received records
which do not carry a valid signature or no signature
at all will be logged with at warning level.
skip : All received records without a valid signature
will be ignored and will not be processed.</p>
</dd></dl>
</div>
<div class="section" id="bindings-parameters">
<h2>Bindings Parameters<a class="headerlink" href="#bindings-parameters" title="Permalink to this headline"></a></h2>
<dl class="confval">
<dt id="confval-selectors">
<code class="sig-name descname">selectors</code><a class="headerlink" href="#confval-selectors" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>list:string</em></p>
<p>List of stream selectors. If left empty all available
streams will be requested. See slarchive manpage for
more information.</p>
</dd></dl>
<dl class="confval">
<dt id="confval-keep">
<code class="sig-name descname">keep</code><a class="headerlink" href="#confval-keep" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">30</span></code></p>
<p>Type: <em>int</em></p>
<p>Unit: <em>day</em></p>
<p>Number of days the data is kept in the archive. This
requires purge_datafile to be run as cronjob.</p>
</dd></dl>
</div>
<div class="section" id="command-line-options">
<h2>Command-Line Options<a class="headerlink" href="#command-line-options" title="Permalink to this headline"></a></h2>
<p><strong class="program">slarchive [OPTION]... [host][:][port]</strong></p>
<p>Address ([host][:][port]) is a required argument. It specifies the address
of the SeedLink server in host:port format. Either the host, port or both
can be omitted. If host is omitted then localhost is assumed,
i.e. :18000 implies localhost:18000. If the port is omitted
then 18000 is assumed, i.e. localhost implies localhost:18000.
If only : is specified localhost:18000 is assumed.</p>
<dl class="option">
<dt id="cmdoption-slarchive-v">
<code class="sig-name descname">-V</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-slarchive-v" title="Permalink to this definition"></a></dt>
<dd><p>Print program version and exit.</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-slarchive-h">
<code class="sig-name descname">-h</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-slarchive-h" title="Permalink to this definition"></a></dt>
<dd><p>Print program usage and exit.</p>
</dd></dl>
<dl class="option">
<dt id="id2">
<code class="sig-name descname">-v</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#id2" title="Permalink to this definition"></a></dt>
<dd><p>Be more verbose. This flag can be used multiple times (“-v -v” or “-vv”)
for more verbosity. One flag: report basic handshaking (link configuration) details and
briefly report each packet received. Two flags: report the details of the handshaking,
each packet received and detailed connection diagnostics.</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-slarchive-p">
<code class="sig-name descname">-p</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-slarchive-p" title="Permalink to this definition"></a></dt>
<dd><p>Print details of received Mini-SEED data records. This flag can be used multiple times
(“-p -p” or “-pp”) for more detail. One flag: a single summary line
for each data packet received. Two flags: details of the Mini-SEED data records received,
including information from fixed header and 100/1000/1001 blockettes.</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-slarchive-nd">
<code class="sig-name descname">-nd</code><code class="sig-prename descclassname"> delay</code><a class="headerlink" href="#cmdoption-slarchive-nd" title="Permalink to this definition"></a></dt>
<dd><p>The network reconnect delay (in seconds) for the connection to the SeedLink server.
If the connection breaks for any reason this will govern how soon a reconnection should
be attempted. The default value is 30 seconds.</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-slarchive-nt">
<code class="sig-name descname">-nt</code><code class="sig-prename descclassname"> timeout</code><a class="headerlink" href="#cmdoption-slarchive-nt" title="Permalink to this definition"></a></dt>
<dd><p>The network timeout (in seconds) for the connection to the SeedLink server. If no data
[or keep alive packets?] are received in this time range the connection is closed and
re-established (after the reconnect delay has expired). The default value is 600 seconds.
A value of 0 disables the timeout.</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-slarchive-k">
<code class="sig-name descname">-k</code><code class="sig-prename descclassname"> keepalive</code><a class="headerlink" href="#cmdoption-slarchive-k" title="Permalink to this definition"></a></dt>
<dd><p>Interval (in seconds) at which keepalive (heartbeat) packets are sent to the server.
Keepalive packets are only sent if nothing is received within the interval. Requires SeedLink
version &gt;= 3.</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-slarchive-x">
<code class="sig-name descname">-x</code><code class="sig-prename descclassname"> statefile[:interval]</code><a class="headerlink" href="#cmdoption-slarchive-x" title="Permalink to this definition"></a></dt>
<dd><p>During client shutdown the last received sequence numbers and time stamps (start times)
for each data stream will be saved in this file. If this file exists upon startup the information
will be used to resume the data streams from the point at which they were stopped. In this way the
client can be stopped and started without data loss, assuming the data are still available on the
server. If an interval is specified the state will be saved every interval in that packets are
received. Otherwise the state will be saved only on normal program termination.</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-slarchive-i">
<code class="sig-name descname">-i</code><code class="sig-prename descclassname"> timeout</code><a class="headerlink" href="#cmdoption-slarchive-i" title="Permalink to this definition"></a></dt>
<dd><p>Timeout for closing idle data stream files in seconds. The idle time of the data streams is
only checked when some packets has arrived. If no packets arrived no idle stream files will be
closed. There is no reason to change this parameter except for the unusual cases where the
process is running against an open file number limit. Default is 300 seconds.</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-slarchive-d">
<code class="sig-name descname">-d</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-slarchive-d" title="Permalink to this definition"></a></dt>
<dd><p>Configure the connection in “dial-up” mode. The remote server will close the connection when
it has sent all of the data in its buffers for the selected data streams. This is opposed to
the normal behavior of waiting indefinitely for data.</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-slarchive-b">
<code class="sig-name descname">-b</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-slarchive-b" title="Permalink to this definition"></a></dt>
<dd><p>Configure the connection in “batch” mode.</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-slarchive-fi-overlap">
<code class="sig-name descname">-Fi[:overlap]</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-slarchive-fi-overlap" title="Permalink to this definition"></a></dt>
<dd><p>Future check initially. Check the last Mini-SEED data record in an existing archive file
and do not write new data to that file if it is older than a certain overlap. The default
overlap limit is 2 seconds; the overlap can be specified by appending a colon and the desired
overlap limit in seconds to the option. If the overlap is exceeded an error message will be
logged once for each time the file is opened. This option makes sense only for archive formats
where each unique data stream is written to a unique file (e.g. SDS format). If a data stream
is closed due to timeout (see option -i) the initial future check will be preformed when the
file is re-opened.</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-slarchive-fc-overlap">
<code class="sig-name descname">-Fc[:overlap]</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-slarchive-fc-overlap" title="Permalink to this definition"></a></dt>
<dd><p>Future check continuously. Available only for archive Mini-SEED data records. Check if the
first sample of the record is older than the last sample of the previous record for a given
archive file, within a certain overlap. The default overlap limit is 2 seconds; the overlap
can be specified by appending a colon and the desired overlap limit in seconds to the option.
If the overlap is exceeded an error message will be logged once until either a non-overlapping
packet is received or a new archive file is used. This option only makes sense for archive
formats where each unique data stream is written to a unique file (e.g. SDS format).</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-slarchive-a">
<code class="sig-name descname">-A</code><code class="sig-prename descclassname"> format</code><a class="headerlink" href="#cmdoption-slarchive-a" title="Permalink to this definition"></a></dt>
<dd><p>If specified, all received packets (Mini-SEED records) will be appended to a directory/file
structure defined by format. All directories implied in the format string will be created if
necessary. The option may be used multiple times to write received packets to multiple archives.
See the section “archiving data”.</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-slarchive-sds">
<code class="sig-name descname">-SDS</code><code class="sig-prename descclassname"> path</code><a class="headerlink" href="#cmdoption-slarchive-sds" title="Permalink to this definition"></a></dt>
<dd><p>If specified, all received packets (Mini-SEED records) will be saved into a Simple Data
Structure (SDS) dir/file structure starting at the specified directory. This directory and
all subdirectories will be created if necessary. This option is a preset of the -A option.
The SDS dir/file structure is:</p>
<p>&lt;SDSdir&gt;/&lt;YEAR&gt;/&lt;NET&gt;/&lt;STA&gt;/&lt;CHAN.TYPE&gt;/NET.STA.LOC.CHAN.TYPE.YEAR.DAY</p>
<p>Details are mentioned later on.</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-slarchive-bud">
<code class="sig-name descname">-BUD</code><code class="sig-prename descclassname"> path</code><a class="headerlink" href="#cmdoption-slarchive-bud" title="Permalink to this definition"></a></dt>
<dd><p>If specified, all received waveform data packets (Mini-SEED data records) will be saved into
a Buffer of Uniform Data (BUD) dir/file structure starting at the specified directory.
This directory and all subdirectories will be created if necessary. This option is a preset
of the -A option. The BUD dir/file structure is:</p>
<p>&lt;BUDdir&gt;/&lt;NET&gt;/&lt;STA&gt;/STA.NET.LOC.CHAN.YEAR.DAY</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-slarchive-dlog">
<code class="sig-name descname">-DLOG</code><code class="sig-prename descclassname"> DLOGdir</code><a class="headerlink" href="#cmdoption-slarchive-dlog" title="Permalink to this definition"></a></dt>
<dd><p>If specified, all received packets (Mini-SEED data records) will be saved into an old style
SeisComP/datalog dir/file structure starting at the specified directory. This directory and
all subdirectories will be created if necessary. This option is a preset of the -A option.
The DLOG dir/file structure is:</p>
<p>&lt;DLOGdir&gt;/&lt;STA&gt;/[LOC.]&lt;CHAN&gt;.&lt;TYPE&gt;/STA.NET.CHAN.TYPE.YEAR.DAY.HHMM</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-slarchive-l">
<code class="sig-name descname">-l</code><code class="sig-prename descclassname"> streamfile</code><a class="headerlink" href="#cmdoption-slarchive-l" title="Permalink to this definition"></a></dt>
<dd><p>The given file contains a list of streams. This option implies multi-station mode.
The format of the stream list file is given below in the section “stream list file”.</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-slarchive-s">
<code class="sig-name descname">-s</code><code class="sig-prename descclassname"> selectors</code><a class="headerlink" href="#cmdoption-slarchive-s" title="Permalink to this definition"></a></dt>
<dd><p>Defining default selectors. If no multi-station data streams are configured these selectors
will be used for uni-station mode. Otherwise these selectors will be used when no selectors
are specified for a given stream with the -S or -l options.</p>
</dd></dl>
<dl class="option">
<dt id="id3">
<code class="sig-name descname">-S</code><code class="sig-prename descclassname"> stream[:selectors]</code><a class="headerlink" href="#id3" title="Permalink to this definition"></a></dt>
<dd><p>The connection will be configured in multi-station mode with optional SeedLink selectors
for each station, see examples below. Stream should be provided in NET_STA format. If no
selectors are provided for a given stream, the default selectors will be used, if defined.</p>
<p>Requires SeedLink &gt;= 2.5.</p>
</dd></dl>
<dl class="option">
<dt id="cmdoption-slarchive-tw">
<code class="sig-name descname">-tw</code><code class="sig-prename descclassname"> start:[end]</code><a class="headerlink" href="#cmdoption-slarchive-tw" title="Permalink to this definition"></a></dt>
<dd><p>Specifying a time window for the data streams that is applied by the server. The format
for both times is year,month,day,hour,min,sec; for example: “2002,08,05,14,00:2002,08,05,14,15,00”.
The end time is optional but the colon must be present. If no end time is specified the
server will send data indefinitely. This option will override any saved state information.</p>
<p>Warning: time windowing might be disabled on the remote server.</p>
<p>Requires SeedLink &gt;= 3.</p>
</dd></dl>
</div>
</div>
<div id="anchors-bottom"></div>
</div>
<div class="sidebar" role="navigation" aria-label="main navigation">
<div id="anchors-top"></div>
<div id="anchors" class="content">
<div id="searchbox" style="display: none" role="search">
<h3 id="searchlabel">Quick search</h3>
<div class="searchformwrapper">
<form class="search" action="../search.html" method="get">
<input type="text" name="q" aria-labelledby="searchlabel" />
<input type="submit" value="Go" />
</form>
</div>
</div>
<script>$('#searchbox').show(0);</script>
<h3><a href="../index.html">Table of Contents</a></h3>
<ul>
<li><a class="reference internal" href="#">slarchive</a><ul>
<li><a class="reference internal" href="#description">Description</a></li>
<li><a class="reference internal" href="#background-execution">Background Execution</a></li>
<li><a class="reference internal" href="#command-line-execution">Command-Line Execution</a></li>
<li><a class="reference internal" href="#multiple-instances">Multiple Instances</a></li>
<li><a class="reference internal" href="#sds-definition">SDS definition</a></li>
<li><a class="reference internal" href="#module-configuration">Module Configuration</a></li>
<li><a class="reference internal" href="#bindings-parameters">Bindings Parameters</a></li>
<li><a class="reference internal" href="#command-line-options">Command-Line Options</a></li>
</ul>
</li>
</ul>
<h4>Previous topic</h4>
<p class="topless"><a href="seedlink.html"
title="previous chapter">seedlink</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="slinktool.html"
title="next chapter">slinktool</a></p>
<div role="note" aria-label="source link">
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="../_sources/apps/slarchive.rst.txt"
rel="nofollow">Show Source</a></li>
</ul>
</div>
</div>
</div>
</div>
</div>
<div class="footer">
<div class="container">
<div class="horizontal layout content">
<a class="fade-in" href="https://www.gempa.de" target="_blank">
<img class="brand" src="../_static/brands/gempa.svg"/>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>5.3.0</b> Release
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.
</div>
</div>
<a class="fade-in" href="https://www.gfz-potsdam.de" target="_blank">
<img class="brand" src="../_static/brands/gfz.svg"/>
</a>
</div>
</div>
</div>
</body>
</html>