Skip to content

docs: add known issue for I/O stuck on ARM platforms#1072

Open
WebberHuang1118 wants to merge 1 commit into
harvester:mainfrom
WebberHuang1118:issue-10710
Open

docs: add known issue for I/O stuck on ARM platforms#1072
WebberHuang1118 wants to merge 1 commit into
harvester:mainfrom
WebberHuang1118:issue-10710

Conversation

@WebberHuang1118

Copy link
Copy Markdown
Member

Problem:

harvester/harvester#10710

Solution:

document update for this known issue

Related Issue(s):

harvester/harvester#10710

Test plan:

Additional documentation or context

Signed-off-by: Webber Huang <webberhuang@suse.com>
@github-actions

github-actions Bot commented Jul 6, 2026

Copy link
Copy Markdown
Name Link
🔨 Latest commit 38a41f7
😎 Deploy Preview https://6a4b889b67c00700851e5351--harvester-preview.netlify.app

@brandboat brandboat left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, thanks!

@mergify

mergify Bot commented Jul 9, 2026

Copy link
Copy Markdown

Tick the box to add this pull request to the merge queue (same as @mergifyio queue).

  • Queue this pull request

@jillian-maroket jillian-maroket left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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).

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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).

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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
```

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.
:::

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants