aboutsummaryrefslogtreecommitdiff
path: root/doc/articles
diff options
context:
space:
mode:
authorThomas White <taw@physics.org>2022-06-17 12:37:16 +0200
committerThomas White <taw@physics.org>2022-06-17 15:00:40 +0200
commit889ed82d2e9d37f59e6872401eea4fed78265ab5 (patch)
tree1ce2a38494831b21cd0ab1b2608e38be175f2d87 /doc/articles
parent07217dbd38976849b50eb2c669ca902f068bdce9 (diff)
ASAP::O: Simplify by removing stream switching logic
Diffstat (limited to 'doc/articles')
-rw-r--r--doc/articles/online.rst16
1 files changed, 10 insertions, 6 deletions
diff --git a/doc/articles/online.rst b/doc/articles/online.rst
index 589cde34..6bf58cfa 100644
--- a/doc/articles/online.rst
+++ b/doc/articles/online.rst
@@ -66,12 +66,10 @@ Streaming data using ASAP::O
To tell indexamajig to receive data via ASAP::O, use ``--asapo-endpoint``.
You must additionally specify ``--asapo-token`` (giving the ASAP::O
authentication token), ``--asapo-beamtime`` and ``--asapo-source`` (specifying
-the ASAP::O beamtime ID and data source, respectively).
-
-You can optionally specify the ASAP::O consumer group ID using
-``--asapo-group``. If you don't do this, a random group ID will be generated
-and used. If you run multiple copies of ``indexamajig`` on the same data
-stream, you should make sure that they all use the same consumer group ID.
+the ASAP::O beamtime ID and data source, respectively), and ``--asapo-group``
+with the ASAP::O consumer group ID. If you run multiple copies of
+``indexamajig`` on the same data stream, you should make sure that they all use
+the same consumer group ID.
Tip: Since the ASAP::O token is a long text string, put it in a separate file
and use ``cat`` in backticks, as follows::
@@ -83,6 +81,12 @@ and use ``cat`` in backticks, as follows::
--asapo-source=eiger \
--asapo-group=online
+ASAP::O will remember the last retrieved frame in the stream for the given
+consumer group ID. Therefore, if you run ``indexamajig`` again, it will start
+from where it left off. To start again from the beginning of a stream, you
+will need to reset the 'last read' location separately. Instructions and tools
+for this are pending...
+
MsgPack data format
===================