aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authortv <tv@krebsco.de>2026-11-16 19:54:35 +0000
committertv <tv@krebsco.de>2026-11-16 21:26:18 +0100
commitc9707297bd393f69461c781a38a5ddb017dced60 (patch)
treebd4bf940103b7f6bc583ef13ba27c9b4eec76c7a /docs
parent3ee3816076d07b0e9b2c56cc7ea6e50951745027 (diff)
federation: the store read from the document
A node of a swarm holding a store holds the store, read from its document (`docs/store.md`, What the store takes from the document): `federation::held`. Whenever the document changes, a worker reads the events it holds that the store wasn't offered from it, under the document's lock, and offers them to the store without it, each taken as from anywhere: once its dependencies are held, judged at its history. Another document (a drop, a rejoin) is read as it comes, the store going on. The node reads its store anew from its document whenever it starts, from the root, by what is its own of it: the events it refused by what it took before, and those its operator had it drop, which it keeps in a file (`--store-file`), written whenever that changes, so that a store read anew in another order refuses what it refused before. A file that doesn't read stops the node from starting; without one, a restart may take what it refused.
Diffstat (limited to 'docs')
-rw-r--r--docs/example.toml6
-rw-r--r--docs/openapi.yaml4
2 files changed, 8 insertions, 2 deletions
diff --git a/docs/example.toml b/docs/example.toml
index d7f8d08..c21158f 100644
--- a/docs/example.toml
+++ b/docs/example.toml
@@ -126,6 +126,12 @@ htpasswd = "/etc/continuum/htpasswd"
# store-root = "/var/lib/continuum/root.json"
# store-id = "…"
+# Behind the `federation` feature, with store-root or store-id: where the node keeps
+# what is its own of its store across restarts (the events it refused by what it took
+# before, and those its operator had it drop). Without, a restart, reading the store
+# anew from the document, may take what it refused.
+# store-file = "/var/lib/continuum/store.json"
+
# SSH keys, as authorized_keys lines (ssh-ed25519 <base64> [comment]), whose signature
# on a strict remake's manifest this node takes: the values kept when the swarm turns
# strict (docs/access.md). Without, it votes for no strict remake; a majority of the
diff --git a/docs/openapi.yaml b/docs/openapi.yaml
index bfb5ba3..0f1af33 100644
--- a/docs/openapi.yaml
+++ b/docs/openapi.yaml
@@ -2802,8 +2802,8 @@ components:
description: |
This node's own files, by kind (`state`: the state file, `document`: the
document file, `backup`: a backup recovered from, `remake`: the input of a
- genesis remake, and behind the `federation` feature `store`: a store's root),
- since it started.
+ genesis remake, and behind the `federation` feature `store`: a store's root,
+ and what the node keeps of its own of its store), since it started.
additionalProperties:
type: object
required: [reads, readBytes, writes, writtenBytes, appends, appendedBytes, errors]