diff options
author | Thomas White <taw@physics.org> | 2022-06-17 12:37:16 +0200 |
---|---|---|
committer | Thomas White <taw@physics.org> | 2022-06-17 15:00:40 +0200 |
commit | 889ed82d2e9d37f59e6872401eea4fed78265ab5 (patch) | |
tree | 1ce2a38494831b21cd0ab1b2608e38be175f2d87 /doc | |
parent | 07217dbd38976849b50eb2c669ca902f068bdce9 (diff) |
ASAP::O: Simplify by removing stream switching logic
Diffstat (limited to 'doc')
-rw-r--r-- | doc/articles/online.rst | 16 |
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 =================== |