diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/operations.md | 17 |
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 |
