doc(talos): support for v2 data engine

longhorn/longhorn-7791 Signed-off-by: Chin-Ya Huang <[email protected]>
longhorn · Sep 3, 2024 · b182ba4 · b182ba4
1 parent 4ca2728
commit b182ba4
Show file tree

Hide file tree

Showing 2 changed files with 26 additions and 2 deletions.
diff --git a/content/docs/1.8.0/advanced-resources/os-distro-specific/talos-linux-support.md b/content/docs/1.8.0/advanced-resources/os-distro-specific/talos-linux-support.md
@@ -56,9 +56,25 @@ machine:
 
 For detailed instructions, see the Talos documentation on [Editing Machine Configuration](https://www.talos.dev/v1.6/talos-guides/configuration/editing-machine-configuration/).
 
-## Limitations
+## V2 Data Engine
 
-- Exclusive to v1 data volume: currently, within a Talos Linux cluster, Longhorn only supports v1 data volume. The v2 data volume isn't currently supported in this environment.
+To use V2 volumes, all nodes must meet the V2 Data Engine [prerequisites](../../../v2-data-engine/prerequisites#prerequisites).
+
+```yaml
+machine:
+  sysctls:
+    vm.nr_hugepages: "1024"
+  kernel:
+    modules:
+      - name: nvme_tcp
+      - name: vfio_pci
+#     - name: uio_pci_generic
+```
+
+> **Note:**
+> Talos Linux v1.7.x and earlier versions do not include the `uio_pci_generic` kernel module. If your system device supports `vfio_pci`, which is the preferred kernel module for SPDK application deployment, you are not required to install and enable the `uio_pci_generic` kernel driver. For more information, see [System Configuration User Guide](https://spdk.io/doc/system_configuration.html) in the SPDK documentation.
+>
+> You can use `uio_pci_generic` if `vfio_pci` is incompatible with your system or specific hardware. Future versions of Talos Linux are expected to include native support for `uio_pci_generic`. For more information, see [Issue #9236](https://github.com/siderolabs/talos/issues/9236).
 
 ## Talos Linux Upgrades
 

diff --git a/content/docs/1.8.0/important-notes/_index.md b/content/docs/1.8.0/important-notes/_index.md
@@ -25,6 +25,8 @@ Please see [here](https://github.com/longhorn/longhorn/releases/tag/v{{< current
   - [Auto-Balance Pressured Disks](#auto-balance-pressured-disks)
 - [Networking](#networking)
   - [Storage Network Support for Read-Write-Many (RWX) Volumes](#storage-network-support-for-read-write-many-rwx-volumes)
+- [OS Distro Specific](#os-distro-specific)
+  - [V2 Data Engine Support for Talos Linux](#talos-linux)
 - [V2 Data Engine](#v2-data-engine)
   - [Longhorn System Upgrade](#longhorn-system-upgrade)
   - [Enable Both `vfio_pci` and `uio_pci_generic` Kernel Modules](#enable-both-vfio_pci-and-uio_pci_generic-kernel-modules)
@@ -193,6 +195,12 @@ To apply the storage network to existing RWX volumes, you must detach the volume
 
 For more information, see [Issue #8184](https://github.com/longhorn/longhorn/issues/8184).
 
+## OS Distro Specific
+
+### Talos Linux
+
+Longhorn v1.8.0 and later versions support usage of V2 volumes in Talos Linux clusters. To use V2 volumes, ensure that all nodes meet the V2 Data Engine prerequisites. For more information, see [Talos Linux Support: V2 Data Engine](../advanced-resources/os-distro-specific/talos-linux-support#v2-data-engine).
+
 ## V2 Data Engine
 
 ### Longhorn System Upgrade