openebs · balaharish7 · Feb 6, 2025 · Jan 22, 2025 · Jan 27, 2025 · Feb 5, 2025
diff --git a/docs/main/Solutioning/backup-and-restore/velero-br-fs.md b/docs/main/Solutioning/backup-and-restore/velero-br-fs.md
@@ -97,7 +97,7 @@ velero-6b9b99494b-rkppw   1/1     Running   0          20h
 
 ### Deploy the Application with CSI Backed Volumes
 
-Before installing the application with CSI backed volumes, install the storage class and the volume snapshot class for the OpenEBS CSI driver by applying the below yaml to your cluster. Refer to the [Replicated PV Mayastor Configuration Documentation](../../user-guides/replicated-storage-user-guide/replicated-pv-mayastor/rs-configuration.md#create-replicated-pv-mayastor-storageclasss) for more details.
+Before installing the application with CSI backed volumes, install the storage class and the volume snapshot class for the OpenEBS CSI driver by applying the below yaml to your cluster. Refer to the [Replicated PV Mayastor Configuration Documentation](../../user-guides/replicated-storage-user-guide/replicated-pv-mayastor/configuration/rs-create-storageclass.md#create-storageclasss) for more details.
 
 :::info
 Volume snapshots for multi-replicas volume is supported only from OpenEBS v4.1. The annotation `velero.io/csi-volumesnapshot-class: "true"` must be added to the volume snapshot class or the Velero backup will fail.

diff --git a/docs/main/Solutioning/backup-and-restore/velero-br-rbv.md b/docs/main/Solutioning/backup-and-restore/velero-br-rbv.md
@@ -97,7 +97,7 @@ velero-6b9b99494b-kgvpk   1/1     Running   0          58s
 
 ### Deploy the Application with CSI Backed Volumes
 
-Before installing the application with CSI backed volumes, install the storage class and the volume snapshot class for the OpenEBS CSI driver by applying the below yaml to your cluster. Refer to the [Replicated PV Mayastor Configuration Documentation](../../user-guides/replicated-storage-user-guide/replicated-pv-mayastor/rs-configuration.md#create-replicated-pv-mayastor-storageclasss) for more details.
+Before installing the application with CSI backed volumes, install the storage class and the volume snapshot class for the OpenEBS CSI driver by applying the below yaml to your cluster. Refer to the [Replicated PV Mayastor Configuration Documentation](../../user-guides/replicated-storage-user-guide/replicated-pv-mayastor/configuration/rs-create-storageclass.md#create-storageclasss) for more details.
 
 :::info
 Volume snapshots for multi-replica volume are supported only from OpenEBS v4.1. The annotation `velero.io/csi-volumesnapshot-class: "true"` must be added to the volume snapshot class or the Velero backup will fail.

diff --git a/docs/main/Solutioning/openebs-on-kubernetes-platforms/EKS/eks-isv.md b/docs/main/Solutioning/openebs-on-kubernetes-platforms/EKS/eks-isv.md
@@ -229,7 +229,7 @@ pool-on-node-3   ip-10-0-1-222.ec2.internal   Created   Online        2997039923
 
 ## Configuration
 
-- Refer to the [Replicated PV Mayastor Configuration Documentation](../../../user-guides/replicated-storage-user-guide/replicated-pv-mayastor/rs-configuration.md#create-replicated-pv-mayastor-storageclasss) for instructions regarding StorageClass creation.
+- Refer to the [Replicated PV Mayastor Configuration Documentation](../../../user-guides/replicated-storage-user-guide/replicated-pv-mayastor/configuration/rs-create-storageclass.md) for instructions regarding StorageClass creation.
 
 Replicated PV Mayastor dynamically provisions PersistentVolumes (PVs) based on StorageClass definitions created. Parameters of the definition are used to set the characteristics and behaviour of its associated PVs. We have created a storage class with three replication as below. 
 
@@ -256,7 +256,7 @@ storageclass.storage.k8s.io/mayastor-3 created
 
 ## Deployment
 
-- Refer to the [Deploy an Application Documentation](../../../user-guides/replicated-storage-user-guide/replicated-pv-mayastor/rs-deployment.md) for instructions regarding PVC creation and deploying an application.
+- Refer to the [Deploy an Application Documentation](../../../user-guides/replicated-storage-user-guide/replicated-pv-mayastor/configuration/rs-deployment.md) for instructions regarding PVC creation and deploying an application.
 
 - If all verification steps in the preceding stages were satisfied, then Replicated PV Mayastor has been successfully deployed within the cluster. In order to verify basic functionality, we will now dynamically provision a Persistent Volume based on a Replicated PV Mayastor StorageClass.
 

diff --git a/docs/main/Solutioning/openebs-on-kubernetes-platforms/EKS/eks.md b/docs/main/Solutioning/openebs-on-kubernetes-platforms/EKS/eks.md
@@ -102,7 +102,7 @@ pool-on-node-3   ip-10-0-3-54.ec2.internal    Created   Online        1072483532
 
 ## Configuration
 
-- Refer to the [Replicated PV Mayastor Configuration Documentation](../../../user-guides/replicated-storage-user-guide/replicated-pv-mayastor/rs-configuration.md#create-replicated-pv-mayastor-storageclasss) for instructions regarding StorageClass creation.
+- Refer to the [Replicated PV Mayastor Configuration Documentation](../../../user-guides/replicated-storage-user-guide/replicated-pv-mayastor/configuration/rs-create-storageclass.md) for instructions regarding StorageClass creation.
 
 Replicated PV Mayastor dynamically provisions PersistentVolumes (PVs) based on StorageClass definitions created. Parameters of the definition are used to set the characteristics and behaviour of its associated PVs. Most importantly StorageClass definition is used to control the level of data protection afforded to it (i.e. the number of synchronous data replicas that are maintained for purposes of redundancy). It is possible to create any number of StorageClass definitions, spanning all permitted parameter permutations. See the below example.
 
@@ -129,7 +129,7 @@ storageclass.storage.k8s.io/mayastor-3 created
 
 ## Deployment
 
-- Refer to the [Deploy an Application Documentation](../../../user-guides/replicated-storage-user-guide/replicated-pv-mayastor/rs-deployment.md) for instructions regarding PVC creation and deploying an application.
+- Refer to the [Deploy an Application Documentation](../../../user-guides/replicated-storage-user-guide/replicated-pv-mayastor/configuration/rs-deployment.md) for instructions regarding PVC creation and deploying an application.
 
 - If all verification steps in the preceding stages were satisfied, then Replicated PV Mayastor has been successfully deployed within the cluster. In order to verify basic functionality, we will now dynamically provision a Persistent Volume based on a Replicated PV Mayastor StorageClass, mount that volume within a small test pod which we'll create, and use the [Flexible I/O Tester](https://github.com/axboe/fio) utility within that pod to check that I/O to the volume is processed correctly.
 

diff --git a/docs/main/Solutioning/openebs-on-kubernetes-platforms/gke.md b/docs/main/Solutioning/openebs-on-kubernetes-platforms/gke.md
@@ -214,9 +214,9 @@ diskpool.openebs.io/pool-1 created
 
 ## Configuration
 
-- Refer to the [Replicated PV Mayastor Configuration Documentation](../../user-guides/replicated-storage-user-guide/replicated-pv-mayastor/rs-configuration.md#create-replicated-pv-mayastor-storageclasss) for instructions regarding StorageClass creation.
+- Refer to the [Replicated PV Mayastor Configuration Documentation](../../user-guides/replicated-storage-user-guide/replicated-pv-mayastor/configuration/rs-create-storageclass.md#create-storageclasss) for instructions regarding StorageClass creation.
 
-- Refer to the [Deploy an Application Documentation](../../user-guides/replicated-storage-user-guide/replicated-pv-mayastor/rs-deployment.md) for instructions regarding PVC creation and deploying an application.
+- Refer to the [Deploy an Application Documentation](../../user-guides/replicated-storage-user-guide/replicated-pv-mayastor/configuration/rs-deployment.md) for instructions regarding PVC creation and deploying an application.
 
 ## Node Failure Scenario
 

diff --git a/docs/main/Solutioning/openebs-on-kubernetes-platforms/microkubernetes.md b/docs/main/Solutioning/openebs-on-kubernetes-platforms/microkubernetes.md
@@ -89,7 +89,7 @@ microk8s kubectl patch felixconfigurations default --patch '{"spec":{"featureDet
 > For more details about this issue, refer to the [GitHub issue](https://github.com/canonical/microk8s/issues/3695).
 
 :::info
-Refer to the [Replicated PV Mayastor Configuration Documentation](../../user-guides/replicated-storage-user-guide/replicated-pv-mayastor/rs-configuration.md) for further **Configuration of Replicated PV Mayastor** including storage pools, storage class, persistent volume claims, and application setup.
+Refer to the [Replicated PV Mayastor Configuration Documentation](../../user-guides/replicated-storage-user-guide/replicated-pv-mayastor/configuration/rs-create-diskpool.md) for further **Configuration of Replicated PV Mayastor** including storage pools, storage class, persistent volume claims, and application setup.
 :::
 
 ## See Also

diff --git a/docs/main/Solutioning/openebs-on-kubernetes-platforms/openshift.md b/docs/main/Solutioning/openebs-on-kubernetes-platforms/openshift.md
@@ -136,7 +136,7 @@ pool-on-worker   worker   Created   Online        32178700288   0      321787002
 
 ## Configuration
 
-- Refer to the [Replicated PV Mayastor Configuration Documentation](../../user-guides/replicated-storage-user-guide/replicated-pv-mayastor/rs-configuration.md#create-replicated-pv-mayastor-storageclasss) for instructions regarding StorageClass creation.
+- Refer to the [Replicated PV Mayastor Configuration Documentation](../../user-guides/replicated-storage-user-guide/replicated-pv-mayastor/configuration/rs-create-storageclass.md#create-storageclasss) for instructions regarding StorageClass creation.
 
 Replicated PV Mayastor dynamically provisions Persistent Volumes (PVs) based on StorageClass definitions that you create. Parameters of the definition are used to set the characteristics and behaviour of its associated PVs. Most importantly StorageClass definition is used to control the level of data protection afforded to it (i.e. the number of synchronous data replicas that are maintained for purposes of redundancy). It is possible to create any number of StorageClass definitions, spanning all permitted parameter permutations. An example is given below:
 
@@ -154,7 +154,7 @@ EOF
 storageclass.storage.k8s.io/mayastor-3 created
 ```
 
-- Refer to the [Deploy an Application Documentation](../../user-guides/replicated-storage-user-guide/replicated-pv-mayastor/rs-deployment.md) for instructions regarding PVC creation and deploying an application.
+- Refer to the [Deploy an Application Documentation](../../user-guides/replicated-storage-user-guide/replicated-pv-mayastor/configuration/rs-deployment.md) for instructions regarding PVC creation and deploying an application.
 
 If all verification steps in the preceding stages were satisfied, then the Replicated PV Mayastor has been successfully deployed within the cluster. To verify basic functionality, we will now dynamically provision a Persistent Volume based on a Replicated PV Mayastor StorageClass, mount that volume within a small test pod which we'll create, and use the Flexible I/O Tester utility within that pod to check that I/O to the volume is processed correctly.
 

diff --git a/docs/main/Solutioning/read-write-many/nfspvc.md b/docs/main/Solutioning/read-write-many/nfspvc.md
@@ -45,7 +45,7 @@ Make sure you have installed Replicated PV Mayastor before proceeding to the nex
 
 1. Create a Replicated PV Mayastor Pool.
 
-  Create a Replicated PV Mayastor pool that satisfies the performance and availability requirements. Refer to the [Replicated PV Mayastor Configuration documentation](../../user-guides/replicated-storage-user-guide/replicated-pv-mayastor/rs-configuration.md#create-diskpools) for more details.
+  Create a Replicated PV Mayastor pool that satisfies the performance and availability requirements. Refer to the [Replicated PV Mayastor Configuration documentation](../../user-guides/replicated-storage-user-guide/replicated-pv-mayastor/configuration/rs-create-diskpool.md) for more details.
 
   **Example of a Replicated PV Mayastor Pool**
 
@@ -66,7 +66,7 @@ Make sure you have installed Replicated PV Mayastor before proceeding to the nex
 
 2. Create a Replicated PV Mayastor Storage Class.
 
-  Create a storage class to point to the above created pool. Also, select the number of replicas and the default size of the volume. Refer to the [Replicated PV Mayastor Configuration documentation](../../user-guides/replicated-storage-user-guide/replicated-pv-mayastor/rs-configuration.md#create-replicated-pv-mayastor-storageclasss) for more details.
+  Create a storage class to point to the above created pool. Also, select the number of replicas and the default size of the volume. Refer to the [Replicated PV Mayastor Configuration documentation](../../user-guides/replicated-storage-user-guide/replicated-pv-mayastor/configuration/rs-create-storageclass.md) for more details.
 
   **Example of a Replicated PV Mayastor Storage Class**
 

diff --git a/docs/main/assets/tcp-vs-rdma.png b/docs/main/assets/tcp-vs-rdma.png
diff --git a/docs/main/faqs/faqs.md b/docs/main/faqs/faqs.md
@@ -433,7 +433,7 @@ Faulted replicas are automatically rebuilt in the background without IO disrupti
 
 ### How does OpenEBS provide high availability for stateful workloads?
 
-Refer to the [Replicated PV Mayastor Configuration documentation](../user-guides/replicated-storage-user-guide/replicated-pv-mayastor/rs-configuration.md#stsaffinitygroup) for more information.
+Refer to the [Replicated PV Mayastor Configuration documentation](../user-guides/replicated-storage-user-guide/replicated-pv-mayastor/configuration/rs-storage-class-parameters.md#stsaffinitygroup) for more information.
 
 [Go to top](#top)
 

diff --git a/...orage-user-guide/replicated-pv-mayastor/advanced-operations/snapshot-restore.md b/...orage-user-guide/replicated-pv-mayastor/advanced-operations/snapshot-restore.md
@@ -55,7 +55,7 @@ SNAPSHOT-ID                           ID
 
 ### Step 1: Create a StorageClass 
 
-To begin, you will need to create a StorageClass that defines the properties of the snapshot to be restored. Refer to [StorageClass Parameters](../../replicated-pv-mayastor/rs-configuration.md#storage-class-parameters) for more details. Use the following command to create the StorageClass:
+To begin, you will need to create a StorageClass that defines the properties of the snapshot to be restored. Refer to [Storage Class Parameters](../../replicated-pv-mayastor/configuration/rs-storage-class-parameters.md) for more details. Use the following command to create the StorageClass:
 
 :::info
 Currently, restores are thin-provisioned volumes created from a snapshot, Therefore, the storage class for the restored volume must also specify `thin: "true"`.