From cd813e50ec30f463d10236310e0c3e9a60e558f1 Mon Sep 17 00:00:00 2001 From: Preetha Appan Date: Tue, 11 Jun 2019 13:16:37 -0500 Subject: [PATCH] Add warning docs around downgrades --- website/source/guides/upgrade/index.html.md | 7 +++++++ website/source/guides/upgrade/upgrade-specific.html.md | 5 +++++ 2 files changed, 12 insertions(+) diff --git a/website/source/guides/upgrade/index.html.md b/website/source/guides/upgrade/index.html.md index 64484196f..6baeb7bc6 100644 --- a/website/source/guides/upgrade/index.html.md +++ b/website/source/guides/upgrade/index.html.md @@ -17,6 +17,13 @@ communication with Servers. As such, care should be taken to properly upgrade Nomad to ensure minimal service disruption. Unsafe upgrades can cause a service outage. +~> **Downgrade Warning!** We currently do not support safely downgrading +Nomad servers. This is due to the fact that the data directory +contains transaction logs which may not safely apply after a downgrade. To downgrade +a Nomad server, its data directory must be wiped out. In general, Client downgrades are +safe to do, however we recommend checking the [upgrade specific](/guides/upgrade/upgrade-specific.html) +page which will highlight versions where a client downgrade is not supported. + ## Upgrade Process For upgrades we strive to ensure backwards compatibility. For most upgrades, the diff --git a/website/source/guides/upgrade/upgrade-specific.html.md b/website/source/guides/upgrade/upgrade-specific.html.md index fecbe2ed6..aa084261b 100644 --- a/website/source/guides/upgrade/upgrade-specific.html.md +++ b/website/source/guides/upgrade/upgrade-specific.html.md @@ -107,6 +107,11 @@ unchanged. Since HCL2 uses dotted object notation for interpolation users should transition away from variable names with multiple consecutive dots. +### Downgrading clients +Due to the large refactor of the Nomad client in 0.9, downgrading to a +previous version of the client after upgrading it to Nomad 0.9 is not supported. +To downgrade safely, users should erase the Nomad client's data directory. + ## Nomad 0.8.0 ### Raft Protocol Version Compatibility