diff --git a/content/docs/1.6.4/deploy/important-notes/index.md b/content/docs/1.6.4/deploy/important-notes/index.md index f2559ba70..afbcd0811 100644 --- a/content/docs/1.6.4/deploy/important-notes/index.md +++ b/content/docs/1.6.4/deploy/important-notes/index.md @@ -18,7 +18,7 @@ Please see [here](https://github.com/longhorn/longhorn/releases/tag/v{{< current - [Danger Zone Setting Configuration](#danger-zone-setting-configuration) - [Longhorn PVC with Block Volume Mode](#longhorn-pvc-with-block-volume-mode) - [Minimum XFS Filesystem Size](#minimum-xfs-filesystem-size) - - [Backup Related Custom Resources Might Disappear](#backup-related-custom-resources-might-disappear) + - [Backup Data On The Remote Backup Server Might Be Deleted](#backup-data-on-the-remote-backup-server-might-be-deleted) - [V2 Data Engine](#v2-data-engine) - [Longhorn System Upgrade](#longhorn-system-upgrade) - [Changing Default Huge Page Size to 2 GiB](#changing-default-huge-page-size-to-2-gib) @@ -224,14 +224,18 @@ Longhorn v{{< current-version >}} does not allow the following: However, Longhorn still allows the listed actions when cloning or restoring volumes created with earlier Longhorn versions. -### Backup Related Custom Resources Might Disappear +### Backup Data On The Remote Backup Server Might Be Deleted -Longhorn will attempt to clean up the backup-related custom resources in the following scenarios: +Longhorn may unintentionally delete backup-related custom resources (such as `BackupVolume`, `BackupBackingImage`, `SystemBackup`, and `Backup`) and backup data on the remote backup server before Longhorn v{{< current-version >}} in the following scenarios: - An empty response from the NFS server due to a brief server downtime. -- A race condition between related Longhorn backup controllers. +- A race condition could delete the remote backup volume and its corresponding backups when the backup target is reset within a short period. + +Starting with v{{< current-version >}}, Longhorn handles backup-related custom resources in the following manner: + +- If there are discrepancies between the backup information in the cluster and on the remote backup server, Longhorn deletes only the backup-related custom resources in the cluster. +- The backup-related custom resources in the cluster may be deleted unintentionally while the remote backup data remains safely stored. The deleted resources are resynchronized from the remote backup server during the next polling period (if the backup target is available). -The backup information will be resynchronized during the next polling interval. For more information, see [#9530](https://github.com/longhorn/longhorn/issues/9530). ## V2 Data Engine diff --git a/content/docs/1.7.2/important-notes/_index.md b/content/docs/1.7.2/important-notes/_index.md index 9ae40cee0..06b916a14 100644 --- a/content/docs/1.7.2/important-notes/_index.md +++ b/content/docs/1.7.2/important-notes/_index.md @@ -28,7 +28,7 @@ Please see [here](https://github.com/longhorn/longhorn/releases/tag/v{{< current - [Networking](#networking) - [Storage Network Support for Read-Write-Many (RWX) Volumes](#storage-network-support-for-read-write-many-rwx-volumes) - [Backup](#backup) - - [Related Custom Resources Might Disappear](#related-custom-resources-might-disappear) + - [Backup Data On The Remote Backup Server Might Be Deleted](#backup-data-on-the-remote-backup-server-might-be-deleted) - [V2 Data Engine](#v2-data-engine) - [Longhorn System Upgrade](#longhorn-system-upgrade) - [Enable Both `vfio_pci` and `uio_pci_generic` Kernel Modules](#enable-both-vfio_pci-and-uio_pci_generic-kernel-modules) @@ -208,14 +208,18 @@ For more information, see [Issue #8184](https://github.com/longhorn/longhorn/iss ## Backup -### Related Custom Resources Might Disappear +### Backup Data On The Remote Backup Server Might Be Deleted -Longhorn will attempt to clean up the backup-related custom resources in the following scenarios: +Longhorn may unintentionally delete backup-related custom resources (such as `BackupVolume`, `BackupBackingImage`, `SystemBackup`, and `Backup`) and backup data on the remote backup server before Longhorn v{{< current-version >}} in the following scenarios: - An empty response from the NFS server due to a brief server downtime. -- A race condition between related Longhorn backup controllers. +- A race condition could delete the remote backup volume and its corresponding backups when the backup target is reset within a short period. + +Starting with v{{< current-version >}}, Longhorn handles backup-related custom resources in the following manner: + +- If there are discrepancies between the backup information in the cluster and on the remote backup server, Longhorn deletes only the backup-related custom resources in the cluster. +- The backup-related custom resources in the cluster may be deleted unintentionally while the remote backup data remains safely stored. The deleted resources are resynchronized from the remote backup server during the next polling period (if the backup target is available). -The backup information will be resynchronized during the next polling interval. For more information, see [#9530](https://github.com/longhorn/longhorn/issues/9530). ## V2 Data Engine diff --git a/content/docs/1.8.0/important-notes/_index.md b/content/docs/1.8.0/important-notes/_index.md index aa3ffacca..02560c6d6 100644 --- a/content/docs/1.8.0/important-notes/_index.md +++ b/content/docs/1.8.0/important-notes/_index.md @@ -29,7 +29,7 @@ Please see [here](https://github.com/longhorn/longhorn/releases/tag/v{{< current - [OS Distro Specific](#os-distro-specific) - [V2 Data Engine Support for Talos Linux](#talos-linux) - [Backup](#backup) - - [Related Custom Resources Might Disappear](#related-custom-resources-might-disappear) + - [Backup Data On The Remote Backup Server Might Be Deleted](#backup-data-on-the-remote-backup-server-might-be-deleted) - [V2 Data Engine](#v2-data-engine) - [Longhorn System Upgrade](#longhorn-system-upgrade) - [Enable Both `vfio_pci` and `uio_pci_generic` Kernel Modules](#enable-both-vfio_pci-and-uio_pci_generic-kernel-modules) @@ -212,14 +212,18 @@ Longhorn v1.8.0 and later versions support usage of V2 volumes in Talos Linux cl ## Backup -### Related Custom Resources Might Disappear +### Backup Data On The Remote Backup Server Might Be Deleted -Longhorn will attempt to clean up the backup-related custom resources in the following scenarios: +Longhorn may unintentionally delete backup-related custom resources (such as `BackupVolume`, `BackupBackingImage`, `SystemBackup`, and `Backup`) and backup data on the remote backup server before Longhorn v{{< current-version >}} in the following scenarios: - An empty response from the NFS server due to a brief server downtime. -- A race condition between related Longhorn backup controllers. +- A race condition could delete the remote backup volume and its corresponding backups when the backup target is reset within a short period. + +Starting with v{{< current-version >}}, Longhorn handles backup-related custom resources in the following manner: + +- If there are discrepancies between the backup information in the cluster and on the remote backup server, Longhorn deletes only the backup-related custom resources in the cluster. +- The backup-related custom resources in the cluster may be deleted unintentionally while the remote backup data remains safely stored. The deleted resources are resynchronized from the remote backup server during the next polling period (if the backup target is available). -The backup information will be resynchronized during the next polling interval. For more information, see [#9530](https://github.com/longhorn/longhorn/issues/9530). ## V2 Data Engine