From c9707297bd393f69461c781a38a5ddb017dced60 Mon Sep 17 00:00:00 2001 From: tv Date: Mon, 16 Nov 2026 19:54:35 +0000 Subject: 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. --- docs/example.toml | 6 ++++++ docs/openapi.yaml | 4 ++-- 2 files changed, 8 insertions(+), 2 deletions(-) (limited to 'docs') 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 [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] -- cgit v1.3.1