Releases: longhorn/longhorn
Longhorn v1.8.1-rc2
DON'T UPGRADE from/to any RC/Preview/Sprint releases because the operation is not supported.
Resolved Issues in this release
Improvement
- [BACKPORT][v1.8.1][IMPROVEMENT] Support configurable upgrade-responder URL 10439 - @derekbit @roger-ryao
- [BACKPORT][v1.8.1][IMPROVEMENT] Several warning for unknown reason 10420 - @roger-ryao
- [BACKPORT][v1.8.1][IMPROVEMENT] Settings change validation should go back to using Volume state to determine "are all volumes detached" 10376 - @yangchiu @james-munson
Bug
- [BACKPORT][v1.8.1][BUG] When replica rebuilding completed, the progress could be 99 instead of 100 10485 - @shuo-wu @chriscchien
- [BACKPORT][v1.8.1][BUG] list_backupVolume API could randomly returns
failed to find a node that is ready and has the default engine image
error 10478 - @yangchiu @mantissahz - [BACKPORT][v1.8.1][BUG] nil pointer when the backing image copy is delete from the spec but also gets evicted at the same time 10466 - @yangchiu @ChanYiLin
- [BACKPORT][v1.8.1][BUG] 2 uninstall pods could be created after uninstall job was created, one failed with
deleting-confirmation-flag is set to false
error, while the other completed successfully 10484 - - [BACKPORT][v1.8.1][BUG][UI] Backup store setting doesn't apply to the cloned volume 10468 - @yangchiu @mantissahz
- [BACKPORT][v1.8.1][BUG] v2 volume workload FailedMount with message Staging target path
/var/lib/kubelet/plugins/kubernetes.io/csi/driver.longhorn.io/xxx/globalmount is no longer valid
10477 - - [BACKPORT][v1.8.1][BUG][UI] Bulk backup creation with a detached volume returns error 405 and error messages show in browser console 10462 - @mantissahz
- [BACKPORT][v1.8.1][BUG] V2 volume fails to cleanup error replica and rebuild new one - test_data_locality_basic 10364 - @shuo-wu @chriscchien
- [BACKPORT][v1.8.1][BUG] Data lost caused by Longhorn CSI plugin doing a wrong filesystem format action in a rare race condition 10418 - @yangchiu @PhanLe1010
- [BACKPORT][v1.8.1][BUG] v2 Engine loops in detaching and attaching state after rebuilding 10397 - @shuo-wu
- [BACKPORT][v1.8.1][BUG] A V2 volume checksum will change after replica rebuilding if the volume created with backing image 10341 - @shuo-wu @chriscchien
- [BACKPORT][v1.8.1][BUG] Bug in snapshot count enforcement cause volume faulted and stuck in detaching/attaching loop 10309 - @PhanLe1010 @roger-ryao
- [BACKPORT][v1.8.1][BUG] Test case
test_csi_mount_volume_online_expansion
is failing due to unable to expand PVC 10414 - @yangchiu @c3y1huang - [BACKPORT][v1.8.1][BUG] V2 BackingImage failed after node reboot 10343 - @ChanYiLin @chriscchien
- [BACKPORT][v1.8.1][BUG] Workload pod will not be able to move to new node when backup operation is taking a long time 10172 - @PhanLe1010 @chriscchien
- [BACKPORT][v1.8.1][BUG] WebUI Volumes Disappear and Reappear 10332 - @PhanLe1010 @chriscchien @houhoucoop
- [BACKPORT][v1.8.1][BUG] "Error get size" from "metrics_collector.(*BackupCollector).Collect" on every metric scrape 10361 - @derekbit @chriscchien
- [BACKPORT][v1.8.1][BUG] [UI] 'Create' button on the System Backup page is disabled after reloading page 10354 - @chriscchien @houhoucoop
- [BACKPORT][v1.8.1][BUG] Proxy gRPC API ReplicaList returns different output formats for v1 and v2 volumes 10353 - @shuo-wu @roger-ryao
- [BACKPORT][v1.8.1][BUG] constant attaching/reattaching of volumes after upgrading to 1.8 10315 - @james-munson
- [BACKPORT][v1.8.1][BUG] Backup Execution Timeout setting issue in Helm chart 10325 - @james-munson @chriscchien
- [BACKPORT][v1.8.1][BUG] v2 engine stuck in detaching-attaching loop if the previous replica is not cleaned up correct 10363 - @shuo-wu @chriscchien
- [BACKPORT][v1.8.1][BUG] Longhorn CSI plugin 1.8.0 crashes consistently when trying to create a snapshot 10319 - @PhanLe1010 @chriscchien
- [BACKPORT][v1.8.1][BUG] Engine stuck in "stopped" state, prevent volume attach 10329 - @ChanYiLin @chriscchien
- [BACKPORT][v1.8.1][BUG] After upgrading to v1.8.0 the version number lost on the web-ui 10337 - @derekbit
- [BACKPORT][v1.8.1][BUG] insufficient storage;precheck new replica failed after a temporary shutdown of a node 10234 - @PhanLe1010
Misc
- [TASK] Fix CVE issues for v1.8.1 10318 - @c3y1huang
Contributors
Longhorn v1.8.1-rc1
DON'T UPGRADE from/to any RC/Preview/Sprint releases because the operation is not supported.
Resolved Issues in this release
Improvement
- [BACKPORT][v1.8.1][IMPROVEMENT] Support configurable upgrade-responder URL 10439 - @derekbit @roger-ryao
- [BACKPORT][v1.8.1][IMPROVEMENT] Several warning for unknown reason 10420 - @roger-ryao
- [BACKPORT][v1.8.1][IMPROVEMENT] Settings change validation should go back to using Volume state to determine "are all volumes detached" 10376 - @yangchiu @james-munson
Bug
- [BACKPORT][v1.8.1][BUG] V2 volume fails to cleanup error replica and rebuild new one - test_data_locality_basic 10364 - @shuo-wu @chriscchien
- [BACKPORT][v1.8.1][BUG] Data lost caused by Longhorn CSI plugin doing a wrong filesystem format action in a rare race condition 10418 - @yangchiu @PhanLe1010
- [BACKPORT][v1.8.1][BUG] v2 Engine loops in detaching and attaching state after rebuilding 10397 - @shuo-wu
- [BACKPORT][v1.8.1][BUG] A V2 volume checksum will change after replica rebuilding if the volume created with backing image 10341 - @shuo-wu @chriscchien
- [BACKPORT][v1.8.1][BUG] Bug in snapshot count enforcement cause volume faulted and stuck in detaching/attaching loop 10309 - @PhanLe1010 @roger-ryao
- [BACKPORT][v1.8.1][BUG] Test case
test_csi_mount_volume_online_expansion
is failing due to unable to expand PVC 10414 - @yangchiu @c3y1huang - [BACKPORT][v1.8.1][BUG] V2 BackingImage failed after node reboot 10343 - @ChanYiLin @chriscchien
- [BACKPORT][v1.8.1][BUG] Workload pod will not be able to move to new node when backup operation is taking a long time 10172 - @PhanLe1010 @chriscchien
- [BACKPORT][v1.8.1][BUG] WebUI Volumes Disappear and Reappear 10332 - @PhanLe1010 @chriscchien @houhoucoop
- [BACKPORT][v1.8.1][BUG] "Error get size" from "metrics_collector.(*BackupCollector).Collect" on every metric scrape 10361 - @derekbit @chriscchien
- [BACKPORT][v1.8.1][BUG] [UI] 'Create' button on the System Backup page is disabled after reloading page 10354 - @chriscchien @houhoucoop
- [BACKPORT][v1.8.1][BUG] Proxy gRPC API ReplicaList returns different output formats for v1 and v2 volumes 10353 - @shuo-wu @roger-ryao
- [BACKPORT][v1.8.1][BUG] constant attaching/reattaching of volumes after upgrading to 1.8 10315 - @james-munson
- [BACKPORT][v1.8.1][BUG] Backup Execution Timeout setting issue in Helm chart 10325 - @james-munson @chriscchien
- [BACKPORT][v1.8.1][BUG] v2 engine stuck in detaching-attaching loop if the previous replica is not cleaned up correct 10363 - @shuo-wu @chriscchien
- [BACKPORT][v1.8.1][BUG] Longhorn CSI plugin 1.8.0 crashes consistently when trying to create a snapshot 10319 - @PhanLe1010 @chriscchien
- [BACKPORT][v1.8.1][BUG] Engine stuck in "stopped" state, prevent volume attach 10329 - @ChanYiLin @chriscchien
- [BACKPORT][v1.8.1][BUG] After upgrading to v1.8.0 the version number lost on the web-ui 10337 - @derekbit
- [BACKPORT][v1.8.1][BUG] insufficient storage;precheck new replica failed after a temporary shutdown of a node 10234 - @PhanLe1010
Misc
- [TASK] Fix CVE issues for v1.8.1 10318 - @c3y1huang
Contributors
Longhorn v1.7.3
Longhorn v1.7.3 Release Notes
Longhorn 1.7.3 introduces several improvements and bug fixes that are intended to improve system quality, resilience, stability and security.
The Longhorn team appreciates your contributions and expects to receive feedback regarding this release.
Note
For more information about release-related terminology, see Releases.
Installation
Important
Ensure that your cluster is running Kubernetes v1.21 or later before installing Longhorn v1.7.3.
You can install Longhorn using a variety of tools, including Rancher, Kubectl, and Helm. For more information about installation methods and requirements, see Quick Installation in the Longhorn documentation.
Upgrade
Important
Ensure that your cluster is running Kubernetes v1.21 or later before upgrading from Longhorn v1.6.x or v1.7.x (< v1.7.0) to v1.7.3.
Longhorn only allows upgrades from supported versions. For more information about upgrade paths and procedures, see Upgrade in the Longhorn documentation.
Deprecation & Incompatibilities
The functionality of the environment check script overlaps with that of the Longhorn CLI, which is available starting with v1.7.0. Because of this, the script is deprecated in v1.7.0 and is scheduled for removal in v1.8.0.
For information about important changes, including feature incompatibility, deprecation, and removal, see Important Notes in the Longhorn documentation.
Post-Release Known Issues
For information about issues identified after this release, see Release-Known-Issues.
Resolved Issues
Feature
- [BACKPORT][v1.7.3][FEATURE] Add periodic HugePages (2Mi) configuration check to ensure v2 data engine compatibility 10029 - @jangseon-ryu @yangchiu
Improvement
- [BACKPORT][v1.7.3][IMPROVEMENT] Settings change validation should go back to using Volume state to determine "are all volumes detached" 10375 - @yangchiu @james-munson
- [BACKPORT][v1.7.3][IMPROVEMENT] Add support for JSON log format configuration in Longhorn components (UI, driver) 10082 - @chriscchien
- [BACKPORT][v1.7.3][IMPROVEMENT] Logging the reason why the instance manager pod is going to be deleted. 9887 - @derekbit @chriscchien
- [BACKPORT][v1.7.3][IMPROVEMENT] Why is it not possible to change the replica count in v2 longhorn volume? 9806 - @chriscchien
- [BACKPORT][v1.7.3][IMPROVEMENT] Check NFS versions in /etc/nfsmount.conf instead 9831 - @COLDTURNIP @roger-ryao
- [BACKPORT][v1.7.3][IMPROVEMENT] Add dmsetup and dmcrypt utilities check in cli 9935 - @COLDTURNIP @roger-ryao
- [BACKPORT][v1.7.3][UI][IMPROVEMENT] Improve the volume size information on UI 9964 - @houhoucoop @roger-ryao
- [BACKPORT][v1.7.3][IMPROVEMENT] Prevent Volume Resize Stuck 9914 - @c3y1huang @roger-ryao
- [BACKPORT][v1.7.3][IMPROVEMENT][UI] Add backupBackingImage table in backup page with tabs 9970 - @houhoucoop
- [BACKPORT][v1.7.3][IMPROVEMENT] Reject strict-local + RWX volume creation 9930 - @COLDTURNIP @yangchiu
- [BACKPORT][v1.7.3][IMPROVEMENT] Configure the log level of other system and user managed components via longhorn manager setting 9617 - @yangchiu @james-munson
- [BACKPORT][v1.7.3][IMPROVEMENT] Change confusing error message to warning level 9917 - @yangchiu @derekbit
- [BACKPORT][v1.7.3][IMPROVEMENT] Building longhorn-manager takes long time 9693 - @derekbit @chriscchien
- [BACKPORT][v1.7.3][IMPROVEMENT] Talos support for environment check in longhorn manager 9723 - @yangchiu @c3y1huang
Bug
- [BACKPORT][v1.7.3][BUG] Data lost caused by Longhorn CSI plugin doing a wrong filesystem format action in a rare race condition 10417 - @yangchiu @PhanLe1010 @chriscchien
- [BACKPORT][v1.7.3][BUG] kubectl drain node is blocked by unexpected orphan engine processes 10427 - @yangchiu @PhanLe1010
- [BACKPORT][v1.7.3][BUG] Test case
test_csi_mount_volume_online_expansion
is failing due to unable to expand PVC 10413 - @yangchiu @c3y1huang - [BACKPORT][v1.7.3][BUG] Workload pod will not be able to move to new node when backup operation is taking a long time 10173 - @yangchiu
- [BUG][v1.7.x] Excessive memory consumption caused by RWX volumes / ganesha.nfsd 8523 - @james-munson @chriscchien
- [BACKPORT][v1.7.3][BUG] WebUI Volumes Disappear and Reappear 10331 - @PhanLe1010 @chriscchien @houhoucoop
- [BACKPORT][v1.7.3][BUG] "Error get size" from "metrics_collector.(*BackupCollector).Collect" on every metric scrape 10362 - @derekbit @chriscchien
- [BACKPORT][v1.7.3][BUG] Engine stuck in "stopped" state, prevent volume attach 9954 - @ChanYiLin @roger-ryao
- [BACKPORT][v1.7.3][BUG] Backup Execution Timeout setting issue in Helm chart 10326 - @james-munson @chriscchien
- [BACKPORT][v1.7.3][BUG] Instability after power failure 10185 - @yangchiu @james-munson
- [BACKPORT][v1.7.3][BUG] CSI plugin pod keep crashing util the backup volume appears when creation a backup via the CSI snapshotter 10024 - @mantissahz @chriscchien
- [BACKPORT][v1.7.3][BUG] insufficient storage;precheck new replica failed after a temporary shutdown of a node 10223 - @PhanLe1010 @roger-ryao
- [BACKPORT][v1.7.3][BUG] longhorn-manager seems to crash rpm-DB on the host by continuously calling rpm -q ... 10022 - @COLDTURNIP @roger-ryao
- [BACKPORT][v1.7.3][BUG] Backup progress should not add block failed to upload to successful count 9793 - @derekbit @chriscchien
- [BACKPORT][v1.7.3][BUG][v1.8.x] Can not create backup, backup become in error state immediately 10180 - @PhanLe1010 @chriscchien
- [BACKPORT][v1.7.3][BUG] Storage doesn't reschedule in v1.7.2 10109 - @PhanLe1010
- [BACKPORT][v1.7.3][BUG] Old backups are not cleaned up after timeout 9731 - @mantissahz @roger-ryao
- [BACKPORT][v1.7.3][BUG] UnknowOS Message in Longhorn Node Condition on RHEL 9833 - @yangchiu @mantissahz @roger-ryao
- [BACKPORT][v1.7.3][BUG] volume FailedMount - Input/output error 10005 - @PhanLe1010 @roger-ryao
- [BACKPORT][v1.7.3][BUG] Unable to delete backing image backup through UI 10068 - @chriscchien @houhoucoop @roger-ryao
- [BACKPORT][v1.7.3][BUG] Error notification appears on the volume backup details page 10071 - @houhoucoop @roger-ryao
- [BACKPORT][v1.7.3][BUG] Missing
fromBackup
Parameter in API Request When Restoring Multiple Files from Backup List 10051 - @a110605 @roger-ryao - [BACKPORT][v1.7.3][BUG] Webhook servers initialization blocks longhorn-manager from running 10055 - @c3y1huang @chriscchien
- [BACKPORT][v1.7.3][BUG] CLI check preflight glosses over absence of NFS installation. 9893 - @COLDTURNIP @roger-ryao
- [BACKPORT][v1.7.3][BUG] Detached Volume Stuck in Attached State During Node Eviction 9810 - @yangchiu @c3y1huang
- [BACKPORT][v1.7.3][BUG] Test case test_node_eviction_multiple_volume failed to reschedule replicas after volume detached 9866 - @yangchiu @c3y1huang
- [BACKPORT][v1.7.3][BUG] DR volume fails to reattach and faulted after node stop and start during incremental restore 9803 - @c3y1huang @roger-ryao
- [BACKPORT][v1.7.3][BUG] Share manager is permanently stuck in stopping/error if we shutdown the node of share manager pod. This makes RWX PVC cannot attach to any new node 9856 -
- [BACKPORT][v1.7.3][BUG] Fail to resize RWX PVC at filesystem resizing step 9738 - @james-munson
- [BACKPORT][v1.7.3][BUG] Failed to inspect the backup bac...
Longhorn v1.7.3-rc2
DON'T UPGRADE from/to any RC/Preview/Sprint releases because the operation is not supported.
Resolved Issues in this release
Feature
- [BACKPORT][v1.7.3][FEATURE] Add periodic HugePages (2Mi) configuration check to ensure v2 data engine compatibility 10029 - @yangchiu
Improvement
- [BACKPORT][v1.7.3][IMPROVEMENT] Settings change validation should go back to using Volume state to determine "are all volumes detached" 10375 - @yangchiu @james-munson
- [BACKPORT][v1.7.3][IMPROVEMENT] Add support for JSON log format configuration in Longhorn components (UI, driver) 10082 - @chriscchien
- [BACKPORT][v1.7.3][IMPROVEMENT] Logging the reason why the instance manager pod is going to be deleted. 9887 - @derekbit @chriscchien
- [BACKPORT][v1.7.3][IMPROVEMENT] Why is it not possible to change the replica count in v2 longhorn volume? 9806 - @chriscchien
- [BACKPORT][v1.7.3][IMPROVEMENT] Check NFS versions in /etc/nfsmount.conf instead 9831 - @COLDTURNIP @roger-ryao
- [BACKPORT][v1.7.3][IMPROVEMENT] Add dmsetup and dmcrypt utilities check in cli 9935 - @COLDTURNIP @roger-ryao
- [BACKPORT][v1.7.3][UI][IMPROVEMENT] Improve the volume size information on UI 9964 - @houhoucoop @roger-ryao
- [BACKPORT][v1.7.3][IMPROVEMENT] Prevent Volume Resize Stuck 9914 - @c3y1huang @roger-ryao
- [BACKPORT][v1.7.3][IMPROVEMENT][UI] Add backupBackingImage table in backup page with tabs 9970 - @houhoucoop
- [BACKPORT][v1.7.3][IMPROVEMENT] Reject strict-local + RWX volume creation 9930 - @COLDTURNIP @yangchiu
- [BACKPORT][v1.7.3][IMPROVEMENT] Configure the log level of other system and user managed components via longhorn manager setting 9617 - @yangchiu @james-munson
- [BACKPORT][v1.7.3][IMPROVEMENT] Change confusing error message to warning level 9917 - @yangchiu @derekbit
- [BACKPORT][v1.7.3][IMPROVEMENT] Building longhorn-manager takes long time 9693 - @derekbit @chriscchien
- [BACKPORT][v1.7.3][IMPROVEMENT] Talos support for environment check in longhorn manager 9723 - @yangchiu @c3y1huang
Bug
- [BACKPORT][v1.7.3][BUG] Data lost caused by Longhorn CSI plugin doing a wrong filesystem format action in a rare race condition 10417 - @yangchiu @PhanLe1010 @chriscchien
- [BACKPORT][v1.7.3][BUG] kubectl drain node is blocked by unexpected orphan engine processes 10427 - @yangchiu @PhanLe1010
- [BACKPORT][v1.7.3][BUG] Test case
test_csi_mount_volume_online_expansion
is failing due to unable to expand PVC 10413 - @yangchiu @c3y1huang - [BACKPORT][v1.7.3][BUG] Workload pod will not be able to move to new node when backup operation is taking a long time 10173 - @yangchiu
- [BUG][v1.7.x] Excessive memory consumption caused by RWX volumes / ganesha.nfsd 8523 - @james-munson @chriscchien
- [BACKPORT][v1.7.3][BUG] WebUI Volumes Disappear and Reappear 10331 - @PhanLe1010 @chriscchien @houhoucoop
- [BACKPORT][v1.7.3][BUG] "Error get size" from "metrics_collector.(*BackupCollector).Collect" on every metric scrape 10362 - @derekbit @chriscchien
- [BACKPORT][v1.7.3][BUG] Engine stuck in "stopped" state, prevent volume attach 9954 - @ChanYiLin @roger-ryao
- [BACKPORT][v1.7.3][BUG] Backup Execution Timeout setting issue in Helm chart 10326 - @james-munson @chriscchien
- [BACKPORT][v1.7.3][BUG] Instability after power failure 10185 - @yangchiu @james-munson
- [BACKPORT][v1.7.3][BUG] CSI plugin pod keep crashing util the backup volume appears when creation a backup via the CSI snapshotter 10024 - @mantissahz @chriscchien
- [BACKPORT][v1.7.3][BUG] insufficient storage;precheck new replica failed after a temporary shutdown of a node 10223 - @PhanLe1010 @roger-ryao
- [BACKPORT][v1.7.3][BUG] longhorn-manager seems to crash rpm-DB on the host by continously calling rpm -q ... 10022 - @COLDTURNIP @roger-ryao
- [BACKPORT][v1.7.3][BUG] Backup progress should not add block failed to upload to successful count 9793 - @derekbit @chriscchien
- [BACKPORT][v1.7.3][BUG][v1.8.x] Can not create backup, backup become in error state immediately 10180 - @PhanLe1010 @chriscchien
- [BACKPORT][v1.7.3][BUG] Storage doesn't reschedule in v1.7.2 10109 - @PhanLe1010
- [BACKPORT][v1.7.3][BUG] Old backups are not cleaned up after timeout 9731 - @mantissahz @roger-ryao
- [BACKPORT][v1.7.3][BUG] UnknowOS Message in Longhorn Node Condition on RHEL 9833 - @yangchiu @mantissahz @roger-ryao
- [BACKPORT][v1.7.3][BUG] volume FailedMount - Input/output error 10005 - @PhanLe1010 @roger-ryao
- [BACKPORT][v1.7.3][BUG] Unable to delete backing image backup through UI 10068 - @chriscchien @houhoucoop @roger-ryao
- [BACKPORT][v1.7.3][BUG] Error notification appears on the volume backup details page 10071 - @houhoucoop @roger-ryao
- [BACKPORT][v1.7.3][BUG] Missing
fromBackup
Parameter in API Request When Restoring Multiple Files from Backup List 10051 - @a110605 @roger-ryao - [BACKPORT][v1.7.3][BUG] Webhook servers initialization blocks longhorn-manager from running 10055 - @c3y1huang @chriscchien
- [BACKPORT][v1.7.3][BUG] CLI check preflight glosses over absence of NFS installation. 9893 - @COLDTURNIP @roger-ryao
- [BACKPORT][v1.7.3][BUG] Detached Volume Stuck in Attached State During Node Eviction 9810 - @yangchiu @c3y1huang
- [BACKPORT][v1.7.3][BUG] Test case test_node_eviction_multiple_volume failed to reschedule replicas after volume detached 9866 - @yangchiu @c3y1huang
- [BACKPORT][v1.7.3][BUG] DR volume fails to reattach and faulted after node stop and start during incremental restore 9803 - @c3y1huang @roger-ryao
- [BACKPORT][v1.7.3][BUG] Share manager is permanently stuck in stopping/error if we shutdown the node of share manager pod. This makes RWX PVC cannot attach to any new node 9856 -
- [BACKPORT][v1.7.3][BUG] Fail to resize RWX PVC at filesystem resizing step 9738 - @james-munson
- [BACKPORT][v1.7.3][BUG] Failed to inspect the backup backing image information if NFS backup target URL with options 9703 - @yangchiu @mantissahz
- [BACKPORT][v1.7.3][BUG] Pre-upgrade pod should event the reason for any failures. 9643 - @yangchiu @james-munson
Misc
- [TASK] Fix CVE issues for v1.7.3 9897 - @c3y1huang
- [BACKPORT][v1.7.3][TASK] Install the latest grpc_health_probe at build time 9715 - @yangchiu @c3y1huang
Contributors
Longhorn v1.8.0
Longhorn v1.8.0 Release Notes
This latest version of Longhorn introduces several features, enhancements, and bug fixes that are intended to improve system quality and the overall user experience. Highlights include new V2 Data Engine features, multiple backupstores, automatic RWX volume expansion, installation and upgrades via Helm Controller, and V2 Data Engine Support for Talos Linux.
The Longhorn team appreciates your contributions and anticipates receiving feedback regarding this release.
For more information about release-related terminology, see Releases.
Warning
An incorrect Longhorn image tag (v1.8.x-head
) was used in the deployment manifest and the Helm chart. The correct tag for Longhorn v1.8.0 images is v1.8.0
. For more information, see Issue #10336.
If you installed or upgraded Longhorn using the deployment manifest or the Helm chart from the main Longhorn repository, perform the following actions to resolve the issue:
-
New installations: Replace
v1.8.x-head
withv1.8.0
in the deployment manifest or the Helm chart before deploying Longhorn. -
Upgrades: Replace
v1.8.x-head
withv1.8.0
in the deployment manifest or Helm chart. Next, upgrade the Longhorn system and update the engine image for volumes that usev1.8.x-head
.
This issue does not affect installations and upgrades performed using the Longhorn Helm repository. For more details, refer to the Install with Helm section of the official documentation.
Important
The CSI external-snapshotter was upgraded to v8.2.0. Ensure that all clusters are running Kubernetes v1.25 or later before upgrading to Longhorn v1.8.0 or a later version.
Deprecation & Incompatibilities
-
The default block size for block-type disks in earlier Longhorn releases is 4096 bytes. However, 512 bytes is more commonly used and aligns with the V1 Data Engine's configuration. Additionally, the 4096-byte block size is incompatible with backing images generated by the V1 Data Engine. To address these concerns, the default block size was changed to 512 bytes.
If you have existing V2 volumes, perform the following steps:
- Back up the V2 volumes.
- Remove the V2 volumes.
- Delete the block-type disk with a 4096-byte block size from
node.spec.disks
. - Erase the old data on the block-type disk using tools such as dd.
- Add the disk again to
node.spec.disks
with the updated configuration. - Restore the V2 volumes.
For more information, see #10053.
-
A V2 volume data corruption issue that affects earlier Longhorn releases has been resolved in v1.8.0. The issue involves potential continual changes to the checksum of files in a V2 volume with multiple replicas. This occurs because SPDK allocates clusters without initialization, leading to data inconsistencies across replicas. The varying data read from the volume can result in data corruption and broken backups. For more information, see #10035.
Primary Highlights
New V2 Data Engine Features
Although the V2 Data Engine is still considered an experimental feature in this release, the core functions have been significantly enhanced.
- Configurable CPU cores: Support the global and node-specific configuration options provide greater control and flexibility for optimizing performance and resource allocation.
- Disaster recovery (DR) volumes: Designed to store data in a backup cluster in the event of a failure in the main cluster. DR volumes enhance the resiliency of Longhorn volumes by ensuring data can be quickly restored in case of cluster outages.
- Auto-salvage volumes: Automatically repair volumes in the event of a failure.
- Live migration: Allow for the migration of volumes from one node to another without interrupting the services using those volumes.
- Volume encryption: Ensure data stored in volumes is protected through encryption in transit and at rest.
- Delta replica rebuilding using snapshot checksum.
- Backing image update and download.
Multiple Backupstores and Default Backup Target
Starting with v1.8.0, Longhorn allows you to use multiple backupstores for storing backups of Longhorn volumes. Longhorn v1.8.0 also creates a default backup target (default
) during installation and upgrades. The default backup target is used for system backups and volumes that were created without an assigned backup target name.
Demo | Documentation | GitHub Issue
Automatic RWX Volume Expansion
Longhorn v1.8.0 supports fully automatic online expansion of RWX volumes without the need to scale down the workload or apply manual commands. To use this feature, ensure that the v1.8.0 versions of Longhorn Manager, Share Manager, and the CSI plugin are all running.
Helm Controller
You can now install and upgrade Longhorn on clusters running RKE2 or K3s using the Helm Controller that is built into those distributions. The Helm Controller manages Helm charts using a HelmChart Custom Resource Definition (CRD), which contains most of the options that would normally be passed to the Helm command-line tool.
V2 Data Engine Support for Talos Linux
Longhorn v1.8.0 supports usage of V2 volumes in Talos Linux clusters. To use this feature, ensure that all nodes meet the V2 Data Engine prerequisites.
Installation
Important
Ensure that your cluster is running Kubernetes v1.25 or later before installing Longhorn v1.8.0.
You can install Longhorn using a variety of tools, including Rancher, Kubectl, and Helm. For more information about installation methods and requirements, see Quick Installation in the Longhorn documentation.
Upgrade
Important
Ensure that your cluster is running Kubernetes v1.25 or later before upgrading from Longhorn v1.7.x to v1.8.0.
Longhorn only allows upgrades from supported versions. For more information about upgrade paths and procedures, see Upgrade in the Longhorn documentation.
Post-Release Known Issues
For information about issues identified after this release, see Release-Known-Issues.
Highlight
- [FEATURE] Support encrypted v2 volumes 7355 - @mantissahz @chriscchien
- [FEATURE] Support v2 volume delta replica rebuilding based on snapshot checksum: data plane and control plane 9488 - @shuo-wu @roger-ryao
- [FEATURE] Multiple backup stores support 5411 - @mantissahz @roger-ryao
- [FEATURE] Support v2 volume delta replica rebuilding based on snapshot checksum: SPDK part 5573 - @DamiaSan @roger-ryao
- [IMPROVEMENT] v2 volume supports data locality 9371 - @derekbit @roger-ryao
- [FEATURE] SPDK volume supports live migration 6361 - @PhanLe1010 @chriscchien @roger-ryao
- [FEATURE] Support backing image for v2 volume 6341 - @yangchiu @ChanYiLin @chriscchien
- [FEATURE] Make CPU core configurable for v2 data engine 8835 - @yangchiu @derekbit
- [FEATURE] Support/verify installing Longhorn Helm chart using helm-controller which is built in k3s and rke2 9506 - @yangchiu @james-munson
- [FEATURE] v2 volume supports auto salvage 8430 - @c3y1huang @chriscchien
- [FEATURE] v2 volumes supports DR volume 6613 - @c3y1huang @roger-ryao
- [FEATURE] Talos support for v2 data engine 7791 - @yangchiu @c3y1huang
Feature
- [FEATURE] Support Data Engine Option For Backing Image in CSI flow 10084 - @ChanYiLin @roger-ryao
- [FEATURE] Missing option to modify backup-task retain value from UI while editing recurring job [8810](#8810...
Longhorn v1.8.0-rc5
DON'T UPGRADE from/to any RC/Preview/Sprint releases because the operation is not supported.
Resolved Issues in this release
Highlight
- [FEATURE] Support encrypted v2 volumes 7355 - @mantissahz @chriscchien
- [FEATURE] Support v2 volume delta replica rebuilding based on snapshot checksum: data plane and control plane 9488 - @shuo-wu @roger-ryao
- [FEATURE] Multiple backup stores support 5411 - @mantissahz @roger-ryao
- [FEATURE] Support v2 volume delta replica rebuilding based on snapshot checksum: SPDK part 5573 - @DamiaSan @roger-ryao
- [IMPROVEMENT] v2 volume supports data locality 9371 - @derekbit @roger-ryao
- [FEATURE] SPDK volume supports live migration 6361 - @PhanLe1010 @chriscchien @roger-ryao
- [FEATURE] Support backing image for v2 volume 6341 - @yangchiu @ChanYiLin @chriscchien
- [FEATURE] Make CPU core configurable for v2 data engine 8835 - @yangchiu @derekbit
- [FEATURE] Support/verify installing Longhorn Helm chart using helm-controller which is built in k3s and rke2 9506 - @yangchiu @james-munson
- [FEATURE] v2 volume supports auto salvage 8430 - @c3y1huang @chriscchien
- [FEATURE] v2 volumes supports DR volume 6613 - @c3y1huang @roger-ryao
- [FEATURE] Talos support for v2 data engine 7791 - @yangchiu @c3y1huang
Feature
- [FEATURE] Support Data Engine Option For Backing Image in CSI flow 10084 - @ChanYiLin @roger-ryao
- [FEATURE] Missing option to modify backup-task retain value from UI while editing recurring job 8810 - @houhoucoop @roger-ryao
- [UI][FEATURE] Multiple backup stores support 8647 - @a110605 @roger-ryao
- [UI][FEATURE] Support V2 Backing Image in UI 9880 - @yangchiu @chriscchien @houhoucoop
- [FEATURE] Add periodic HugePages (2Mi) configuration check to ensure v2 data engine compatibility 9983 - @yangchiu @jangseon-ryu
- [FEATURE][UI] Fill in the secret and secret namespace when restoring the BackupBackingImage 9490 - @chriscchien @houhoucoop
- [FEATURE] Add kernel module check for data engine v2 9915 - @jangseon-ryu @roger-ryao
- [FEATURE]: Automatic online filesystem resize for RWX volumes. 9736 - @yangchiu @james-munson
- [FEATURE] Add recurring job label to backup metrics or empty value 9429 - @ChanYiLin @roger-ryao
- [FEATURE] Longhorn CLI supports darwin platform 9532 - @derekbit @chriscchien
Improvement
- [IMPROVEMENT] Bump nfs-ganesha in longhorn-share-manager from v6.3 to v6.5 10194 - @derekbit @chriscchien
- [IMPROVEMENT] V2 Data engine avoids changing the data of a lvol when decoupling it from 9922 - @DamiaSan @roger-ryao
- [IMPROVEMENT] Change the AIO disk block size to 512 bytes for v2 data engine 10053 - @derekbit @chriscchien
- [IMPROVEMENT] No need to truncate block-type disk's StorageAvailable value 10121 - @derekbit @chriscchien
- [IMPROVEMENT] Separate the default backup target settings from default settings 10089 - @mantissahz @roger-ryao
- [IMPROVEMENT] Add support for JSON log format configuration in Longhorn components (UI, driver) 10064 - @IshinMV @chriscchien
- [IMPROVEMENT] No need to start
tgtd
in an instance-manager pod for v2 data engine 9941 - @derekbit @roger-ryao - [IMPROVEMENT] Configure the log level of other system and user managed components via longhorn manager setting 6702 - @james-munson @roger-ryao
- [IMPROVEMENT] Longhorn CLI should install
cryptsetup
9315 - @mantissahz @roger-ryao - [IMPROVEMENT] Collect and display disk space usage for the backing images 8757 - @ChanYiLin @roger-ryao
- [IMPROVEMENT] Check NFS versions in /etc/nfsmount.conf instead 9830 - @COLDTURNIP @roger-ryao
- [IMPROVEMENT] Change misleading error message to warning level 9916 - @yangchiu @derekbit
- [IMPROVEMENT] No need to redirect
spdk_tgt
log to/var/log/spdk_tgt.log
9926 - @derekbit @chriscchien - [UI][IMPROVEMENT] Make backup wait until there is no backup being delete and Add the progress time 8750 - @a110605
- [IMPROVEMENT] Allow specify data engine version for the default storageclass during Helm installation 9584 - @shuo-wu @chriscchien
- [IMPROVEMENT] Building longhorn-manager takes long time 8744 - @derekbit @chriscchien
- [IMPROVEMENT] Reject strict-local + RWX volume creation 6735 - @COLDTURNIP @chriscchien
- [IMPROVEMENT] Restored volume or other operations should be allowed on the old and running instance-manager pods 9383 - @derekbit @chriscchien
- [IMPROVEMENT] Make backup deletion async and force backup creation wait until there is no backup being delete 8746 - @ChanYiLin @roger-ryao
- [IMPROVEMENT][UI] Attach table search keyword to URL on Backup pages 9974 - @chriscchien @houhoucoop
- [IMPROVEMENT] Busrt ISCSI Connection Errors, and IM Pod Restarting to make LH Volume disconnection 9851 - @ChanYiLin @chriscchien
- [IMPROVEMENT] Why is it not possible to change the replica count in v2 longhorn volume? 9805 - @hookak @chriscchien
- [IMPROVEMENT][UI] Add backupBackingImage table in backup page with tabs 8956 - @chriscchien @houhoucoop
- [IMPROVEMENT] Decrease the reconnect delay of v2 volume nvme initiator 9818 - @derekbit @chriscchien
- [UI][IMPROVEMENT] Improve the volume size information on UI 8843 - @yangchiu @houhoucoop
- [IMPROVEMENT] Add dmsetup and dmcrypt utilities check in cli 8217 - @COLDTURNIP @roger-ryao
- [UI IMPROVEMENT] Collect and display disk space usage for the backing images 9325 - @chriscchien @houhoucoop
- [IMPROVEMENT] Check kernel module
dm_crypt
on host machines 9153 - @mantissahz @roger-ryao - [IMPROVEMENT] Logging the reason why the instance manager pod is going to be deleted. 9886 - @derekbit @chriscchien
- [IMPROVEMENT] Remove isCLIAPIVersionOne related codes 7191 - @derekbit @chriscchien
- [IMPROVEMENT] Prevent Volume Resize Stuck 6633 - @c3y1huang @roger-ryao
- [IMPROVEMENT] Expose EngineImage CLIAPIVersion and ControllerAPIVersion 6531 - @chriscchien @houhoucoop
- [IMPROVEMENT] Update longhorn-share-manager's nfs-ganesha to v6.2 9614 - @derekbit @chriscchien
- [UI][IMPROVEMENT] Display
ReUploadedDataSize
andNewlyUploadedDataSize
of each backup on Backup page 8975 - @yangchiu @houhoucoop - [IMPROVEMENT] Remove the default CSI component images in longhorn-manager 9580 - @yangchiu @c3y1huang
- [IMPROVEMENT] the
if-not-present
volume backup policy should also check if the latest backup is up-to-date 6027 - @c3y1huang @chriscchien - [IMPROVEMENT] longhorn/go-common-libs should support Darwin 9487 - @Yu-Jack @chriscchien
- [IMPROVEMENT] Enable Prometheus metrics of the CSI sidecar components 7938 - @yangchiu @ChanYiLin
- [IMPROVEMENT] Talos support for environment check in longhorn manager 9558 - @yangchiu @c3y1huang
- [IMPROVEMENT] Refactor condition icon and text in edit node and disk modal 9238 - @a110605
- [IMPROVEMENT] Read-only volu...
Longhorn v1.8.0-rc4
DON'T UPGRADE from/to any RC/Preview/Sprint releases because the operation is not supported.
Resolved Issues in this release
Highlight
- [FEATURE] Support encrypted v2 volumes 7355 - @mantissahz @chriscchien
- [FEATURE] Support v2 volume delta replica rebuilding based on snapshot checksum: data plane and control plane 9488 - @shuo-wu @roger-ryao
- [FEATURE] Multiple backup stores support 5411 - @mantissahz @roger-ryao
- [FEATURE] Support v2 volume delta replica rebuilding based on snapshot checksum: SPDK part 5573 - @DamiaSan @roger-ryao
- [IMPROVEMENT] v2 volume supports data locality 9371 - @derekbit @roger-ryao
- [FEATURE] SPDK volume supports live migration 6361 - @PhanLe1010 @chriscchien @roger-ryao
- [FEATURE] Support backing image for v2 volume 6341 - @yangchiu @ChanYiLin @chriscchien
- [FEATURE] Make CPU core configurable for v2 data engine 8835 - @yangchiu @derekbit
- [FEATURE] Support/verify installing Longhorn Helm chart using helm-controller which is built in k3s and rke2 9506 - @yangchiu @james-munson
- [FEATURE] v2 volume supports auto salvage 8430 - @c3y1huang @chriscchien
- [FEATURE] v2 volumes supports DR volume 6613 - @c3y1huang @roger-ryao
- [FEATURE] Talos support for v2 data engine 7791 - @yangchiu @c3y1huang
Feature
- [FEATURE] Support Data Engine Option For Backing Image in CSI flow 10084 - @ChanYiLin @roger-ryao
- [FEATURE] Missing option to modify backup-task retain value from UI while editing recurring job 8810 - @houhoucoop @roger-ryao
- [UI][FEATURE] Multiple backup stores support 8647 - @a110605 @roger-ryao
- [UI][FEATURE] Support V2 Backing Image in UI 9880 - @yangchiu @chriscchien @houhoucoop
- [FEATURE] Add periodic HugePages (2Mi) configuration check to ensure v2 data engine compatibility 9983 - @yangchiu @jangseon-ryu
- [FEATURE][UI] Fill in the secret and secret namespace when restoring the BackupBackingImage 9490 - @chriscchien @houhoucoop
- [FEATURE] Add kernel module check for data engine v2 9915 - @jangseon-ryu @roger-ryao
- [FEATURE]: Automatic online filesystem resize for RWX volumes. 9736 - @yangchiu @james-munson
- [FEATURE] Add recurring job label to backup metrics or empty value 9429 - @ChanYiLin @roger-ryao
- [FEATURE] Longhorn CLI supports darwin platform 9532 - @derekbit @chriscchien
Improvement
- [IMPROVEMENT] Bump nfs-ganesha in longhorn-share-manager from v6.3 to v6.5 10194 - @derekbit @chriscchien
- [IMPROVEMENT] V2 Data engine avoids changing the data of a lvol when decoupling it from 9922 - @DamiaSan @roger-ryao
- [IMPROVEMENT] Change the AIO disk block size to 512 bytes for v2 data engine 10053 - @derekbit @chriscchien
- [IMPROVEMENT] No need to truncate block-type disk's StorageAvailable value 10121 - @derekbit @chriscchien
- [IMPROVEMENT] Separate the default backup target settings from default settings 10089 - @mantissahz @roger-ryao
- [IMPROVEMENT] Add support for JSON log format configuration in Longhorn components (UI, driver) 10064 - @IshinMV @chriscchien
- [IMPROVEMENT] No need to start
tgtd
in an instance-manager pod for v2 data engine 9941 - @derekbit @roger-ryao - [IMPROVEMENT] Configure the log level of other system and user managed components via longhorn manager setting 6702 - @james-munson @roger-ryao
- [IMPROVEMENT] Longhorn CLI should install
cryptsetup
9315 - @mantissahz @roger-ryao - [IMPROVEMENT] Collect and display disk space usage for the backing images 8757 - @ChanYiLin @roger-ryao
- [IMPROVEMENT] Check NFS versions in /etc/nfsmount.conf instead 9830 - @COLDTURNIP @roger-ryao
- [IMPROVEMENT] Change misleading error message to warning level 9916 - @yangchiu @derekbit
- [IMPROVEMENT] No need to redirect
spdk_tgt
log to/var/log/spdk_tgt.log
9926 - @derekbit @chriscchien - [UI][IMPROVEMENT] Make backup wait until there is no backup being delete and Add the progress time 8750 - @a110605
- [IMPROVEMENT] Allow specify data engine version for the default storageclass during Helm installation 9584 - @shuo-wu @chriscchien
- [IMPROVEMENT] Building longhorn-manager takes long time 8744 - @derekbit @chriscchien
- [IMPROVEMENT] Reject strict-local + RWX volume creation 6735 - @COLDTURNIP @chriscchien
- [IMPROVEMENT] Restored volume or other operations should be allowed on the old and running instance-manager pods 9383 - @derekbit @chriscchien
- [IMPROVEMENT] Make backup deletion async and force backup creation wait until there is no backup being delete 8746 - @ChanYiLin @roger-ryao
- [IMPROVEMENT][UI] Attach table search keyword to URL on Backup pages 9974 - @chriscchien @houhoucoop
- [IMPROVEMENT] Busrt ISCSI Connection Errors, and IM Pod Restarting to make LH Volume disconnection 9851 - @ChanYiLin @chriscchien
- [IMPROVEMENT] Why is it not possible to change the replica count in v2 longhorn volume? 9805 - @hookak @chriscchien
- [IMPROVEMENT][UI] Add backupBackingImage table in backup page with tabs 8956 - @chriscchien @houhoucoop
- [IMPROVEMENT] Decrease the reconnect delay of v2 volume nvme initiator 9818 - @derekbit @chriscchien
- [UI][IMPROVEMENT] Improve the volume size information on UI 8843 - @yangchiu @houhoucoop
- [IMPROVEMENT] Add dmsetup and dmcrypt utilities check in cli 8217 - @COLDTURNIP @roger-ryao
- [UI IMPROVEMENT] Collect and display disk space usage for the backing images 9325 - @chriscchien @houhoucoop
- [IMPROVEMENT] Check kernel module
dm_crypt
on host machines 9153 - @mantissahz @roger-ryao - [IMPROVEMENT] Logging the reason why the instance manager pod is going to be deleted. 9886 - @derekbit @chriscchien
- [IMPROVEMENT] Remove isCLIAPIVersionOne related codes 7191 - @derekbit @chriscchien
- [IMPROVEMENT] Prevent Volume Resize Stuck 6633 - @c3y1huang @roger-ryao
- [IMPROVEMENT] Expose EngineImage CLIAPIVersion and ControllerAPIVersion 6531 - @chriscchien @houhoucoop
- [IMPROVEMENT] Update longhorn-share-manager's nfs-ganesha to v6.2 9614 - @derekbit @chriscchien
- [UI][IMPROVEMENT] Display
ReUploadedDataSize
andNewlyUploadedDataSize
of each backup on Backup page 8975 - @yangchiu @houhoucoop - [IMPROVEMENT] Remove the default CSI component images in longhorn-manager 9580 - @yangchiu @c3y1huang
- [IMPROVEMENT] the
if-not-present
volume backup policy should also check if the latest backup is up-to-date 6027 - @c3y1huang @chriscchien - [IMPROVEMENT] longhorn/go-common-libs should support Darwin 9487 - @Yu-Jack @chriscchien
- [IMPROVEMENT] Enable Prometheus metrics of the CSI sidecar components 7938 - @yangchiu @ChanYiLin
- [IMPROVEMENT] Talos support for environment check in longhorn manager 9558 - @yangchiu @c3y1huang
- [IMPROVEMENT] Refactor condition icon and text in edit node and disk modal 9238 - @a110605
- [IMPROVEMENT] Read-only volu...
Longhorn v1.8.0-rc3
DON'T UPGRADE from/to any RC/Preview/Sprint releases because the operation is not supported.
Resolved Issues in this release
Highlight
- [FEATURE] Support encrypted v2 volumes 7355 - @mantissahz @chriscchien
- [FEATURE] Support v2 volume delta replica rebuilding based on snapshot checksum: data plane and control plane 9488 - @shuo-wu @roger-ryao
- [FEATURE] Multiple backup stores support 5411 - @mantissahz @roger-ryao
- [FEATURE] Support v2 volume delta replica rebuilding based on snapshot checksum: SPDK part 5573 - @DamiaSan @roger-ryao
- [IMPROVEMENT] v2 volume supports data locality 9371 - @derekbit @roger-ryao
- [FEATURE] SPDK volume supports live migration 6361 - @PhanLe1010 @chriscchien @roger-ryao
- [FEATURE] Support backing image for v2 volume 6341 - @yangchiu @ChanYiLin @chriscchien
- [FEATURE] Make CPU core configurable for v2 data engine 8835 - @yangchiu @derekbit
- [FEATURE] Support/verify installing Longhorn Helm chart using helm-controller which is built in k3s and rke2 9506 - @yangchiu @james-munson
- [FEATURE] v2 volume supports auto salvage 8430 - @c3y1huang @chriscchien
- [FEATURE] v2 volumes supports DR volume 6613 - @c3y1huang @roger-ryao
- [FEATURE] Talos support for v2 data engine 7791 - @yangchiu @c3y1huang
Feature
- [FEATURE] Support Data Engine Option For Backing Image in CSI flow 10084 - @ChanYiLin @roger-ryao
- [FEATURE] Missing option to modify backup-task retain value from UI while editing recurring job 8810 - @houhoucoop @roger-ryao
- [UI][FEATURE] Multiple backup stores support 8647 - @a110605 @roger-ryao
- [UI][FEATURE] Support V2 Backing Image in UI 9880 - @yangchiu @chriscchien @houhoucoop
- [FEATURE] Add periodic HugePages (2Mi) configuration check to ensure v2 data engine compatibility 9983 - @yangchiu @jangseon-ryu
- [FEATURE][UI] Fill in the secret and secret namespace when restoring the BackupBackingImage 9490 - @chriscchien @houhoucoop
- [FEATURE] Add kernel module check for data engine v2 9915 - @jangseon-ryu @roger-ryao
- [FEATURE]: Automatic online filesystem resize for RWX volumes. 9736 - @yangchiu @james-munson
- [FEATURE] Add recurring job label to backup metrics or empty value 9429 - @ChanYiLin @roger-ryao
- [FEATURE] Longhorn CLI supports darwin platform 9532 - @derekbit @chriscchien
Improvement
- [IMPROVEMENT] V2 Data engine avoids changing the data of a lvol when decoupling it from 9922 - @DamiaSan @roger-ryao
- [IMPROVEMENT] Bump nfs-ganesha in longhorn-share-manager from v6.3 to v6.5 10194 - @derekbit @chriscchien
- [IMPROVEMENT] Change the AIO disk block size to 512 bytes for v2 data engine 10053 - @derekbit @chriscchien
- [IMPROVEMENT] No need to truncate block-type disk's StorageAvailable value 10121 - @derekbit @chriscchien
- [IMPROVEMENT] Separate the default backup target settings from default settings 10089 - @mantissahz @roger-ryao
- [IMPROVEMENT] Add support for JSON log format configuration in Longhorn components (UI, driver) 10064 - @IshinMV @chriscchien
- [IMPROVEMENT] No need to start
tgtd
in an instance-manager pod for v2 data engine 9941 - @derekbit @roger-ryao - [IMPROVEMENT] Configure the log level of other system and user managed components via longhorn manager setting 6702 - @james-munson @roger-ryao
- [IMPROVEMENT] Longhorn CLI should install
cryptsetup
9315 - @mantissahz @roger-ryao - [IMPROVEMENT] Collect and display disk space usage for the backing images 8757 - @ChanYiLin @roger-ryao
- [IMPROVEMENT] Check NFS versions in /etc/nfsmount.conf instead 9830 - @COLDTURNIP @roger-ryao
- [IMPROVEMENT] Change misleading error message to warning level 9916 - @yangchiu @derekbit
- [IMPROVEMENT] No need to redirect
spdk_tgt
log to/var/log/spdk_tgt.log
9926 - @derekbit @chriscchien - [UI][IMPROVEMENT] Make backup wait until there is no backup being delete and Add the progress time 8750 - @a110605
- [IMPROVEMENT] Allow specify data engine version for the default storageclass during Helm installation 9584 - @shuo-wu @chriscchien
- [IMPROVEMENT] Building longhorn-manager takes long time 8744 - @derekbit @chriscchien
- [IMPROVEMENT] Reject strict-local + RWX volume creation 6735 - @COLDTURNIP @chriscchien
- [IMPROVEMENT] Restored volume or other operations should be allowed on the old and running instance-manager pods 9383 - @derekbit @chriscchien
- [IMPROVEMENT] Make backup deletion async and force backup creation wait until there is no backup being delete 8746 - @ChanYiLin @roger-ryao
- [IMPROVEMENT][UI] Attach table search keyword to URL on Backup pages 9974 - @chriscchien @houhoucoop
- [IMPROVEMENT] Busrt ISCSI Connection Errors, and IM Pod Restarting to make LH Volume disconnection 9851 - @ChanYiLin @chriscchien
- [IMPROVEMENT] Why is it not possible to change the replica count in v2 longhorn volume? 9805 - @hookak @chriscchien
- [IMPROVEMENT][UI] Add backupBackingImage table in backup page with tabs 8956 - @chriscchien @houhoucoop
- [IMPROVEMENT] Decrease the reconnect delay of v2 volume nvme initiator 9818 - @derekbit @chriscchien
- [UI][IMPROVEMENT] Improve the volume size information on UI 8843 - @yangchiu @houhoucoop
- [IMPROVEMENT] Add dmsetup and dmcrypt utilities check in cli 8217 - @COLDTURNIP @roger-ryao
- [UI IMPROVEMENT] Collect and display disk space usage for the backing images 9325 - @chriscchien @houhoucoop
- [IMPROVEMENT] Check kernel module
dm_crypt
on host machines 9153 - @mantissahz @roger-ryao - [IMPROVEMENT] Logging the reason why the instance manager pod is going to be deleted. 9886 - @derekbit @chriscchien
- [IMPROVEMENT] Remove isCLIAPIVersionOne related codes 7191 - @derekbit @chriscchien
- [IMPROVEMENT] Prevent Volume Resize Stuck 6633 - @c3y1huang @roger-ryao
- [IMPROVEMENT] Expose EngineImage CLIAPIVersion and ControllerAPIVersion 6531 - @chriscchien @houhoucoop
- [IMPROVEMENT] Update longhorn-share-manager's nfs-ganesha to v6.2 9614 - @derekbit @chriscchien
- [UI][IMPROVEMENT] Display
ReUploadedDataSize
andNewlyUploadedDataSize
of each backup on Backup page 8975 - @yangchiu @houhoucoop - [IMPROVEMENT] Remove the default CSI component images in longhorn-manager 9580 - @yangchiu @c3y1huang
- [IMPROVEMENT] the
if-not-present
volume backup policy should also check if the latest backup is up-to-date 6027 - @c3y1huang @chriscchien - [IMPROVEMENT] longhorn/go-common-libs should support Darwin 9487 - @Yu-Jack @chriscchien
- [IMPROVEMENT] Enable Prometheus metrics of the CSI sidecar components 7938 - @yangchiu @ChanYiLin
- [IMPROVEMENT] Talos support for environment check in longhorn manager 9558 - @yangchiu @c3y1huang
- [IMPROVEMENT] Refactor condition icon and text in edit node and disk modal 9238 - @a110605
- [IMPROVEMENT] Read-only volu...
Longhorn v1.6.4
Longhorn v1.6.4 Release Notes
Longhorn 1.6.4 introduces several improvements and bug fixes that are intended to improve system quality, resilience, and stability.
The Longhorn team appreciates your contributions and expects to receive feedback regarding this release.
Note
For more information about release-related terminology, see Releases.
Installation
Important
Ensure that your cluster is running Kubernetes v1.21 or later before installing Longhorn v1.6.4.
You can install Longhorn using a variety of tools, including Rancher, Kubectl, and Helm. For more information about installation methods and requirements, see Quick Installation in the Longhorn documentation.
Upgrade
Important
Ensure that your cluster is running Kubernetes v1.21 or later before upgrading from Longhorn v1.5.x or v1.6.x (< v1.6.4) to v1.6.4.
Longhorn only allows upgrades from supported versions. For more information about upgrade paths and procedures, see Upgrade in the Longhorn documentation.
Deprecation & Incompatibilities
For information about important changes, including feature incompatibility, deprecation, and removal, see Important Notes in the Longhorn documentation.
Post-Release Known Issues
For information about issues identified after this release, see Release-Known-Issues.
Resolved Issues
Improvement
- [BACKPORT][v1.6.4][IMPROVEMENT] Add support for JSON log format configuration in Longhorn components (UI, driver) 10080 - @chriscchien
- [BACKPORT][v1.6.4][IMPROVEMENT] Logging the reason why the instance manager pod is going to be deleted. 9888 - @derekbit @chriscchien
- [BACKPORT][v1.6.4][IMPROVEMENT] Check NFS versions in /etc/nfsmount.conf instead 9832 - @COLDTURNIP @yangchiu
- [BACKPORT][v1.6.4][IMPROVEMENT] Prevent Volume Resize Stuck 9913 - @c3y1huang @roger-ryao
- [BACKPORT][v1.6.4][IMPROVEMENT] Reject strict-local + RWX volume creation 9931 - @COLDTURNIP @yangchiu
- [BACKPORT][v1.6.4][IMPROVEMENT] Configure the log level of other system and user managed components via longhorn manager setting 9618 - @yangchiu @james-munson
- [BACKPORT][v1.6.4][IMPROVEMENT] Change misleading error message to warning level 9918 - @yangchiu @derekbit
- [BACKPORT][v1.6.4][IMPROVEMENT] Building longhorn-manager takes long time 9694 - @derekbit @chriscchien
- [BACKPORT][v1.6.4][IMPROVEMENT] Remove mirrored openshift image from Longhorn 9599 - @derekbit @chriscchien
Bug
- [BUG][v1.6.x-head] Share manager pod kept restarting 10096 - @c3y1huang @chriscchien
- [BACKPORT][v1.6.4][BUG] Webhook servers initialization blocks longhorn-manager from running 10067 - @c3y1huang
- [BACKPORT][v1.6.4][BUG] Missing
fromBackup
Parameter in API Request When Restoring Multiple Files from Backup List 10065 - @a110605 @chriscchien - [BACKPORT][v1.6.4][BUG] Busrt ISCSI Connection Errors, and IM Pod Restarting to make LH Volume disconnection 9890 - @yangchiu @ChanYiLin @chriscchien
- [BACKPORT][v1.6.4][BUG] Failed to inspect the backup backing image information if NFS backup target URL with options 9704 - @yangchiu @mantissahz @chriscchien
- [BACKPORT][v1.6.4][BUG] Error notification appears on the volume backup details page 10070 - @a110605 @houhoucoop
- [BACKPORT][v1.6.4][BUG][v1.8.x] Unable to add block disk after node deleted and added back 10041 -
- [BACKPORT][v1.6.4][BUG] Detached Volume Stuck in Attached State During Node Eviction 9809 - @c3y1huang @roger-ryao
- [BACKPORT][v1.6.4][BUG] Backup progress should not add block failed to upload to successful count 9792 - @yangchiu @derekbit
- [BACKPORT][v1.6.4][BUG] S3 Backup target reverts randomly to previous value 9589 - @c3y1huang
- [BACKPORT][v1.6.4][BUG] Old backups are not cleaned up after timeout 9730 - @yangchiu @mantissahz
- [BACKPORT][v1.6.4][BUG] Share manager is permanently stuck in stopping/error if we shutdown the node of share manager pod. This makes RWX PVC cannot attach to any new node 9855 - @yangchiu @PhanLe1010
- [BACKPORT][v1.6.4][BUG] Test case test_node_eviction_multiple_volume failed to reschedule replicas after volume detached 9867 - @yangchiu @c3y1huang
- [BACKPORT][v1.6.4][BUG] DR volume fails to reattach and faulted after node stop and start during incremental restore 9802 - @c3y1huang @roger-ryao
- [BACKPORT][v1.6.4][BUG] Fail to resize RWX PVC at filesystem resizing step 9737 - @james-munson
- [BACKPORT][v1.6.4][BUG] Test case
Stopped replicas on deleted nodes should not be counted as healthy replicas when draining nodes
fails 9625 - @yangchiu @derekbit - [BACKPORT][v1.6.4][BUG] Pre-upgrade pod should event the reason for any failures. 9644 - @yangchiu @james-munson
- [BACKPORT][v1.6.4][BUG] All Backups are lost in the Backup Target if the NFS Service Disconnects and Reconnects again 9543 - @yangchiu @mantissahz
- [BACKPORT][v1.6.4][BUG] kubectl drain node is blocked by unexpected orphan engine processes 9443 - @ejweber
Misc
- [TASK] Fix CVE issues for v1.6.4 9898 - @c3y1huang
- [TASK] Update base image version to 15.6 for v1.6.4 10073 - @c3y1huang
- [BACKPORT][v1.6.4][TASK] Install the latest grpc_health_probe at build time 9716 - @yangchiu @c3y1huang
Contributors
Longhorn v1.6.4-rc2
DON'T UPGRADE from/to any RC/Preview/Sprint releases because the operation is not supported.
Resolved Issues in this release
Improvement
- [BACKPORT][v1.6.4][IMPROVEMENT] Add support for JSON log format configuration in Longhorn components (UI, driver) 10080 - @chriscchien
- [BACKPORT][v1.6.4][IMPROVEMENT] Logging the reason why the instance manager pod is going to be deleted. 9888 - @derekbit @chriscchien
- [BACKPORT][v1.6.4][IMPROVEMENT] Check NFS versions in /etc/nfsmount.conf instead 9832 - @COLDTURNIP @yangchiu
- [BACKPORT][v1.6.4][IMPROVEMENT] Prevent Volume Resize Stuck 9913 - @c3y1huang @roger-ryao
- [BACKPORT][v1.6.4][IMPROVEMENT] Reject strict-local + RWX volume creation 9931 - @COLDTURNIP @yangchiu
- [BACKPORT][v1.6.4][IMPROVEMENT] Configure the log level of other system and user managed components via longhorn manager setting 9618 - @yangchiu @james-munson
- [BACKPORT][v1.6.4][IMPROVEMENT] Change misleading error message to warning level 9918 - @yangchiu @derekbit
- [BACKPORT][v1.6.4][IMPROVEMENT] Building longhorn-manager takes long time 9694 - @derekbit @chriscchien
- [BACKPORT][v1.6.4][IMPROVEMENT] Remove mirrored openshift image from Longhorn 9599 - @derekbit @chriscchien
Bug
- [BUG][v1.6.x-head] Share manager pod kept restarting 10096 - @c3y1huang @chriscchien
- [BACKPORT][v1.6.4][BUG] Webhook servers initialization blocks longhorn-manager from running 10067 - @c3y1huang
- [BACKPORT][v1.6.4][BUG] Missing
fromBackup
Parameter in API Request When Restoring Multiple Files from Backup List 10065 - @a110605 @chriscchien - [BACKPORT][v1.6.4][BUG] Busrt ISCSI Connection Errors, and IM Pod Restarting to make LH Volume disconnection 9890 - @yangchiu @ChanYiLin @chriscchien
- [BACKPORT][v1.6.4][BUG] Failed to inspect the backup backing image information if NFS backup target URL with options 9704 - @yangchiu @mantissahz @chriscchien
- [BACKPORT][v1.6.4][BUG] Error notification appears on the volume backup details page 10070 - @a110605 @houhoucoop
- [BACKPORT][v1.6.4][BUG][v1.8.x] Unable to add block disk after node deleted and added back 10041 -
- [BACKPORT][v1.6.4][BUG] Detached Volume Stuck in Attached State During Node Eviction 9809 - @c3y1huang @roger-ryao
- [BACKPORT][v1.6.4][BUG] Backup progress should not add block failed to upload to successful count 9792 - @yangchiu @derekbit
- [BACKPORT][v1.6.4][BUG] S3 Backup target reverts randomly to previous value 9589 - @c3y1huang
- [BACKPORT][v1.6.4][BUG] Old backups are not cleaned up after timeout 9730 - @yangchiu @mantissahz
- [BACKPORT][v1.6.4][BUG] Share manager is permanently stuck in stopping/error if we shutdown the node of share manager pod. This makes RWX PVC cannot attach to any new node 9855 - @yangchiu @PhanLe1010
- [BACKPORT][v1.6.4][BUG] Test case test_node_eviction_multiple_volume failed to reschedule replicas after volume detached 9867 - @yangchiu @c3y1huang
- [BACKPORT][v1.6.4][BUG] DR volume fails to reattach and faulted after node stop and start during incremental restore 9802 - @c3y1huang @roger-ryao
- [BACKPORT][v1.6.4][BUG] Fail to resize RWX PVC at filesystem resizing step 9737 - @james-munson
- [BACKPORT][v1.6.4][BUG] Test case
Stopped replicas on deleted nodes should not be counted as healthy replicas when draining nodes
fails 9625 - @yangchiu @derekbit - [BACKPORT][v1.6.4][BUG] Pre-upgrade pod should event the reason for any failures. 9644 - @yangchiu @james-munson
- [BACKPORT][v1.6.4][BUG] All Backups are lost in the Backup Target if the NFS Service Disconnects and Reconnects again 9543 - @yangchiu @mantissahz
- [BACKPORT][v1.6.4][BUG] kubectl drain node is blocked by unexpected orphan engine processes 9443 - @ejweber
Misc
- [TASK] Fix CVE issues for v1.6.4 9898 - @c3y1huang
- [TASK] Update base image version to 15.6 for v1.6.4 10073 - @c3y1huang
- [BACKPORT][v1.6.4][TASK] Install the latest grpc_health_probe at build time 9716 - @yangchiu @c3y1huang