From 9e788fbd47198b6fe7737b8df5d707990e6b23aa Mon Sep 17 00:00:00 2001 From: Matt Keeler Date: Mon, 10 Jan 2022 17:18:40 -0500 Subject: [PATCH] Document Consul enterprise 1.10.0-1.10.4 forwards incompatibility with 1.11 (#11978) Also fixed a broken link in the 1.10.x upgrade instructions. Co-authored-by: mrspanishviking --- .../docs/upgrading/instructions/upgrade-to-1-10-x.mdx | 2 +- website/content/docs/upgrading/upgrade-specific.mdx | 7 +++++++ 2 files changed, 8 insertions(+), 1 deletion(-) diff --git a/website/content/docs/upgrading/instructions/upgrade-to-1-10-x.mdx b/website/content/docs/upgrading/instructions/upgrade-to-1-10-x.mdx index 73e10eabf..e55fe05c4 100644 --- a/website/content/docs/upgrading/instructions/upgrade-to-1-10-x.mdx +++ b/website/content/docs/upgrading/instructions/upgrade-to-1-10-x.mdx @@ -14,7 +14,7 @@ description: >- This guide explains how to best upgrade a single Consul Enterprise datacenter to v1.10.0 from a version of Consul that is forward compatible with v1.10. If you are on a major -version of Consul prior to 1.8, you will need to complete and [upgrade to 1.8.13](/docs/upgrading/instructions) +version of Consul prior to 1.8, you will need to complete and [upgrade to 1.8.13](/docs/upgrading/instructions/upgrade-to-1-8-x) or higher before continuing with this guide. If you are already on a major version of 1.8 or 1.9, then this guide will go over the procedures required for upgrading to v1.10. This process will require intermediate version upgrades to a forward-compatible release of v1.8 or v1.9, diff --git a/website/content/docs/upgrading/upgrade-specific.mdx b/website/content/docs/upgrading/upgrade-specific.mdx index b14ce1d92..757c1d73f 100644 --- a/website/content/docs/upgrading/upgrade-specific.mdx +++ b/website/content/docs/upgrading/upgrade-specific.mdx @@ -16,6 +16,13 @@ upgrade flow. ## Consul 1.11.0 +### 1.10 Compatibility +Consul Enterprise versions 1.10.0 through 1.10.4 contain a latent bug that +causes those client or server agents to deregister their own services or health +checks when some of the servers have been upgraded to 1.11. Before upgrading Consul Enterprise servers to 1.11, all Consul agents should first +be upgraded to 1.10.6 or higher to ensure forward compatibility and prevent +flapping of catalog registrations. + ### Deprecated Agent Config Options Consul 1.11.0 is compiled with Go 1.17 and now the ordering of