From 9235c790f010d366b5290eef6d51cb857a95a4df Mon Sep 17 00:00:00 2001 From: Mike Nomitch Date: Fri, 9 Jul 2021 06:42:17 -0700 Subject: [PATCH] [docs] Adds federation caveat to upgrade guide (#10847) --- website/content/docs/upgrade/index.mdx | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/website/content/docs/upgrade/index.mdx b/website/content/docs/upgrade/index.mdx index decd7ba44..fc16b1ce3 100644 --- a/website/content/docs/upgrade/index.mdx +++ b/website/content/docs/upgrade/index.mdx @@ -61,6 +61,10 @@ While it is possible to upgrade Nomad client nodes before servers, this guide recommends upgrading servers first as many new client features will not work until servers are upgraded. +In a [federated cluster](https://learn.hashicorp.com/tutorials/nomad/federation), +new features are not guaranteed to work until all agents in a region and the +server nodes in the authoritative region are upgraded. + Whether you are replacing Nomad in place on existing systems or bringing up new servers you should make changes incrementally, verifying cluster health at each step of the upgrade.