Merge branch 'cl-doc-fixes' into ania-stage

CumulusNetworks · Feb 21, 2025 · a0e7d4a · a0e7d4a
2 parents 9724d90 + 581738d
commit a0e7d4a
Show file tree

Hide file tree

Showing 2 changed files with 95 additions and 7 deletions.
diff --git 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 >}}
+<!-- THIS IS FOR 5.11.1 AND LATER
+### 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.1 or later.
 {{%/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 or you change the `cumulus` user account password with the Linux `passwd` command.
@@ -448,7 +492,7 @@ Cumulus Linux includes a default NVUE `startup.yaml` file. In addition, NVUE con
 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%}}
 
-To prevent Cumulus Linux from overwriting manual changes to the Linux configuration files when the switch reboots or when changing the `cumulus` user account password with the `passwd` command, follow the steps below **before** you upgrade to 5.11.0 or later, or after a new binary image installation:
+To prevent Cumulus Linux from overwriting manual changes to the Linux configuration files when the switch reboots or when changing the `cumulus` user account password with the `passwd` command, follow the steps below **before** you upgrade to 5.11.1 or later, or after a new binary image installation:
 
 1.  Disable NVUE auto save:
 
@@ -469,7 +513,7 @@ To prevent Cumulus Linux from overwriting manual changes to the Linux configurat
    cumulus@switch:~$ sudo nano /etc/default/nvued
    PASSWORD_NVUE_SYNC=no
    ```
-
+-->
 ### 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]({{<ref "/knowledge-base/Configuration-and-Usage/Administration/Hostname-Option-Received-From-DHCP-Ignored" >}}).

diff --git 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 >}}
+<!-- FOR 5.12.1
+### 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.1 or later.
 {{%/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 or you change the `cumulus` user account password with the Linux `passwd` command.
@@ -325,7 +369,7 @@ Cumulus Linux includes a default NVUE `startup.yaml` file. In addition, NVUE con
 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%}}
 
-To prevent Cumulus Linux from overwriting manual changes to the Linux configuration files when the switch reboots or when changing the `cumulus` user account password with the `passwd` command, follow the steps below **before** you upgrade to 5.12.0 or later, or after a new binary image installation:
+To prevent Cumulus Linux from overwriting manual changes to the Linux configuration files when the switch reboots or when changing the `cumulus` user account password with the `passwd` command, follow the steps below **before** you upgrade to 5.12.1 or later, or after a new binary image installation:
 
 1.  Disable NVUE auto save:
 
@@ -346,7 +390,7 @@ To prevent Cumulus Linux from overwriting manual changes to the Linux configurat
    cumulus@switch:~$ sudo nano /etc/default/nvued
    PASSWORD_NVUE_SYNC=no
    ```
-
+-->
 ### 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]({{<ref "/knowledge-base/Configuration-and-Usage/Administration/Hostname-Option-Received-From-DHCP-Ignored" >}}).