Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 31 additions & 1 deletion docs/upgrade/v1-6-x-to-v1-7-x.md
Original file line number Diff line number Diff line change
Expand Up @@ -139,6 +139,8 @@ You must perform the steps for each affected node _after_ the upgrade is complet

The DHCP server should return the original IP address and the affected node should be able to join the cluster.

Propagation of the DHCP client ID from wicked to NetworkManager occurs automatially when upgrading from Harvester v1.6.x to v1.7.1. The above manual procedure should only be potentially necessary when upgrading to Harvester v1.7.0.

Related issues: [#9260](https://github.com/harvester/harvester/issues/9260) and [#3418](https://github.com/harvester/harvester/issues/3418)

### 2. Upgrade Is Stuck in "Upgrading System Service"
Expand Down Expand Up @@ -189,4 +191,32 @@ Check the Helm history to determine the cause and related workaround.
6 Mon Dec 8 10:56:42 2025 deployed fleet-108.0.0+up0.14.0-rc.1 0.14.0-rc.1 Upgrade complete
```

Related issues: [#9738](https://github.com/harvester/harvester/issues/9738) and [#9680](https://github.com/harvester/harvester/issues/9680)
Related issues: [#9738](https://github.com/harvester/harvester/issues/9738) and [#9680](https://github.com/harvester/harvester/issues/9680)

### 3. Persistent names of certain network interfaces may change during upgrade

Harvester v1.7.x includes newer versions of the Linux kernel's `i40e` and `ice` network drivers than were included in Harvester v1.6.x. These newer network drivers result in the addition of a port number to the name of certain Intel network interfaces, notably the X710. For example, what was `enp6s0f0` on Harvester v1.6.x may become `enp6s0f0np0` during upgrade to Harvester v1.7.0. If this happens it will break networking on the host as the network configuration will continue to use the original interface names.

This issue can be addressed by adding kernel arguments to rename the affected interfaces back to their original names.

1. Get the current `third_party_kernel_args` on the node:

```
$ grub2-editenv /oem/grubenv list
third_party_kernel_args=multipath=off
```

2. Add `ifname=nicName:macAddress` for each network interface on the node to rename them back to their original names. For example:

```
$ grub2-editenv /oem/grubenv set \
third_party_kernel_args="multipath=off ifname=enp6s0f0:d4:c9:ef:ce:30:68 ifname=enp6s0f1:d4:c9:ef:ce:30:69"
```

Be sure to include the current `third_party_kernel_args` when adding the additional `ifname=` arguments.

3. Reboot the node.

Manual application of this solution is only necessary when upgrading to Harvester v1.7.0. The relevant `ifname=` arguments are added automatically during upgrade to Harvester v1.7.1 to avoid this problem potentially recurring in future if other kernel network drivers are updated in a similar fashion.

Related issues: [#9815](https://github.com/harvester/harvester/issues/9815) and [#9802](https://github.com/harvester/harvester/issues/9802)
32 changes: 31 additions & 1 deletion versioned_docs/version-v1.7/upgrade/v1-6-x-to-v1-7-x.md
Original file line number Diff line number Diff line change
Expand Up @@ -139,6 +139,8 @@ You must perform the steps for each affected node _after_ the upgrade is complet

The DHCP server should return the original IP address and the affected node should be able to join the cluster.

Propagation of the DHCP client ID from wicked to NetworkManager occurs automatially when upgrading from Harvester v1.6.x to v1.7.1. The above manual procedure should only be potentially necessary when upgrading to Harvester v1.7.0.

Related issues: [#9260](https://github.com/harvester/harvester/issues/9260) and [#3418](https://github.com/harvester/harvester/issues/3418)

### 2. Upgrade Is Stuck in "Upgrading System Service"
Expand Down Expand Up @@ -189,4 +191,32 @@ Check the Helm history to determine the cause and related workaround.
6 Mon Dec 8 10:56:42 2025 deployed fleet-108.0.0+up0.14.0-rc.1 0.14.0-rc.1 Upgrade complete
```

Related issues: [#9738](https://github.com/harvester/harvester/issues/9738) and [#9680](https://github.com/harvester/harvester/issues/9680)
Related issues: [#9738](https://github.com/harvester/harvester/issues/9738) and [#9680](https://github.com/harvester/harvester/issues/9680)

### 3. Persistent names of certain network interfaces may change during upgrade

Harvester v1.7.x includes newer versions of the Linux kernel's `i40e` and `ice` network drivers than were included in Harvester v1.6.x. These newer network drivers result in the addition of a port number to the name of certain Intel network interfaces, notably the X710. For example, what was `enp6s0f0` on Harvester v1.6.x may become `enp6s0f0np0` during upgrade to Harvester v1.7.0. If this happens it will break networking on the host as the network configuration will continue to use the original interface names.

This issue can be addressed by adding kernel arguments to rename the affected interfaces back to their original names.

1. Get the current `third_party_kernel_args` on the node:

```
$ grub2-editenv /oem/grubenv list
third_party_kernel_args=multipath=off
```

2. Add `ifname=nicName:macAddress` for each network interface on the node to rename them back to their original names. For example:

```
$ grub2-editenv /oem/grubenv set \
third_party_kernel_args="multipath=off ifname=enp6s0f0:d4:c9:ef:ce:30:68 ifname=enp6s0f1:d4:c9:ef:ce:30:69"
```

Be sure to include the current `third_party_kernel_args` when adding the additional `ifname=` arguments.

3. Reboot the node.

Manual application of this solution is only necessary when upgrading to Harvester v1.7.0. The relevant `ifname=` arguments are added automatically during upgrade to Harvester v1.7.1 to avoid this problem potentially recurring in future if other kernel network drivers are updated in a similar fashion.

Related issues: [#9815](https://github.com/harvester/harvester/issues/9815) and [#9802](https://github.com/harvester/harvester/issues/9802)