From 422b5cd05e21a8ebefe2d758ead0185131f09e01 Mon Sep 17 00:00:00 2001 From: Derek Su Date: Wed, 21 Aug 2024 21:15:53 +0800 Subject: [PATCH] docs(1.7.0): add PSA for issue 9267 Signed-off-by: Derek Su --- content/docs/1.7.0/important-notes/_index.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/content/docs/1.7.0/important-notes/_index.md b/content/docs/1.7.0/important-notes/_index.md index d5a9a83aa..b11f4278d 100644 --- a/content/docs/1.7.0/important-notes/_index.md +++ b/content/docs/1.7.0/important-notes/_index.md @@ -6,6 +6,8 @@ weight: 1 This page lists important notes for Longhorn v{{< current-version >}}. Please see [here](https://github.com/longhorn/longhorn/releases/tag/v{{< current-version >}}) for the full release note. +- [Warning](#warning) + - [Unable to Attach Volumes Created Before v1.5.2 and v1.4.4](#unable-to-attach-volumes-created-before-v152-and-v144) - [Deprecation](#deprecation) - [Environment Check Script](#environment-check-script) - [General](#general) @@ -35,6 +37,23 @@ Please see [here](https://github.com/longhorn/longhorn/releases/tag/v{{< current - [Snapshot Creation Time As Shown in the UI Occasionally Changes](#snapshot-creation-time-as-shown-in-the-ui-occasionally-changes) - [Unable To Revert a Volume to a Snapshot Created Before Longhorn v1.7.0](#unable-to-revert-a-volume-to-a-snapshot-created-before-longhorn-v170) +## Warning + +### Unable to Attach Volumes Created Before v1.5.2 and v1.4.4 + +The Longhorn team has identified [a critical issue](https://github.com/longhorn/longhorn/issues/9267) that affects volume attachment in Longhorn v1.7.0. A fix for this issue will be included in v1.7.1, which is in active development. + +Avoid upgrading to v1.7.0 if your Longhorn cluster contains `engine` resources with the following characteristics: + +- Resource name: The format is `-e-<8-char random id>`. +- Time of creation: A Longhorn version earlier than v1.5.2 and v1.4.4 was installed on the cluster. + +Run the following command to check if you can safely upgrade your Longhorn cluster to v1.7.0: + +> ``` +> [ $(kubectl -n longhorn-system get engines.longhorn.io -o name | grep -E '\-e\-[a-z0-9]{8}$' | wc -l) -gt 0 ] && echo "Please hold off on upgrading to v1.7.0 until v1.7.1 is available." || echo "Safe to upgrade to v1.7.0." +> ``` + ## Deprecation ### Environment Check Script