Harvester v1.3.0 Release Notes

This release introduces several features, enhancements, and bug fixes that improve system quality and the overall user experience. The documentation is available at https://docs.harvesterhci.io/v1.3.

The Harvester team appreciates your contributions and looks forward to receiving feedback regarding this release.

Important Information about Rancher Upgrades

Downloads

AMD64

Full ISO

💿 https://releases.rancher.com/harvester/v1.3.0/harvester-v1.3.0-amd64.iso
📁 https://releases.rancher.com/harvester/v1.3.0/harvester-v1.3.0-vmlinuz-amd64
📁 https://releases.rancher.com/harvester/v1.3.0/harvester-v1.3.0-initrd-amd64
📁 https://releases.rancher.com/harvester/v1.3.0/harvester-v1.3.0-rootfs-amd64.squashfs
✅ https://releases.rancher.com/harvester/v1.3.0/harvester-v1.3.0-amd64.sha512
📝 https://releases.rancher.com/harvester/v1.3.0/version.yaml

Net Install ISO

💿 https://releases.rancher.com/harvester/v1.3.0/harvester-v1.3.0-amd64-net-install.iso
📝 https://docs.harvesterhci.io/v1.3/install/net-install/

ARM64 (Technical Preview)

💿 https://releases.rancher.com/harvester/v1.3.0/harvester-v1.3.0-arm64.iso
📁 https://releases.rancher.com/harvester/v1.3.0/harvester-v1.3.0-vmlinuz-arm64
📁 https://releases.rancher.com/harvester/v1.3.0/harvester-v1.3.0-initrd-arm64
📁 https://releases.rancher.com/harvester/v1.3.0/harvester-v1.3.0-rootfs-arm64.squashfs
✅ https://releases.rancher.com/harvester/v1.3.0/harvester-v1.3.0-arm64.sha512
📝 https://releases.rancher.com/harvester/v1.3.0/version-arm64.yaml

Installation

Harvester can be installed using the ISO image, a bootable USB drive, and PXE boot. A net install ISO image, which contains only the core OS components, is also now available. For more information, see the Installation section of the documentation.

Upgrade

Harvester only allows upgrades from supported versions. For more information about upgrade paths and procedures, see Upgrading Harvester.

Highlights

vGPU Support

Starting with Harvester v1.3.0, you can use GPU cards that support the creation of virtual GPUs (vGPUs). In Kubernetes, a vGPU is a type of mediated device that allows multiple VMs to share the compute capability of a physical GPU. You can assign a vGPU to one or more VMs created by Harvester.

Two-Node Clusters with a Witness node for High Availability

Harvester v1.3.0 supports two-node clusters (with a witness node) for implementations that require high availability but without the footprint and resources associated with larger deployments. You can deploy either a two-node cluster with high availability, or a cluster with two management nodes and one witness node, which functions as an etcd node.

Optimization for Frequent Device Power-Off/Power-On

Harvester v1.3.0 is optimized for environments wherein devices are frequently powered off and on, possibly because of intermittent power outages, recurring device relocation, and other reasons. In such environments, clusters or individual nodes are abruptly stopped and restarted, causing VMs to fail to start and become unresponsive. This release addresses the general issue and reduces the burden on cluster operators who may not possess the necessary troubleshooting skills.

Managed DHCP (Experimental Add-on)

Harvester v1.3.0 allows you to configure IP pool information and serve IP addresses to VMs running on Harvester clusters using the embedded Managed DHCP feature. Managed DHCP, which is an alternative to the standalone DHCP server, leverages the vm-dhcp-controller add-on to simplify cluster deployment. The vm-dhcp-controller add-on reconciles CRD objects and syncs the IP pool objects that serve DHCP requests.

ARM Support (Technical Preview)

You can install Harvester v1.3.0 on servers using ARM architecture. This is made possible by recent updates to KubeVirt and RKE2, key components of Harvester that now both support ARM64.

Fleet Management (Technical Preview)

Starting with v1.3.0, you can use Fleet to deploy and manage objects (such as VM images and node settings) in Harvester clusters. Support for Fleet is enabled by default and does not require Rancher integration, but you can use Fleet to explore Harvester clusters imported into Rancher.

Enhancements

• Add a field keep mac address to vmrestore page #5205
• Monitoring, Logging upgrade in v1.3.0 #5003
• Node disk manager should respawn the udev monitor if any errors #4925
• Support bundle resource clean up #4922
• Take advantage of the attach/detach mechanism in Longhorn v1.5+ #4907
• Manually configure Harvester roles for hosts #4786
• add libnvme, nvme-cli to harvester OS #4745
• Kubernetes-native Elemental CloudInit objects #4712 #4712
• Create a webhook for CloudInit CRDs to protect system files under /oem #4710
• support command sensors by default #4681
• Add webhook for CRD virtualmachinetemplateversion.harvesterhci.io #4625
• Check free disk space percent before upgrade #4611
• Be able to join new nodes to clusters with a custom certificate configured #4603
• Allow wiping of partitions during ISO and PXE install #4527
• Config sftp dynamically #4480
• Add some checking mechanism for the single replica volume #4467
• Auto-cleanup container images that are no longer used by the Harvester system services after upgrades #4425
• Make it possible for guest cluster Harvester VMs to have different hostnames than their Harvester VM names when using harvester-csi-driver #4396
• Required fields are not checked when saving (via yaml save) #4350
• Publish net-install ISO #4295
• Need a detailed progress and estimation for backup (maybe also restore) of VMs and volumes #4102
• You can now configure data locality settings in StorageClasses. #4101
• Upgrade: enhance live-migration detection in the pre-drain phase #3019
• NDM support labeling disks #2717
• The installer automatically checks the hardware and displays warning messages if the minimum requirements are not met. #1154

