From 84ca00fb46a45616181dba6c32a518abbaeddba2 Mon Sep 17 00:00:00 2001 From: Matthias Schiffer Date: Thu, 7 Sep 2023 19:28:38 +0200 Subject: [PATCH] docs: releases/v2023.1: add warning and known issue for v2021.1.x x86 upgrade (cherry picked from commit 60457be7943fe8a1196350c114ed0b9bf91e051c) --- docs/releases/v2023.1.rst | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) diff --git a/docs/releases/v2023.1.rst b/docs/releases/v2023.1.rst index d181f7f12a..f091a71e56 100644 --- a/docs/releases/v2023.1.rst +++ b/docs/releases/v2023.1.rst @@ -7,6 +7,11 @@ Important notes Upgrades to v2023.1 and later releases are only supported from releases v2021.1 and later. This is due to migrations that have been removed to simplify maintenance. +**Note:** +Due to a bug, configuration is lost on upgrades from Gluon v2021.1.x on the *x86-64*, +*x86-generic* and *x86-legacy* targets, returning nodes to config mode. If your +network is still running a Gluon version older than v2022.1, it is recommended to +skip v2023.1 and wait for the v2023.1.1 release. Added hardware support ---------------------- @@ -95,9 +100,13 @@ Bugfixes Minor changes ------------- -- Images built for the ``x86`` targets are now natively bootable on +- .. rst-class:: strike + + Images built for the ``x86`` targets are now natively bootable on EFI systems without CSM or BIOS support modes. + EFI support was found to break upgrades from Gluon v2021.1.x. It will be removed from + v2023.1.x to be reintroduced in a later release. Known issues ------------ @@ -120,3 +129,7 @@ Known issues (`#496 `_) This may lead to issues in environments where a fixed MAC address is expected (like VMware when promiscuous mode is disallowed). + +* Configuration is lost on upgrades from Gluon v2021.1.x on the *x86-64*, *x86-generic* and *x86-legacy* targets, + returning nodes to config mode + (`#2967 `_)