github longhorn/longhorn v1.4.0-rc3
Longhorn v1.4.0-rc3 release

latest releases: v1.5.5, v1.5.5-rc2, v1.5.5-rc1...
pre-release16 months ago

Release Note

DON'T UPGRADE from/to any RC/Preview releases, because the operation is not supported.

v1.4.0-rc3 released! 🎆

This release introduces many enhancements, improvements, and bug fixes as described below about stability, performance, data integrity, troubleshooting, and so on. Please try it and feedback. Thanks for all the contributions!

  • Kubernetes 1.25 Support [doc]
    In the previous versions, Longhorn relies on Pod Security Policy (PSP) to authorize Longhorn components for privileged operations. From Kubernetes 1.25, PSP has been removed and replaced with Pod Security Admission (PSA). Longhorn v1.4.0 supports opt-in PSP enablement, so it can support Kubernetes versions with or without PSP.

  • ARM64 GA
    ARM64 has been experimental from Longhorn v1.1.0. After receiving more user feedback and increasing testing coverage, ARM64 distribution has been stabilized with quality as per our regular regression testing, so it is qualified for general availability.

  • RWX GA [lep][doc]
    RWX has been experimental from Longhorn v1.1.0, but it lacks availability support when the Longhorn Share Manager component behind becomes unavailable. Longhorn v1.4.0 supports NFS recovery backend based on Kubernetes built-in resource, ConfigMap, for recovering NFS client connection during the fail-over period. Also, the NFS client hard mode introduction will further avoid previous potential data loss. For the detail, please check the issue and enhancement proposal.

  • Volume Snapshot Checksum [lep][doc]
    Data integrity is a continuous effort for Longhorn. In this version, Snapshot Checksum has been introduced w/ some settings to allow users to enable or disable checksum calculation with different modes.

  • Volume Bit-rot Protection [lep][doc]
    When enabling the Volume Snapshot Checksum feature, Longhorn will periodically calculate and check the checksums of volume snapshots, find corrupted snapshots, then fix them.

  • Volume Replica Rebuilding Speedup
    When enabling the Volume Snapshot Checksum feature, Longhorn will use the calculated snapshot checksum to avoid needless snapshot replication between nodes for improving replica rebuilding speed and resource consumption.

  • Volume Trim [lep][doc]
    Longhorn engine supports UNMAP SCSI command to reclaim space from the block volume.

  • Online Volume Expansion
    Longhorn engine supports optional parameters to pass size expansion requests when updating the volume frontend to support online volume expansion and resize the filesystem via CSI node driver.

  • Local Volume via Data Locality Strict Mode [lep][doc]
    Local volume is based on a new Data Locality setting, Strict Local. It will allow users to create one replica volume staying in a consistent location, and the data transfer between the volume frontend and engine will be through a local socket instead of the TCP stack to improve performance and reduce resource consumption.

  • Volume Recurring Job Backup Restore [lep][doc]
    Recurring jobs binding to a volume can be backed up to the remote backup target together with the volume backup metadata. They can be restored back as well for a better operation experience.

  • Volume IO Metrics [doc]
    Longhorn enriches Volume metrics by providing real-time IO stats including IOPS, latency, and throughput of R/W IO. Users can set up a monotoning solution like Prometheus to monitor volume performance.

  • Longhorn System Backup & Restore [lep][doc]
    Users can back up the longhorn system to the remote backup target. Afterward, it's able to restore back to an existing cluster in place or a new cluster for specific operational purposes.

  • Support Bundle Enhancement [lep]
    Longhorn introduces a new support bundle integration based on a general support bundle kit solution. This can help us collect more complete troubleshooting info and simulate the cluster environment.

  • Tunable Timeout between Engine and Replica [doc]
    In the current Longhorn versions, the default timeout between the Longhorn engine and replica is fixed without any exposed user settings. This will potentially bring some challenges for users having a low-spec infra environment. By exporting the setting configurable, it will allow users adaptively tune the stability of volume operations.