Bug Fixes

• Failed to upgrade 4 nodes from v1.1.2 to v1.2.0-rc4, stuck in post-draining on the third node #4285
• Node pool anti-affinity rules are not working as expected #4588
• The installer occasionally doesn't run #4648
• Harvester v1.2.1 stuck on boot with BOSS-S1 hardware RAID #4784
• Switch harvester UI to use rancher user id as backup when local username is empty during PCIDeviceClaim creation #4796
• Download backing image failed with HTTP 502 error if Storage Network configured #4807
• VMRestore to new VM doesn't work if there is VMSnapshot #4954
• The apply-manifests job in a previous upgrade updates the SystemServicesUpgraded condition of the current upgrade 5090
• Can't Enable SR-IOV GPU in UI 5112
• Grafana link returns 404 #5217
• After EjectCD from vm and edit config of vm displays empty page: "Cannot read properties of null" #5264
• Backup restore does not carry the same MAC address #3541
• After deleting the only VM of LB, LB controller reports following error #5137
• Improve Image Download Handling #5044
• Upgrade was stuck indefinitely in the "upgrade system services" phase due to fleet-agent unsuccessful registration #5023
• The GUI should display errors when VM image upload fails #5014
• VM state "Stopping" is ambiguous when starting VM which has affinity rule that can't be fulfilled #4982
• UI does not manage many resourceQuotas correctly #4981
• Provision stuck at Updating for Harvester Cloud Provider RKE2 Cluster with hostname cloud-config User Data #4947
• Harvester Prevents From Configuring Storage Network Even There in no Running VM and Online Volumes #4886
• A user can't run terraform init after using harvester terraformer to import resources #4859
• generate_addon_csi.sh fails to complete on windows #4848
• rancher-system-agent keeps showing rke2 etcd-snapshot error log #4803
• Resizing Extra Volumes Fail if VM was shutdown via SSH sudo shutdown -h now (w/ 422: admission webhook denied the request: please stop the VM before resizing volumes) #4778
• Grafana (Addon: rancher-monitoring) sign in is not working in Harvester 1.2.1 #4756
• Can't use data disk measured in terabytes v1.2.1 #4734
• Upgrade 1.2.0 -> 1.2.1 is stuck in “Waiting for VM live-migration or shutdown...(1 left)” even though there is NO VM running #4725
• Unable to successfully create LoadBalancer service from Guest cluster post 1.2.1 upgrade #4678
• VM got IO error after host restart #4633
• VMBackup metadata file name conflicts #4612
• Restore from snapshot not work if target VM is restore-replaced from backup #4604
• Sending ctrl-alt-delete does not have any reaction on a windows VM #4535
• Unable to use image that has a name more than ~40 characters long created through terraform #4520
• storage parameters of cloned vmimage cannot be changed #4506
• Duplicated WWN blockdevice #4494
• Longhorn Instance Manager Memory leak #4431
• Can't upload a 6GB image to Harvester when in multi-cluster context, the Rancher has limitation #4311
• VM stuck in Restoring state #4307
• Unable to assign CPU or Memory to a new VM when using up/down arrows. #4179
• when switching users in rancher and opening Harvester you get an error #4162
• When we use project_member user access Harvester it display page not be found on Rancher v2.7.2 #3895
• Migrating (or simply stopping) VMs with LVM volumes causes Buffer I/O errors in kernel log of source host #3843
• User can delete the volume which is exporting image #3758

Known Issues

• After upgrade Rancher v2.7.11 to 2.8.2, RKE2 cluster shows a redundant node and stuck at deleting. #5347
• The witness node should not be selected as a migration target #5338
• You can disable vGPUs when they are in use #5293
• Single Node Cluster Fails To Have VMs Come Back Post Restart w/ Storage Network Configured #5109
• The rancher-monitoring Pod stuck at terminating status when upgrading from v1.1.2 to v1.2.0-rc6 #4484
• Re-sync topology error: nodes not found in cloud-provider #4459
• Fail to scale down RKE2 Harvester node driver cluster #4358
• Failed to pass guest cluster name into Harvester cloud provider #4232
• Unable to access Node IP addresses over HTTPS on VM router in Harvester cluster v1.1.1 #3960
• Unable to select Harvester Cloud Provider in Rancher v2.7.x #3750
• Upgrade from v1.0.3 to v1.1.1-rc1, Harvester cluster stuck in pre-draining the second node #3164
• Upgrade stuck in upgrading first node: Job was active longer than specified deadline #2894

Component Versions

Contributors

Thank you to all the contributors that made this release possible.

@albinsun @asettle @bk201 @brandboat @connorkuehl @DaiYuzeng @futuretea @FrankYang0529 @ibrokethecloud @irishgordo @jaevans @jeff-radick-suse @jillian-maroket @joeyloman @khushboo-rancher @lanfon72 @LucasSaintarbor @m-ildefons @mantis-toboggan-md @markhillgit @mingshuoqiu @mortenn @noahgildersleeve @petiepooo @rebeccazzzz @stalin4suse @starbops @TachunLin @tserong @torchiaf @ulikl @Vicente-Cheng @votdev @w13915984028 @WebberHuang1118 @yasker @Yu-Jack