diff --git a/docs/upgrade/v1-6-x-to-v1-7-x.md b/docs/upgrade/v1-6-x-to-v1-7-x.md index a5a664c54b..fd731f2651 100644 --- a/docs/upgrade/v1-6-x-to-v1-7-x.md +++ b/docs/upgrade/v1-6-x-to-v1-7-x.md @@ -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" @@ -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) \ No newline at end of file +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) diff --git a/versioned_docs/version-v1.7/upgrade/v1-6-x-to-v1-7-x.md b/versioned_docs/version-v1.7/upgrade/v1-6-x-to-v1-7-x.md index a5a664c54b..fd731f2651 100644 --- a/versioned_docs/version-v1.7/upgrade/v1-6-x-to-v1-7-x.md +++ b/versioned_docs/version-v1.7/upgrade/v1-6-x-to-v1-7-x.md @@ -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" @@ -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) \ No newline at end of file +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)