Skip to content

Commit 8fca7a9

Browse files
bk201Vicente-Cheng
bk201
and
Vicente-Cheng
authored
Add v1.2.1 upgrade docs (#470)
Signed-off-by: Kiefer Chang <[email protected]> Co-authored-by: freeze <[email protected]>
1 parent f609d36 commit 8fca7a9

File tree

14 files changed

+129
-17
lines changed

14 files changed

+129
-17
lines changed

‎docs/upgrade/automatic.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ The following table shows the upgrade path of all supported versions.
2222

2323
| Upgrade from version | Supported new version(s) |
2424
|----------------------|--------------------------|
25-
| [v1.1.2](./v1-1-2-to-v1-2-0.md) | v1.2.0 |
25+
| [v1.1.2/v1.2.0](./v1-2-0-to-v1-2-1.md) | v1.2.1 |
2626
| [v1.1.0, v1.1.1](./v1-1-to-v1-1-2.md) | v1.1.2 |
2727
| [v1.0.3](./v1-0-3-to-v1-1-1.md) | v1.1.0, v1.1.1 (v1.1.1 is recommended) |
2828
| [v1.0.2](./previous-releases/v1-0-2-to-v1-0-3.md) | v1.0.3 |

‎docs/upgrade/previous-releases/_category_.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
11
{
2-
"position": 5,
2+
"position": 6,
33
"label": "Previous Releases"
44
}

‎docs/upgrade/troubleshooting.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
sidebar_position: 6
2+
sidebar_position: 7
33
sidebar_label: Troubleshooting
44
title: "Troubleshooting"
55
---

‎docs/upgrade/v1-0-3-to-v1-1-1.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
sidebar_position: 4
2+
sidebar_position: 5
33
sidebar_label: Upgrade from v1.0.3/v1.1.0 to v1.1.1
44
title: "Upgrade from v1.0.3/v1.1.0 to v1.1.1"
55
---

‎docs/upgrade/v1-1-2-to-v1-2-0.md‎

Lines changed: 24 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,22 @@
11
---
2-
sidebar_position: 2
3-
sidebar_label: Upgrade from v1.1.2 to v1.2.0
4-
title: "Upgrade from v1.1.2 to v1.2.0"
2+
sidebar_position: 3
3+
sidebar_label: Upgrade from v1.1.2 to v1.2.0 (not recommended)
4+
title: "Upgrade from v1.1.2 to v1.2.0 (not recommended)"
55
---
66

77
<head>
88
<link rel="canonical" href="https://docs.harvesterhci.io/v1.2/upgrade/v1-1-2-to-v1-2-0"/>
99
</head>
1010

11+
:::caution
12+
13+
Due to the known issues found v1.2.0:
14+
- [An Upgrade is stuck in the Post-draining state](#9-an-upgrade-is-stuck-in-the-post-draining-state)
15+
- [An upgrade is stuck in the Upgrading System Service state due to the customer provided SSL certificate without IP SAN error in fleet-agent](#10-an-upgrade-is-stuck-in-the-upgrading-system-service-state-due-to-the-customer-provided-ssl-certificate-without-ip-san-error-in-fleet-agent)
16+
17+
We don't recommend upgrading to v1.2.0. Please upgrade your v1.1.x cluster to v1.2.1.
18+
:::
19+
1120

1221
## General information
1322

@@ -410,6 +419,12 @@ Harvester does not package the `registry.suse.com/harvester-beta/vmdp:latest` im
410419
411420
### 9. An Upgrade is stuck in the Post-draining state
412421
422+
:::note
423+
424+
This known issue is fixed in v1.2.1.
425+
426+
:::
427+
413428
The node might be stuck in the OS upgrade process if you encounter the **Post-draining** state, as shown below.
414429
415430
![](/img/v1.2/upgrade/known_issues/stuck-in-post-draining.png)
@@ -489,6 +504,12 @@ After performing the steps above, you should pass post-draining with the next re
489504

490505
### 10. An upgrade is stuck in the Upgrading System Service state due to the `customer provided SSL certificate without IP SAN` error in `fleet-agent`
491506

507+
:::note
508+
509+
This known issue is fixed in v1.2.1.
510+
511+
:::
512+
492513
If an upgrade is stuck in an **Upgrading System Service** state for an extended period, follow these steps to investigate this issue:
493514

494515
1. Find the pods related to the upgrade:

‎docs/upgrade/v1-1-to-v1-1-2.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
sidebar_position: 3
2+
sidebar_position: 4
33
sidebar_label: Upgrade from v1.1.0/v1.1.1 to v1.1.2
44
title: "Upgrade from v1.1.0/v1.1.1 to v1.1.2"
55
---

‎docs/upgrade/v1-2-0-to-v1-2-1.md‎

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
---
2+
sidebar_position: 2
3+
sidebar_label: Upgrade from v1.1.2/v1.2.0 to v1.2.1
4+
title: "Upgrade from v1.1.2/v1.2.0 to v1.2.1"
5+
---
6+
7+
<head>
8+
<link rel="canonical" href="https://docs.harvesterhci.io/v1.2/upgrade/v1-2-0-to-v1-2-1"/>
9+
</head>
10+
11+
12+
## Important changes to this version
13+
14+
Harvester `v1.2.1` fixes upgrade known issues found in `v1.2.0`, we suggest upgrading `v1.1.2` and `v1.2.0` clusters to `v1.2.1`. The known issues found in `v1.2.0` are:
15+
- [An Upgrade is stuck in the Post-draining state](./v1-1-2-to-v1-2-0.md#9-an-upgrade-is-stuck-in-the-post-draining-state)
16+
- [An upgrade is stuck in the Upgrading System Service state due to the customer provided SSL certificate without IP SAN error in fleet-agent](./v1-1-2-to-v1-2-0.md#10-an-upgrade-is-stuck-in-the-upgrading-system-service-state-due-to-the-customer-provided-ssl-certificate-without-ip-san-error-in-fleet-agent)
17+
18+
19+
For clusters already upgraded to v1.2.0, please refer to the [release note](https://github.com/harvester/harvester/releases/tag/v1.2.1) for new changes.
20+
21+
## General information
22+
23+
:::tip
24+
25+
Before you start an upgrade, you can run the pre-check script to make sure the cluster is in a stable state. For more details, please visit this [URL](https://github.com/harvester/upgrade-helpers/tree/main/pre-check/v1.1.x) for the script.
26+
:::
27+
28+
Once there is an upgradable version, the Harvester GUI Dashboard page will show an upgrade button. For more details, please refer to [start an upgrade](./automatic.md#start-an-upgrade).
29+
30+
For the air-gap env upgrade, please refer to [prepare an air-gapped upgrade](./automatic.md#prepare-an-air-gapped-upgrade).
31+
32+
33+
## Known issues
34+
35+
Please check v1.2.0 [known issues](./v1-1-2-to-v1-2-0.md#known-issues).

‎versioned_docs/version-v1.2/upgrade/automatic.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ The following table shows the upgrade path of all supported versions.
2222

2323
| Upgrade from version | Supported new version(s) |
2424
|----------------------|--------------------------|
25-
| [v1.1.2](./v1-1-2-to-v1-2-0.md) | v1.2.0 |
25+
| [v1.1.2/v1.2.0](./v1-2-0-to-v1-2-1.md) | v1.2.1 |
2626
| [v1.1.0, v1.1.1](./v1-1-to-v1-1-2.md) | v1.1.2 |
2727
| [v1.0.3](./v1-0-3-to-v1-1-1.md) | v1.1.0, v1.1.1 (v1.1.1 is recommended) |
2828
| [v1.0.2](./previous-releases/v1-0-2-to-v1-0-3.md) | v1.0.3 |

‎versioned_docs/version-v1.2/upgrade/previous-releases/_category_.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
11
{
2-
"position": 5,
2+
"position": 6,
33
"label": "Previous Releases"
44
}

‎versioned_docs/version-v1.2/upgrade/troubleshooting.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
sidebar_position: 6
2+
sidebar_position: 7
33
sidebar_label: Troubleshooting
44
title: "Troubleshooting"
55
---

0 commit comments

Comments
 (0)