docs: add known issue for I/O stuck on ARM platforms#1072
Open
WebberHuang1118 wants to merge 1 commit into
Open
docs: add known issue for I/O stuck on ARM platforms#1072WebberHuang1118 wants to merge 1 commit into
WebberHuang1118 wants to merge 1 commit into
Conversation
Signed-off-by: Webber Huang <webberhuang@suse.com>
|
|
Tick the box to add this pull request to the merge queue (same as
|
jillian-maroket
requested changes
Jul 9, 2026
jillian-maroket
left a comment
Contributor
There was a problem hiding this comment.
The draft is good. My suggested changes are more structural in nature.
|
|
||
| ### I/O Operations May Become Stuck on ARM Platforms | ||
|
|
||
| On ARM platforms, Longhorn V2 disks that use the SPDK NVMe bdev driver may experience stuck I/O operations. For more information, see [harvester/harvester#10710](https://github.com/harvester/harvester/issues/10710). |
Contributor
There was a problem hiding this comment.
Suggested change
| On ARM platforms, Longhorn V2 disks that use the SPDK NVMe bdev driver may experience stuck I/O operations. For more information, see [harvester/harvester#10710](https://github.com/harvester/harvester/issues/10710). | |
| On ARM64 platforms, Longhorn V2 disks that use the SPDK NVMe bdev driver can experience stalled I/O operations. For more information, see issue [#10710](https://github.com/harvester/harvester/issues/10710). |
Comment on lines
+95
to
+96
| 1. [Remove the related Longhorn V2 disk](../host/host.md#remove-disks). | ||
| 1. [Add the Longhorn V2 disk again](../host/host.md#add-additional-disks). |
Contributor
There was a problem hiding this comment.
Suggested change
| 1. [Remove the related Longhorn V2 disk](../host/host.md#remove-disks). | |
| 1. [Add the Longhorn V2 disk again](../host/host.md#add-additional-disks). | |
| 1. [Remove the affected Longhorn V2 disk](../host/host.md#remove-disks). | |
| 1. [Add the Longhorn V2 disk again](../host/host.md#add-additional-disks). | |
| 1. Verify that the workaround was successful. | |
| ``` | |
| kubectl -n longhorn-system get blockdevices.harvesterhci.io -o yaml | |
| ``` | |
| The matching `BlockDevice` custom resource should have the following values: | |
| ``` | |
| spec: | |
| provisioner: | |
| longhorn: | |
| diskDriver: aio | |
| engineVersion: LonghornV2 | |
| status: | |
| provisionPhase: Provisioned | |
| state: Active | |
| ``` |
Comment on lines
+98
to
+117
| Starting with Harvester v1.9.0, the default disk driver for Longhorn V2 disks is `aio`. Re-adding the disk allows Harvester to use the default driver and avoid the I/O issue on ARM platforms. For more information, see [harvester/harvester#11041](https://github.com/harvester/harvester/issues/11041). | ||
|
|
||
| To verify that the workaround was successful, run the following command: | ||
|
|
||
| ``` | ||
| kubectl -n longhorn-system get blockdevices.harvesterhci.io -o yaml | ||
| ``` | ||
|
|
||
| The matching `BlockDevice` custom resource should have the following values: | ||
|
|
||
| ``` | ||
| spec: | ||
| provisioner: | ||
| longhorn: | ||
| diskDriver: aio | ||
| engineVersion: LonghornV2 | ||
| status: | ||
| provisionPhase: Provisioned | ||
| state: Active | ||
| ``` |
Contributor
There was a problem hiding this comment.
Suggested change
| Starting with Harvester v1.9.0, the default disk driver for Longhorn V2 disks is `aio`. Re-adding the disk allows Harvester to use the default driver and avoid the I/O issue on ARM platforms. For more information, see [harvester/harvester#11041](https://github.com/harvester/harvester/issues/11041). | |
| To verify that the workaround was successful, run the following command: | |
| ``` | |
| kubectl -n longhorn-system get blockdevices.harvesterhci.io -o yaml | |
| ``` | |
| The matching `BlockDevice` custom resource should have the following values: | |
| ``` | |
| spec: | |
| provisioner: | |
| longhorn: | |
| diskDriver: aio | |
| engineVersion: LonghornV2 | |
| status: | |
| provisionPhase: Provisioned | |
| state: Active | |
| ``` | |
| :::note | |
| Starting with Harvester v1.9.0, the default disk driver for Longhorn V2 volumes is changed to `AIO`. Removing and then re-adding the affected disk forces Harvester to use this new default driver and resolves the stalled I/O operations on ARM64 platforms. | |
| ::: |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Problem:
harvester/harvester#10710
Solution:
document update for this known issue
Related Issue(s):
harvester/harvester#10710
Test plan:
Additional documentation or context