-
Notifications
You must be signed in to change notification settings - Fork 17
Home
Ringserver is a generic ring buffer. The server is commonly used as a buffer for (near) real-time streaming feeds of time series data. Each individual time series is usually identified with a stream name (for seismological data these are equivalent to unique channels). The stream names are completely arbitrary allowing conventions to be created for specific needs.
In general, data clients connect to the server and submit a "subscription" for specific streams and as other data clients submit data into the system they are sent to clients with matching subscriptions. By identifying each buffer packet uniquely and allowing a client to select a starting point in the buffer, clients can resume broken connections without data loss.
Communicating with a server is generally done using the DataLink protocol over TCP/IP. A DataLink client can query the server for various server details, submit data, and subscribe to streams. Server details can include stream lists, client lists and server statistics. The libdali library, written in C, implements the DataLink protocol for clients.
The dalitool program can be used to monitor and diagnose a ringserver instance.
The server can be configured using either command line options or a configuration file. Most options, if specified via the configuration file, can be changed on the fly and the server will take them into account without needing to restart.
Please refer to the reference ringserver configuration file with detailed descriptions of options, any options described as Dynamic will be recognized and changed without restarting the server.
Also see the ringserver manual for command line options.
While the architecture implemented by ringserver is completely generic some additions have been made to support the SeedLink protocol. In particular for packets where the data are miniSEED records the server can be configured to serve the streams via SeedLink.
The ringserver software may be used to implement a stand-alone SeedLink server. One pre-requisite to serving data via SeedLink from ringserver to is have data formatted as miniSEED data records. To accomplish this there are two options:
-
Users that already have miniSEED written to files may configure ringserver to continuously scan directories and files and read any newly arriving data. Read How to configure ringserver as a SeedLink streaming server for more information.
-
Users that can write a program that can submit miniSEED (usually 512-byte records if miniSEED version 2) data to ringserver via DataLink (TCP/IP) simply need to configure the server to listen for DataLink connections and run their submission client.
The server can optionally write transfer logs to record all data sent from the server or submitted to the server for each connection. Commonly this would be used to track data shipments to down stream users.
See the Usage logging overview for more details.
The ring buffer managed by ringserver is a traditional first-in-first-out (FIFO) buffer, once the buffer is full adding new data packets pushes the oldest data packets out of the buffer. The buffer can be run in any of these configurations:
- (Default) As a memory-mapped file. This allows the buffer to be larger than the available memory and be stateful (allowing restarts of the server with no loss of data). Default size is 1 Gigabyte and is only limited to machine resources. Buffer sizes above 2 Gigabytes will generally require a 64-bit binary.
- Read from a file into memory on startup and written to the same file on shutdown. Allows for a stateful buffer and for situations where memory-mapping is not possible or practical.
- As a volatile memory-only buffer. Used in special scenarios only, the buffer is lost on shutdown.
The ringserver program uses the following open source libraries:
- PCRE - Perl Compatible Regular Expressions (www.pcre.org)
- Mini-XML - Lightweight XML Library (www.minixml.org)