From 581738d8e4d0ea5be99be0d0cb8436525983e565 Mon Sep 17 00:00:00 2001 From: cumulusAnia Date: Fri, 21 Feb 2025 12:23:29 -0800 Subject: [PATCH] revert upgrade warning in what's new for 5.11 and 5.12 back to 5.10 --- content/cumulus-linux-511/Whats-New/_index.md | 52 +++++++++++++++++-- content/cumulus-linux-512/Whats-New/_index.md | 50 ++++++++++++++++-- 2 files changed, 95 insertions(+), 7 deletions(-) diff --git a/content/cumulus-linux-511/Whats-New/_index.md b/content/cumulus-linux-511/Whats-New/_index.md index 94f20a4e96..0579bdcaba 100644 --- a/content/cumulus-linux-511/Whats-New/_index.md +++ b/content/cumulus-linux-511/Whats-New/_index.md @@ -434,12 +434,56 @@ To align with a long-term vision of a common interface between Cumulus Linux, Nv ## Release Considerations -Review the following considerations before you upgrade to Cumulus Linux 5.11. +Review the following considerations before you upgrade to Cumulus Linux 5.11.0. ### Linux Configuration Files Overwritten {{%notice warning%}} -If you use Linux commands to configure the switch, read the following information before you upgrade to Cumulus Linux 5.11.0 or later. +If you use Linux commands to configure the switch, read the following information before you upgrade to Cumulus Linux 5.11.0. +{{%/notice%}} + +Cumulus Linux includes a default NVUE `startup.yaml` file. In addition, NVUE configuration auto save is enabled by default. As a result, Cumulus Linux overwrites any manual changes to Linux configuration files on the switch when: +- The switch reboots after upgrade +- You change the cumulus account password with the Linux `passwd` command. + +{{%notice note%}} +These issues occur only if you use Linux commands to configure the switch. If you use NVUE commands to configure the switch, these issues do not occur and no action is needed. +{{%/notice%}} + +{{< tabs "TabID232 ">}} +{{< tab "Switch Reboot">}} + +To prevent Cumulus Linux from overwriting manual changes to the Linux configuration files when the switch reboots after upgrade: + +1. **Before** you upgrade to 5.11.0, disable NVUE auto save: + + ``` + cumulus@switch:~$ nv set system config auto-save state disabled + cumulus@switch:~$ nv config apply + cumulus@switch:~$ nv config save + ``` + +2. Delete the `/etc/nvue.d/startup.yaml` file: + + ``` + cumulus@switch:~$ sudo rm -rf /etc/nvue.d/startup.yaml + ``` + +{{< /tab >}} +{{< tab "cumulus Account Password">}} + +To prevent Cumulus Linux from overriding changes to the Linux configuration files when you change the cumulus account password with the Linux `passwd` command, comment out the `password optional pam_exec.so seteuid /usr/lib/cumulus/reconcile_password_with_nvue.sh` line from the following files **before** you upgrade to 5.11.0: +- `/etc/pam.d/chpasswd` +- `/etc/pam.d/login` +- `/etc/pam.d/passwd` + +{{< /tab >}} +{{< /tabs >}} + ### DHCP Lease with the host-name Option When a Cumulus Linux switch with NVUE enabled receives a DHCP lease containing the host-name option, it ignores the received hostname and does not apply it. For details, see this [knowledge base article]({{}}). diff --git a/content/cumulus-linux-512/Whats-New/_index.md b/content/cumulus-linux-512/Whats-New/_index.md index 88ec9d787d..6a55aa163b 100644 --- a/content/cumulus-linux-512/Whats-New/_index.md +++ b/content/cumulus-linux-512/Whats-New/_index.md @@ -316,7 +316,51 @@ Review the following considerations before you upgrade to Cumulus Linux 5.12. ### Linux Configuration Files Overwritten {{%notice warning%}} -If you use Linux commands to configure the switch, read the following information before you upgrade to Cumulus Linux 5.12.0 or later. +If you use Linux commands to configure the switch, read the following information before you upgrade to Cumulus Linux 5.12.0. +{{%/notice%}} + +Cumulus Linux includes a default NVUE `startup.yaml` file. In addition, NVUE configuration auto save is enabled by default. As a result, Cumulus Linux overwrites any manual changes to Linux configuration files on the switch when: +- The switch reboots after upgrade +- You change the cumulus account password with the Linux `passwd` command. + +{{%notice note%}} +These issues occur only if you use Linux commands to configure the switch. If you use NVUE commands to configure the switch, these issues do not occur and no action is needed. +{{%/notice%}} + +{{< tabs "TabID232 ">}} +{{< tab "Switch Reboot">}} + +To prevent Cumulus Linux from overwriting manual changes to the Linux configuration files when the switch reboots after upgrade: + +1. **Before** you upgrade to 5.12.0, disable NVUE auto save: + + ``` + cumulus@switch:~$ nv set system config auto-save state disabled + cumulus@switch:~$ nv config apply + cumulus@switch:~$ nv config save + ``` + +2. Delete the `/etc/nvue.d/startup.yaml` file: + + ``` + cumulus@switch:~$ sudo rm -rf /etc/nvue.d/startup.yaml + ``` + +{{< /tab >}} +{{< tab "cumulus Account Password">}} + +To prevent Cumulus Linux from overriding changes to the Linux configuration files when you change the cumulus account password with the Linux `passwd` command, comment out the `password optional pam_exec.so seteuid /usr/lib/cumulus/reconcile_password_with_nvue.sh` line from the following files **before** you upgrade to 5.12.0: +- `/etc/pam.d/chpasswd` +- `/etc/pam.d/login` +- `/etc/pam.d/passwd` + +{{< /tab >}} +{{< /tabs >}} + ### DHCP Lease with the host-name Option When a Cumulus Linux switch with NVUE enabled receives a DHCP lease containing the host-name option, it ignores the received hostname and does not apply it. For details, see this [knowledge base article]({{}}).