Installation

Please ensure your Kubernetes cluster is at least v1.21 before installing Longhorn v1.4.0.

Longhorn supports 3 installation ways including Rancher App Marketplace, Kubectl, and Helm. Follow the installation instructions here.

Upgrade

Please ensure your Kubernetes cluster is at least v1.21 before upgrading to Longhorn v1.4.0 from v1.3.x. Only support upgrading from 1.3.x.

The live upgrade from v1.3.x is not supported until the GA release. When available, follow the upgrade instructions here. here.

Deprecation & Incompatibilities

  • Pod Security Policy is an opt-in setting. If installing Longhorn with PSP support, need to enable it first.

Known Issues after Release

Please follow up on here about any outstanding issues found after this release.

Highlights

Enhancements

Improvement

Performance

  • [BUG] Turn a node down and up, workload takes longer time to come back online in Longhorn v1.2.0 (2947) - @yangchiu @PhanLe1010
  • [TASK] RWX volume performance measurement and investigation (3665) - @derekbit
  • [TASK] Verify spinning disk/HDD via the current e2e regression (4182) - @yangchiu
  • [BUG] test_csi_snapshot_snap_create_volume_from_snapshot failed when using HDD as Longhorn disks (4227) - @yangchiu @PhanLe1010
  • [TASK] Disable tcmalloc in data path because newer tcmalloc version leads to performance drop (5096) - @derekbit @chriscchien

Stability

  • [BUG] Longhorn won't fail all replicas if there is no valid backend during the engine starting stage (1330) - @derekbit @roger-ryao
  • [BUG] Every other backup fails and crashes the volume (Segmentation Fault) (1768) - @olljanat @mantissahz
  • [BUG] Somehow the Rebuilding field inside volume.meta is set to true causing the volume to stuck in attaching/detaching loop (4212) - @yangchiu @derekbit
  • [BUG] Engine binary cannot be recovered after being removed accidentally (4380) - @yangchiu @c3y1huang
  • [TASK] Disable tcmalloc in longhorn-engine and longhorn-instance-manager (5068) - @derekbit

Bugs

Misc

  • [DOC] RWX support for NVIDIA JETSON Ubuntu 18.4LTS kernel requires enabling NFSV4.1 (3157) - @yangchiu @derekbit
  • [DOC] Add information about encryption algorithm to documentation (3285) - @mantissahz
  • [DOC] Update the doc of volume size after introducing snapshot prune (4158) - @shuo-wu
  • [Doc] Update the outdated "Customizing Default Settings" document (4174) - @derekbit
  • [TASK] Refresh distro version support for 1.4 (4401) - @weizhe0422
  • [TASK] Update official document Longhorn Networking (4478) - @derekbit
  • [TASK] Update preserveUnknownFields fields in longhorn-manager CRD manifest (4505) - @derekbit @roger-ryao
  • [TASK] Disable doc search for archived versions < 1.1 (4524) - @mantissahz
  • [TASK] Update longhorn components with the latest backupstore (4552) - @derekbit
  • [TASK] Update base image of all components from BCI 15.3 to 15.4 (4617) - @yangchiu
  • [DOC] Update the Longhorn document in Install with Helm (4745) - @roger-ryao
  • [TASK] Create longhornio support-bundle-kit image (4911) - @yangchiu
  • [DOC] Add Recurring * Jobs History Limit to setting referenence (4912) - @weizhe0422 @roger-ryao
  • [DOC] Add Failed Backup TTL to setting referenence (4913) - @mantissahz
  • [TASK] Create longhornio liveness probe image (4945) - @yangchiu
  • [TASK] Make system managed components branch-based build (5024) - @yangchiu
  • [TASK] Remove unstable s390x from PR check for all repos (5040) -
  • [TASK] Update longhorn-share-manager's nfs-ganesha to V4.2.1 (5083) - @derekbit @mantissahz

Contributors

Don't miss a new longhorn release

NewReleases is sending notifications on new releases.