Skip to content

Commit 0bdc88e

Browse files
committed
docs: Update 4.3 Docs
Signed-off-by: Bala Harish <161304963+balaharish7@users.noreply.github.com>
1 parent 1dd4a2d commit 0bdc88e

File tree

2 files changed

+26
-0
lines changed

2 files changed

+26
-0
lines changed

docs/main/troubleshooting/troubleshooting-replicated-storage.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -356,6 +356,19 @@ The volume is created, but `xfs` is failing to mount.
356356
If you are trying to use `xfs` volumes and the cluster node hosts are running a kernel version less than 5.10, you may encounter a mount failure of the filesystem. This is due to the incompatibility of newer `xfsprogs` options. In order to alleviate this issue, it is recommended to upgrade the host node kernel version to 5.10 or higher.
357357
[Go to top](#top)
358358

359+
### io-engine Fails to Start Due to IOVA Allocation Error
360+
361+
When the io-engine fails to start with the error message `couldn't allocate memory due to IOVA exceeding limits of current DMA mask` it typically indicates that IOMMU is enabled on the host system.
362+
363+
**Workaround**
364+
365+
Configure the io-engine to use physical address (PA) mode by setting the following Helm parameter during Replicated PV Mayastor installation:
366+
367+
```
368+
--set openebs.mayastor.io_engine.envcontext=iova-mode=pa
369+
```
370+
[Go to top](#top)
371+
359372
## See Also
360373

361374
- [FAQs](../faqs/faqs.md)

docs/versioned_docs/version-4.3.x/troubleshooting/troubleshooting-replicated-storage.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -356,6 +356,19 @@ The volume is created, but `xfs` is failing to mount.
356356
If you are trying to use `xfs` volumes and the cluster node hosts are running a kernel version less than 5.10, you may encounter a mount failure of the filesystem. This is due to the incompatibility of newer `xfsprogs` options. In order to alleviate this issue, it is recommended to upgrade the host node kernel version to 5.10 or higher.
357357
[Go to top](#top)
358358

359+
### io-engine Fails to Start Due to IOVA Allocation Error
360+
361+
When the io-engine fails to start with the error message `couldn't allocate memory due to IOVA exceeding limits of current DMA mask` it typically indicates that IOMMU is enabled on the host system.
362+
363+
**Workaround**
364+
365+
Configure the io-engine to use physical address (PA) mode by setting the following Helm parameter during Replicated PV Mayastor installation:
366+
367+
```
368+
--set openebs.mayastor.io_engine.envcontext=iova-mode=pa
369+
```
370+
[Go to top](#top)
371+
359372
## See Also
360373

361374
- [FAQs](../faqs/faqs.md)

0 commit comments

Comments
 (0)