From 5b798b78830cf109f49ca75e633a90b31671bc6e Mon Sep 17 00:00:00 2001 From: khushboo-rancher Date: Wed, 7 Aug 2024 22:39:17 +0000 Subject: [PATCH] Update testing docs Signed-off-by: khushboo-rancher --- index.xml | 5 +- manual/pre-release/v2-volume/index.xml | 5 +- .../v2-volume/sanity-check/index.html | 74 ++++++++++++++++--- 3 files changed, 69 insertions(+), 15 deletions(-) diff --git a/index.xml b/index.xml index 7fb6b6b84c..b7235ddb3e 100644 --- a/index.xml +++ b/index.xml @@ -1783,8 +1783,9 @@ Test steps: Kubectl apply -f Install Longhorn v1.0.2 kubectl apply -f https://r Mon, 01 Jan 0001 00:00:00 +0000 https://longhorn.github.io/longhorn-tests/manual/pre-release/v2-volume/sanity-check/ - Related doc: https://longhorn.io/docs/1.6.0/v2-data-engine/features/ - Support both amd64 and arm64 Volume creation, attachment, detachment and deletion Filesystem trim Replica online rebuilding Orphaned replica management Snapshot creation, deletion and reversion Volume backup and restoration Selective v2 Data Engine activation Upgrade Longhorn from previous version with v2 volume v2 volume live upgrade + Related doc: https://longhorn.io/docs/1.7.0/v2-data-engine/features/ +Tests Prerequisite Load the kernel modules on the each Longhorn node modprobe vfio_pci modprobe uio_pci_generic Test Items 1. Support both AMD64 and AMD64 2. Volume creation, attachment, detachment and deletion 3. Block disk management 4. Orphaned replica management Creating a v2 Orphan Replica in Longhorn Execute the go-spdk-helper Command in the Instance Manager Pod: + Use the following kubectl command to execute the go-spdk-helper tool directly within the specified instance manager pod. diff --git a/manual/pre-release/v2-volume/index.xml b/manual/pre-release/v2-volume/index.xml index 33bf702572..37b8a801de 100644 --- a/manual/pre-release/v2-volume/index.xml +++ b/manual/pre-release/v2-volume/index.xml @@ -12,8 +12,9 @@ Mon, 01 Jan 0001 00:00:00 +0000 https://longhorn.github.io/longhorn-tests/manual/pre-release/v2-volume/sanity-check/ - Related doc: https://longhorn.io/docs/1.6.0/v2-data-engine/features/ - Support both amd64 and arm64 Volume creation, attachment, detachment and deletion Filesystem trim Replica online rebuilding Orphaned replica management Snapshot creation, deletion and reversion Volume backup and restoration Selective v2 Data Engine activation Upgrade Longhorn from previous version with v2 volume v2 volume live upgrade + Related doc: https://longhorn.io/docs/1.7.0/v2-data-engine/features/ +Tests Prerequisite Load the kernel modules on the each Longhorn node modprobe vfio_pci modprobe uio_pci_generic Test Items 1. Support both AMD64 and AMD64 2. Volume creation, attachment, detachment and deletion 3. Block disk management 4. Orphaned replica management Creating a v2 Orphan Replica in Longhorn Execute the go-spdk-helper Command in the Instance Manager Pod: + Use the following kubectl command to execute the go-spdk-helper tool directly within the specified instance manager pod. diff --git a/manual/pre-release/v2-volume/sanity-check/index.html b/manual/pre-release/v2-volume/sanity-check/index.html index 65ce0d6c00..88bcbc7419 100644 --- a/manual/pre-release/v2-volume/sanity-check/index.html +++ b/manual/pre-release/v2-volume/sanity-check/index.html @@ -822,19 +822,71 @@

v2 volume sanity check

-

https://longhorn.io/docs/1.6.0/v2-data-engine/features/

+

https://longhorn.io/docs/1.7.0/v2-data-engine/features/

+

Tests Prerequisite

+

Test Items

+

1. Support both AMD64 and AMD64

+

2. Volume creation, attachment, detachment and deletion

+

3. Block disk management

+

4. Orphaned replica management

+
Creating a v2 Orphan Replica in Longhorn
+
    +
  1. +

    Execute the go-spdk-helper Command in the Instance Manager Pod:

    +
      +
    • Use the following kubectl command to execute the go-spdk-helper tool directly within the specified instance manager pod. This command will create a new logical volume (LVOL) in the desired logical volume store (LVSTORE).
    • +
    • Command syntax: +
      kubectl -n longhorn-system exec -it <instance-manager-pod-name> -- /bin/bash -c "go-spdk-helper lvol create --lvs-name <DISK_NAME> --lvol-name <LVOL_NAME> --size <LVOL_SIZE_IN_MIB>"
      +
    • +
    • Replace the placeholders with your specific values: +
        +
      • <instance-manager-pod-name>: The name of your instance manager pod.
      • +
      • <LVSTORE_NAME>: The name of the volume where the replica will be created.
      • +
      • <DISK_NAME>: The name for the disk on the node.
      • +
      • <LVOL_SIZE_IN_MIB>: The size of the logical volume in MiB.
      • +
      +
    +
  2. +
  3. +

    Example:

    +
      +
    • Here’s an example where an LVOL named test001 is created in the LVSTORE disk-2 with a size of 12400 MiB: +
      kubectl -n longhorn-system exec -it instance-manager-cddd0dac94705fc3e267c2e157224257 -- /bin/bash -c "go-spdk-helper lvol create --lvs-name disk-2 --lvol-name test001 --size 12400"
      +
    • +
    +
  4. +
  5. +

    Verify the Creation:

    +
      +
    • After executing the command, you should receive a JSON output similar to the following: +
      {
      +    "alias": "disk-2/test001",
      +    "uuid": "57666291-2516-4140-af6d-cc086c8ae98c"
      +}
      +
    • +
    • This output confirms that the LVOL was successfully created with the specified alias and UUID.
    • +
    +
  6. +
+

5. Snapshot creation, deletion and reversion

+

6. Volume backup and restoration

+

7. Selective v2 Data Engine activation

+

8. Upgrade Longhorn from previous version with v2 volume

+

9. v2 volume live upgrade for data plane

+
+

Note:

+

In this item, it should be excluded.

+

Ref: https://github.com/longhorn/longhorn/issues/6001#issuecomment-2272532533

+
+

10. Filesystem trim

+

11. Replica online rebuilding

[Edit]