aboutsummaryrefslogtreecommitdiffstats
path: root/docs/operations.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/operations.md')
-rw-r--r--docs/operations.md17
1 files changed, 9 insertions, 8 deletions
diff --git a/docs/operations.md b/docs/operations.md
index efc6b04..d100a49 100644
--- a/docs/operations.md
+++ b/docs/operations.md
@@ -128,13 +128,15 @@ A node upgrades by restarting with its files. What to know:
* **The wire format.** Each change to it bumps a version byte, and nodes ignore
messages of another version. Across such a change, upgraded nodes and the others
don't talk: the swarm is split until every node is upgraded, both sides go on
- writing, and they merge then. Each logs it (`Peer speaks another wire version
- (another build); ignoring its messages`, warn, once per peer). With each handshake, a
+ writing, and they merge then. Each logs it, at warn, once per peer, naming both
+ versions and the node to upgrade (`Peer speaks another wire version: a newer build
+ (wire version 53; this one speaks 52): upgrade this node to talk with it; ignoring its
+ messages`, or of an older build, `upgrade that node`). With each handshake, a
node says which versions it speaks, and the newest revision of the federation it knows
(SPEAKS, outside the versions; [`peers.md`](peers.md),
- [Handshake and join](peers.md#handshake-and-join)); a build from before SPEAKS logs it
- as that warning, `version=0`, once of the peer, and reads the peer's other messages
- where they are of its version.
+ [Handshake and join](peers.md#handshake-and-join)); a build from before SPEAKS, before
+ 0.0.1, logs it as another wire version, `version=0`, once of the peer, and reads the
+ peer's other messages where they are of its version.
A node speaks one version, so every change of the format is a major release; before
1.0.0, take every upgrade as one, and upgrade all nodes close together.
* **Automerge.** A remake needs every node to build the same snapshot, byte for byte,
@@ -280,9 +282,8 @@ And from the log, at warn or error:
* `Couldn't write the state file`, `Couldn't rewrite the document file`: a full or
read-only disk;
* `The … file is readable by others than its owner; chmod 600 it`;
-* `Peer speaks another wire version (another build); ignoring its messages`: a node on
- another build; with `version=0`, only a newer build's SPEAKS, which this build doesn't
- read.
+* `Peer speaks another wire version: …; ignoring its messages`: a node on another
+ build; the message names both versions, and whether to upgrade this node or that one.
## What a node uses