From 1e6150f1b382afec94659095bb613d08d1a9b14d Mon Sep 17 00:00:00 2001 From: Tim Serong Date: Thu, 6 Nov 2025 16:42:04 +1100 Subject: [PATCH] Add Upgrade from v1.6.x to v1.7.x page Related-to: https://github.com/harvester/harvester/issues/9422 Signed-off-by: Tim Serong --- docs/upgrade/automatic.md | 13 ++++++------ docs/upgrade/troubleshooting.md | 2 +- docs/upgrade/v1-1-2-to-v1-2-0.md | 2 +- docs/upgrade/v1-2-0-to-v1-2-1.md | 2 +- docs/upgrade/v1-2-1-to-v1-2-2.md | 2 +- docs/upgrade/v1-2-2-to-v1-3-1.md | 2 +- docs/upgrade/v1-3-1-to-v1-3-2.md | 2 +- docs/upgrade/v1-3-2-to-v1-4-0.md | 2 +- docs/upgrade/v1-4-0-to-v1-4-1.md | 2 +- docs/upgrade/v1-4-1-to-v1-4-2.md | 2 +- docs/upgrade/v1-4-1-to-v1-4-3.md | 2 +- docs/upgrade/v1-4-2-to-v1-5-0.md | 2 +- docs/upgrade/v1-4-2-to-v1-5-1.md | 2 +- docs/upgrade/v1-4-2-to-v1-5-2.md | 2 +- docs/upgrade/v1-5-0-to-v1-5-1.md | 2 +- docs/upgrade/v1-5-0-to-v1-5-2.md | 2 +- docs/upgrade/v1-5-x-to-v1-6-x.md | 2 +- docs/upgrade/v1-6-x-to-v1-6-y.md | 2 +- docs/upgrade/v1-6-x-to-v1-7-x.md | 35 ++++++++++++++++++++++++++++++++ 19 files changed, 59 insertions(+), 23 deletions(-) create mode 100644 docs/upgrade/v1-6-x-to-v1-7-x.md diff --git a/docs/upgrade/automatic.md b/docs/upgrade/automatic.md index 741eea0c7e..6f0f12375a 100644 --- a/docs/upgrade/automatic.md +++ b/docs/upgrade/automatic.md @@ -34,6 +34,7 @@ The following table outlines the supported upgrade paths. | Installed Version | Supported Upgrade Versions | | --- | --- | +| v1.6.x | [v1.7.x](./v1-6-x-to-v1-7-x.md) | | v1.6.x | [v1.6.y](./v1-6-x-to-v1-6-y.md) (*y* is greater than *x*) | | v1.5.x | [v1.6.x](./v1-5-x-to-v1-6-x.md) | | v1.5.0 | [v1.5.1](./v1-5-0-to-v1-5-1.md) | @@ -54,12 +55,12 @@ The latest Harvester versions allow the following: The following table outlines the components used in these versions: -| Components | Harvester v1.5.x | Harvester v1.6.x | -| --- | --- | --- | -| KubeVirt | v1.4 | v1.5 | -| Longhorn | v1.8 | v1.9 | -| Rancher | v2.11 | v2.12 | -| RKE2 | v1.32 | v1.33 | +| Components | Harvester v1.5.x | Harvester v1.6.x | Harvester v1.7.x | +| --- | --- | --- | --- | +| KubeVirt | v1.4 | v1.5 | v1.6 | +| Longhorn | v1.8 | v1.9 | v1.10 | +| Rancher | v2.11 | v2.12 | v2.13 | +| RKE2 | v1.32 | v1.33 | v1.34 | :::note diff --git a/docs/upgrade/troubleshooting.md b/docs/upgrade/troubleshooting.md index 6b811ab77f..bb7baaeced 100644 --- a/docs/upgrade/troubleshooting.md +++ b/docs/upgrade/troubleshooting.md @@ -1,5 +1,5 @@ --- -sidebar_position: 18 +sidebar_position: 19 sidebar_label: Troubleshooting title: "Troubleshooting" --- diff --git a/docs/upgrade/v1-1-2-to-v1-2-0.md b/docs/upgrade/v1-1-2-to-v1-2-0.md index 166c894997..cc946a3ffb 100644 --- a/docs/upgrade/v1-1-2-to-v1-2-0.md +++ b/docs/upgrade/v1-1-2-to-v1-2-0.md @@ -1,5 +1,5 @@ --- -sidebar_position: 17 +sidebar_position: 18 sidebar_label: Upgrade from v1.1.2 to v1.2.0 (not recommended) title: "Upgrade from v1.1.2 to v1.2.0 (not recommended)" --- diff --git a/docs/upgrade/v1-2-0-to-v1-2-1.md b/docs/upgrade/v1-2-0-to-v1-2-1.md index 3698e53aff..2de6c942fd 100644 --- a/docs/upgrade/v1-2-0-to-v1-2-1.md +++ b/docs/upgrade/v1-2-0-to-v1-2-1.md @@ -1,5 +1,5 @@ --- -sidebar_position: 16 +sidebar_position: 17 sidebar_label: Upgrade from v1.1.2/v1.1.3/v1.2.0 to v1.2.1 title: "Upgrade from v1.1.2/v1.1.3/v1.2.0 to v1.2.1" --- diff --git a/docs/upgrade/v1-2-1-to-v1-2-2.md b/docs/upgrade/v1-2-1-to-v1-2-2.md index 803f8fdcec..ef476a917c 100644 --- a/docs/upgrade/v1-2-1-to-v1-2-2.md +++ b/docs/upgrade/v1-2-1-to-v1-2-2.md @@ -1,5 +1,5 @@ --- -sidebar_position: 15 +sidebar_position: 16 sidebar_label: Upgrade from v1.2.1 to v1.2.2 title: "Upgrade from v1.2.1 to v1.2.2" --- diff --git a/docs/upgrade/v1-2-2-to-v1-3-1.md b/docs/upgrade/v1-2-2-to-v1-3-1.md index 7f5ee5e5a5..327532c553 100644 --- a/docs/upgrade/v1-2-2-to-v1-3-1.md +++ b/docs/upgrade/v1-2-2-to-v1-3-1.md @@ -1,5 +1,5 @@ --- -sidebar_position: 14 +sidebar_position: 15 sidebar_label: Upgrade from v1.2.2/v1.3.0 to v1.3.1 title: "Upgrade from v1.2.2/v1.3.0 to v1.3.1" --- diff --git a/docs/upgrade/v1-3-1-to-v1-3-2.md b/docs/upgrade/v1-3-1-to-v1-3-2.md index 1f7cfd9479..4cd1281c57 100644 --- a/docs/upgrade/v1-3-1-to-v1-3-2.md +++ b/docs/upgrade/v1-3-1-to-v1-3-2.md @@ -1,5 +1,5 @@ --- -sidebar_position: 13 +sidebar_position: 14 sidebar_label: Upgrade from v1.3.1 to v1.3.2 title: "Upgrade from v1.3.1 to v1.3.2" --- diff --git a/docs/upgrade/v1-3-2-to-v1-4-0.md b/docs/upgrade/v1-3-2-to-v1-4-0.md index c12dc79d51..dba3aff38f 100644 --- a/docs/upgrade/v1-3-2-to-v1-4-0.md +++ b/docs/upgrade/v1-3-2-to-v1-4-0.md @@ -1,5 +1,5 @@ --- -sidebar_position: 12 +sidebar_position: 13 sidebar_label: Upgrade from v1.3.2 to v1.4.0 title: "Upgrade from v1.3.2 to v1.4.0" --- diff --git a/docs/upgrade/v1-4-0-to-v1-4-1.md b/docs/upgrade/v1-4-0-to-v1-4-1.md index ad7d1bfc26..41993236ea 100644 --- a/docs/upgrade/v1-4-0-to-v1-4-1.md +++ b/docs/upgrade/v1-4-0-to-v1-4-1.md @@ -1,5 +1,5 @@ --- -sidebar_position: 11 +sidebar_position: 12 sidebar_label: Upgrade from v1.4.0 to v1.4.1 title: "Upgrade from v1.4.0 to v1.4.1" --- diff --git a/docs/upgrade/v1-4-1-to-v1-4-2.md b/docs/upgrade/v1-4-1-to-v1-4-2.md index 77fc3a8806..5728f5b25d 100644 --- a/docs/upgrade/v1-4-1-to-v1-4-2.md +++ b/docs/upgrade/v1-4-1-to-v1-4-2.md @@ -1,5 +1,5 @@ --- -sidebar_position: 10 +sidebar_position: 11 sidebar_label: Upgrade from v1.4.1 to v1.4.2 title: "Upgrade from v1.4.1 to v1.4.2" --- diff --git a/docs/upgrade/v1-4-1-to-v1-4-3.md b/docs/upgrade/v1-4-1-to-v1-4-3.md index 5aa455cb4c..a47d7d9ad6 100644 --- a/docs/upgrade/v1-4-1-to-v1-4-3.md +++ b/docs/upgrade/v1-4-1-to-v1-4-3.md @@ -1,5 +1,5 @@ --- -sidebar_position: 9 +sidebar_position: 10 sidebar_label: Upgrade from v1.4.1/v1.4.2 to v1.4.3 title: "Upgrade from v1.4.1/v1.4.2 to v1.4.3" --- diff --git a/docs/upgrade/v1-4-2-to-v1-5-0.md b/docs/upgrade/v1-4-2-to-v1-5-0.md index 9c729a8c83..eb3be37853 100644 --- a/docs/upgrade/v1-4-2-to-v1-5-0.md +++ b/docs/upgrade/v1-4-2-to-v1-5-0.md @@ -1,5 +1,5 @@ --- -sidebar_position: 8 +sidebar_position: 9 sidebar_label: Upgrade from v1.4.2/v1.4.3 to v1.5.0 title: "Upgrade from v1.4.2/v1.4.3 to v1.5.0" --- diff --git a/docs/upgrade/v1-4-2-to-v1-5-1.md b/docs/upgrade/v1-4-2-to-v1-5-1.md index df15a0d5e3..f2c5a7985e 100644 --- a/docs/upgrade/v1-4-2-to-v1-5-1.md +++ b/docs/upgrade/v1-4-2-to-v1-5-1.md @@ -1,5 +1,5 @@ --- -sidebar_position: 7 +sidebar_position: 8 sidebar_label: Upgrade from v1.4.2/v1.4.3 to v1.5.1 title: "Upgrade from v1.4.2/v1.4.3 to v1.5.1" --- diff --git a/docs/upgrade/v1-4-2-to-v1-5-2.md b/docs/upgrade/v1-4-2-to-v1-5-2.md index acfcf9b8e5..b0c0148c6c 100644 --- a/docs/upgrade/v1-4-2-to-v1-5-2.md +++ b/docs/upgrade/v1-4-2-to-v1-5-2.md @@ -1,5 +1,5 @@ --- -sidebar_position: 6 +sidebar_position: 7 sidebar_label: Upgrade from v1.4.2/v1.4.3 to v1.5.2 title: "Upgrade from v1.4.2/v1.4.3 to v1.5.2" --- diff --git a/docs/upgrade/v1-5-0-to-v1-5-1.md b/docs/upgrade/v1-5-0-to-v1-5-1.md index 6caa884c24..3449b76fdc 100644 --- a/docs/upgrade/v1-5-0-to-v1-5-1.md +++ b/docs/upgrade/v1-5-0-to-v1-5-1.md @@ -1,5 +1,5 @@ --- -sidebar_position: 5 +sidebar_position: 6 sidebar_label: Upgrade from v1.5.0 to v1.5.1 title: "Upgrade from v1.5.0 to v1.5.1" --- diff --git a/docs/upgrade/v1-5-0-to-v1-5-2.md b/docs/upgrade/v1-5-0-to-v1-5-2.md index 281cf1cdce..8cd8da8781 100644 --- a/docs/upgrade/v1-5-0-to-v1-5-2.md +++ b/docs/upgrade/v1-5-0-to-v1-5-2.md @@ -1,5 +1,5 @@ --- -sidebar_position: 4 +sidebar_position: 5 sidebar_label: Upgrade from v1.5.0/v1.5.1 to v1.5.2 title: "Upgrade from v1.5.0/v1.5.1 to v1.5.2" --- diff --git a/docs/upgrade/v1-5-x-to-v1-6-x.md b/docs/upgrade/v1-5-x-to-v1-6-x.md index 80b178ed20..1f4a6826a4 100644 --- a/docs/upgrade/v1-5-x-to-v1-6-x.md +++ b/docs/upgrade/v1-5-x-to-v1-6-x.md @@ -1,5 +1,5 @@ --- -sidebar_position: 3 +sidebar_position: 4 sidebar_label: Upgrade from v1.5.x to v1.6.x title: "Upgrade from v1.5.x to v1.6.x" --- diff --git a/docs/upgrade/v1-6-x-to-v1-6-y.md b/docs/upgrade/v1-6-x-to-v1-6-y.md index 1084b8ca05..6f71edf9e8 100644 --- a/docs/upgrade/v1-6-x-to-v1-6-y.md +++ b/docs/upgrade/v1-6-x-to-v1-6-y.md @@ -1,5 +1,5 @@ --- -sidebar_position: 2 +sidebar_position: 3 sidebar_label: Upgrade from v1.6.x to v1.6.y title: "Upgrade from v1.6.x to v1.6.y" --- diff --git a/docs/upgrade/v1-6-x-to-v1-7-x.md b/docs/upgrade/v1-6-x-to-v1-7-x.md new file mode 100644 index 0000000000..367515a0b4 --- /dev/null +++ b/docs/upgrade/v1-6-x-to-v1-7-x.md @@ -0,0 +1,35 @@ +--- +sidebar_position: 2 +sidebar_label: Upgrade from v1.6.x to v1.7.x +title: "Upgrade from v1.6.x to v1.7.x" +--- + + + + + +## General Information + +An **Upgrade** button appears on the **Dashboard** screen whenever a new Harvester version that you can upgrade to becomes available. For more information, see [Start an upgrade](./automatic.md#start-an-upgrade). + +Clusters running v1.6.x can upgrade to v1.7.x directly because Harvester allows a maximum of one minor version upgrade for underlying components. Harvester v1.6.0 and v1.6.1 use the same minor version of RKE2 (v1.33), while Harvester v1.7.0 and v1.7.1 use the next minor version (v1.34). For more information, see [Upgrade paths](./automatic.md#upgrade-paths). + +For information about upgrading Harvester in air-gapped environments, see [Prepare an air-gapped upgrade](./automatic.md#prepare-an-air-gapped-upgrade). + +### Update Harvester UI Extension on Rancher v2.13 + +You must use a compatible version (v1.7.x) of the Harvester UI Extension to import Harvester v1.7.x clusters on Rancher v2.13. + +1. On the Rancher UI, go to **local > Apps > Repositories**. + +1. Locate the repository named **harvester**, and then select **⋮ > Refresh**. + +1. Go to the **Extensions** screen. + +1. Locate the extension named **Harvester**, and then click **Update**. + +1. Select a compatible version, and then click **Update**. + +1. Allow some time for the extension to be updated, and then refresh the screen. + +---