status-im
/
consul
mirror of https://github.com/status-im/consul.git
2
0
Fork 0
Code Issues Projects Releases Wiki Activity

Merge pull request #2282 from hashicorp/b-upgrade-docs 

Updates version documentation.
This commit is contained in:
James Phillips 2016-08-16 14:16:14 -07:00 committed by GitHub
parent d95a498d8a 7a23a25402
commit 462bc71eea
1 changed files with 13 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
website/source/docs/upgrading.html.markdown
View File

@ -73,13 +73,21 @@ running `consul -v`. You'll see output similar to that below:
``` ```
$ consul -v $ consul -v
Consul v0.6.3 Consul v0.7.0
Consul Protocol: 3 (Understands back to: 1) Supported Protocol Version(s): 2 to 3
``` ```
This says the version of Consul as well as the latest protocol version (3, This says the version of Consul as well as the protocol versions this
in this case). It also says the earliest protocol version that this Consul agent can understand.
agent can understand (1, in this case).
Note that sometimes Consul will default to speak a lower protocol version
than it understands, in order to ease compatibility with older agents. For
example, Consul agents that understand version 3 claim to speak version 2,
and only send version 3 messages to agents that understand version 3. This
allows features to upshift automatically as agents are upgraded, and is the
strategy used whenever possible. If this is not possible, then you will need
to do a backward incompatible upgrade using the instructions above, and such
a requirement will be clearly outlined in the notes for a given release.
By specifying the `-protocol` flag on `consul agent`, you can tell the By specifying the `-protocol` flag on `consul agent`, you can tell the
Consul agent to speak any protocol version that it can understand. This Consul agent to speak any protocol version that it can understand. This