Skip to content

Commit

Permalink
docs(backup): remote backup data might be deleted
Browse files Browse the repository at this point in the history
ref: longhorn/longhorn 9530

Signed-off-by: James Lu <james.lu@suse.com>
  • Loading branch information
mantissahz authored and derekbit committed Oct 17, 2024
1 parent 13de839 commit 38b86f5
Show file tree
Hide file tree
Showing 3 changed files with 27 additions and 15 deletions.
14 changes: 9 additions & 5 deletions content/docs/1.6.4/deploy/important-notes/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)
Expand Down Expand Up @@ -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
Expand Down
14 changes: 9 additions & 5 deletions content/docs/1.7.2/important-notes/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)
Expand Down Expand Up @@ -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
Expand Down
14 changes: 9 additions & 5 deletions content/docs/1.8.0/important-notes/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)
Expand Down Expand Up @@ -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
Expand Down

0 comments on commit 38b86f5

Please sign in to comment.