aboutsummaryrefslogtreecommitdiffstats
path: root/docs/operations.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/operations.md')
-rw-r--r--docs/operations.md16
1 files changed, 11 insertions, 5 deletions
diff --git a/docs/operations.md b/docs/operations.md
index e1b8e79..4b42992 100644
--- a/docs/operations.md
+++ b/docs/operations.md
@@ -98,10 +98,15 @@ One node at a time, restarting each 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. Mycelium logs it (`Peer speaks another wire version
- (another build); ignoring its messages`, warn, once per peer); libp2p and Tor at debug
- only (`Dropping a message that doesn't decode`). Until the first release, assume
- every upgrade is such a change, and upgrade all nodes close together.
+ 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
+ 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.
+ Until the first release, assume every upgrade is such a change, and upgrade all nodes
+ close together.
* **Automerge.** A remake needs every node to build the same snapshot, byte for byte,
so the same Automerge version everywhere; a node with another one rejoins instead of
switching ([`remakes.md`](remakes.md), [Limits](remakes.md#limits)). Don't remake while
@@ -246,7 +251,8 @@ And from the log, at warn or error:
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.
+ another build; with `version=0`, only a newer build's SPEAKS, which this build doesn't
+ read.
## What a node uses