Configuration¶
OWS has two configuration files, both in /opt/osop/ows/config/:
File |
What it sets |
|---|---|
|
Settings for this computer: the port Winston clients connect to and where your SDS archive is. |
|
OWS itself: the SeedLink server, the archive on/off switch, logging. |
The installer creates both with working defaults and never overwrites them on upgrades. After editing either file, apply the change with:
sudo ows restart
Typical setups¶
Setup |
|
|
|---|---|---|
SeisComP on the same computer (SeedLink on its default port 18000, archive written by |
|
|
SeedLink server on another computer |
|
|
Archive only, no live data |
|
|
Live data only, no archive |
consider a longer |
(unchanged) |
How live data and the archive work together¶
Live data. OWS receives data for every station the SeedLink server offers (see New stations on the SeedLink server for stations added later). It keeps the most recent part in memory: by default the last 5 minutes of every channel (
sources.seedlink.ring_size).Archive. Everything older comes from the SDS archive. OWS reads it as needed and looks for new channels in it every 30 seconds.
Together. A request is answered from both sources. A Swarm helicorder showing the last day therefore needs the archive for everything except the last few minutes. If the archive is the one your SeisComP
slarchivewrites, it is always up to date.
New stations on the SeedLink server¶
OWS saves the SeedLink server’s station list in /opt/osop/ows/cache/ the first time it connects, and uses that
saved list from then on, also after restarts. New channels of stations it already knows appear by themselves. After
you add a station to the SeedLink server, or point OWS at a different SeedLink server, delete the saved list so
OWS asks the server again:
sudo ows stop
sudo rm -f /opt/osop/ows/cache/ows-*.cache
sudo ows
Stations in the archive don’t need this; OWS finds them by itself.
ows-host.conf¶
This file uses shell syntax (NAME=value, no spaces around =).
- LISTEN_PORT¶
Default:
16032The TCP port on this computer where Winston clients (Swarm, Earthworm, ObsPy) connect. 16032 is the usual Winston port. Change it if another program already uses 16032. Clients connect to OWS on this port, on any of this computer’s network addresses.
- ARCHIVE_DIR¶
Default:
/opt/osop/ows/archiveThe root folder of your SDS archive on this computer. OWS only reads it; it never writes to or deletes from it. The folder must use the SDS layout (see SDS archive layout).
ows.conf¶
Each line is key = value. Lines starting with # are comments. A few rules:
Write
trueandfalsein lower case. Anything else, includingTrue, counts as false.Values can’t contain spaces; spaces are removed.
If a key appears twice, the first one counts.
The file uses paths inside the OWS container (
/opt/log,/opt/archive,/opt/cache). Leave them as they are; to change where the archive is on this computer, setARCHIVE_DIRinows-host.conf.
Live data (SeedLink)¶
- sources.seedlink¶
Default in the installed file:
truetrueto receive live data from a SeedLink server.falseto serve the archive only.
- sources.seedlink.host¶
Default in the installed file:
host.docker.internalThe SeedLink server’s host name or IP address.
host.docker.internalmeans this computer: use it when the SeedLink server (for example SeisComP’s) runs on the same computer as OWS. Don’t use127.0.0.1orlocalhost; inside OWS’s container they mean the container itself, not this computer.
- sources.seedlink.port¶
Default in the installed file:
18000The SeedLink server’s TCP port. 18000 is SeisComP’s default.
- sources.seedlink.ring_size¶
Default:
300(not in the installed file)How many seconds of live data OWS keeps in memory for each channel; a whole number. Older data comes from the archive. Without an archive, a longer value lets clients see more recent history, but every channel then holds that much data in memory, and data held only in memory is lost when OWS restarts. With an archive, leave the default.
Archive (SDS)¶
- sources.sds¶
Default in the installed file:
truetrueto serve data from the SDS archive set byARCHIVE_DIR.falseto serve live data only.
- sources.sds.dir¶
Leave it at
/opt/archive. OWS always reads the archive from there; the folder on this computer is set byARCHIVE_DIRinows-host.conf.
Logging¶
- logging.file¶
Default in the installed file:
ows.logThe log file’s name. It is written to
/opt/osop/ows/log/on this computer. Without this key, OWS writes no log file.
- logging.debug¶
Default in the installed file:
falsetruefor detailed logging, for example when OSOP support asks for it. Debug logs grow quickly; set it back tofalseafterwards.
- logging.stderr_out¶
Default in the installed file:
truetrueto also send the log to the console, whichsudo ows logsshows.
- logging.dir¶
Leave it at
/opt/log. OWS always writes its log there, which is/opt/osop/ows/log/on this computer.
Other keys¶
- listen.host¶
Leave it at
0.0.0.0. OWS always accepts connections on all of this computer’s network addresses.
- listen.port¶
Leave it at
16032. To change the port clients connect to, setLISTEN_PORTinows-host.confinstead.
- cache.dir¶
Leave it at
/opt/cache. OWS always keeps its station lists there (/opt/osop/ows/cache/on this computer; see New stations on the SeedLink server).
- cache.hours¶
Default in the installed file:
24Kept for compatibility. It has no effect in this version; leave it as it is.
- cache.segments¶
Default in the installed file:
10Kept for compatibility. It has no effect in this version; leave it as it is.
SDS archive layout¶
OWS reads miniSEED files in the SDS (SeisComP Data Structure) layout, the one SeisComP’s slarchive and
scart write:
ARCHIVE_DIR/YEAR/NET/STA/CHAN.D/NET.STA.LOC.CHAN.D.YEAR.DAY
for example
/home/sysop/seiscomp/var/lib/archive/2026/AM/R0CA2/EHZ.D/AM.R0CA2.00.EHZ.D.2026.311
OWS skips other files and folders inside the archive, so the archive folder may also contain other things.