Skip to content

Commit dacf172

Browse files
Apply suggestions from code review
Co-authored-by: Daria Vladykina <[email protected]> Signed-off-by: Tim Serong <[email protected]>
1 parent 7da1823 commit dacf172

File tree

1 file changed

+6
-6
lines changed

1 file changed

+6
-6
lines changed

docs/upgrade/v1-6-x-to-v1-7-x.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ Clusters running v1.6.x can upgrade to v1.7.x directly because Harvester allows
1717
For information about upgrading Harvester in air-gapped environments, see [Prepare an air-gapped upgrade](./automatic.md#prepare-an-air-gapped-upgrade).
1818

1919
:::info important
20-
If you are using DHCP to configure your host IP addresses, it's possible the IP addresses may change during upgrade, which will prevent the cluster from starting correctly. This requires manual intervention to remedy. For full details see [Host IP address may change during upgrade when using DHCP](#1-host-ip-address-may-change-during-upgrade-when-using-dhcp).
20+
If you are using DHCP to configure your host IP addresses, the IP addresses may change during upgrade, which will prevent the cluster from starting correctly. This requires manual intervention to remedy. For full details, see [Host IP address may change during upgrade when using DHCP](#1-host-ip-address-may-change-during-upgrade-when-using-dhcp).
2121

2222
:::
2323

@@ -35,22 +35,22 @@ You must use a compatible version (v1.7.x) of the Harvester UI Extension to impo
3535

3636
1. Select a compatible version, and then click **Update**.
3737

38-
1. Allow some time for the extension to be updated, and then refresh the screen.
38+
1. Allow some time for the extension to be updated and then refresh the screen.
3939

4040
---
4141

4242
## Known Issues
4343

4444
### 1. Host IP address may change during upgrade when using DHCP
4545

46-
Harvester v1.7.x uses NetworkManager instead of Wicked as was used in earlier versions of Harvester. These two network stacks have different defaults for generating DHCP client IDs. This means that if you are using DHCP to configure your host IP addresses, after the operating system on each host is upgraded and the host rebooted, your DHCP server may return a different IP address for that host than it did before. If this happens, the host in question will be unable to join the cluster on startup because its IP address has changed.
46+
Harvester v1.7.x uses NetworkManager instead of wicked, which was used in earlier versions of Harvester. These two network stacks have different defaults for generating DHCP client IDs. This means that if you are using DHCP to configure your host IP addresses, after the operating system on each host is upgraded and the host rebooted, your DHCP server may return a different IP address for that host than it did before. If this happens, the host in question will be unable to join the cluster on startup because its IP address has changed.
4747

48-
This problem will not occur if your DHCP server is configured to allocate fixed IP addresses based on MAC address, as is done in [Harvester iPXE Examples](https://github.com/harvester/ipxe-examples). It will occur however if the DHCP server is allocating IP addresses based solely on DHCP client ID.
48+
This problem will not occur if your DHCP server is configured to allocate fixed IP addresses based on MAC address, as is done in [Harvester iPXE Examples](https://github.com/harvester/ipxe-examples). However, it will occur if the DHCP server is allocating IP addresses based solely on DHCP client ID.
4949

50-
For single node Harvester deployments that have this issue, Harvester simply will not start after rebooting after the upgrade, because the IP address is changed. For multi node deployments you may find management nodes are stuck "Waiting Reboot". In both cases, to address this issue, perform the following steps _after_ each node is upgraded and its IP address has changed:
50+
For single-node Harvester deployments that have this issue, Harvester simply will not start after rebooting after the upgrade, because the IP address is changed. For multi-node deployments, you may find management nodes are stuck "Waiting Reboot". In both cases, to address this issue, perform the following steps _after_ each node is upgraded and its IP address has changed:
5151

5252
1. Log in to the affected node, either via `ssh` to its new IP address, or by using the console.
53-
1. Check for lease XML file in the `/var/lib/wicked` directory. It should be named similar to `/var/lib/wicked/lease-mgmt-br-dhcp-ipv4.xml`. If you are using a VLAN, the file name will include the VLAN ID, for example `/var/lib/wicked/lease-mgmt-br.2017-dhcp-ipv4.xml`
53+
1. Check for lease XML file in the `/var/lib/wicked` directory. It should be named similar to `/var/lib/wicked/lease-mgmt-br-dhcp-ipv4.xml`. If you are using a VLAN, the file name will include the VLAN ID, for example, `/var/lib/wicked/lease-mgmt-br.2017-dhcp-ipv4.xml`.
5454
1. View this file to find the DHCP client ID:
5555
```
5656
$ cat /var/lib/wicked/lease-mgmt-br-dhcp-ipv4.xml

0 commit comments

Comments
 (0)