From dd1a569030b3028cfca014ff68a4c9a81aa503e9 Mon Sep 17 00:00:00 2001
From: Tahlia Richardson <3069029+tahliar@users.noreply.github.com>
Date: Fri, 24 Jan 2025 13:40:19 +1000
Subject: [PATCH] Add step for multiple cluster MD devices (#425)

* Add step for multiple cluster MD devices

bsc#1235513
jsc#DOCTEAM-1660

* Update from tech review
---
 xml/ha_cluster_md.xml | 46 ++++++++++++++++++++++++++++++-------------
 1 file changed, 32 insertions(+), 14 deletions(-)

diff --git a/xml/ha_cluster_md.xml b/xml/ha_cluster_md.xml
index 39c7ad278..b399df939 100644
--- a/xml/ha_cluster_md.xml
+++ b/xml/ha_cluster_md.xml
@@ -155,26 +155,44 @@ ARRAY /dev/md0 UUID=1d70f103:49740ef1:af2afce5:fcf6a489</screen>
   <para>Configure a CRM resource as follows:</para>
   <procedure>
    <step>
-    <para>Create a <systemitem>Raid1</systemitem> primitive:</para>
-    <screen>&prompt.crm.conf;<command>primitive</command> raider Raid1 \
+    <para>Create a <systemitem>Raid1</systemitem> primitive for the Cluster MD device:</para>
+    <screen>&prompt.crm.conf;<command>primitive raider Raid1 \
   params raidconf="/etc/mdadm.conf" raiddev=/dev/md0 \
   force_clones=true \
   op monitor timeout=20s interval=10 \
   op start timeout=20s interval=0 \
-  op stop timeout=20s interval=0 </screen>
+  op stop timeout=20s interval=0 </command></screen>
    </step>
    <step>
-    <para>Add the <systemitem>raider</systemitem> resource to the base group for storage that you have created for
-     DLM:</para>
-    <screen>&prompt.crm.conf;<command>modgroup</command> g-storage add raider</screen>
-    <para>The <command>add</command> sub-command appends the new group
-     member by default. </para>
-   <para>
-    If not already done, clone the <literal>g-storage</literal> group so that it runs on all nodes:
-   </para>
-   <screen>&prompt.crm.conf;<command>clone</command> cl-storage g-storage \
-    meta interleave=true target-role=Started</screen>
-    </step>
+    <para>
+      Make sure the <systemitem>Raid1</systemitem> primitive can only run on nodes where the
+      DLM resource is already running:
+    </para>
+    <itemizedlist>
+      <listitem>
+        <para>
+          You can add a single <systemitem>Raid1</systemitem> primitive to the
+          <literal>g-storage</literal> group described in <xref linkend="pro-dlm-resources"/>:
+        </para>
+<screen>&prompt.crm.conf;<command>modgroup g-storage add raider</command></screen>
+        <para>
+          This group already has internal colocation and order constraints.
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Do <emphasis>not</emphasis> add multiple <systemitem>Raid1</systemitem> primitives to
+          the group, because this creates a dependency between the Cluster MD devices.
+          For multiple devices, clone the primitives and colocate them with the independent
+          DLM resource described in <xref linkend="pro-dlm-multiple-resources"/>:
+        </para>
+<screen>&prompt.crm.conf;<command>crm configure clone cl-raider1 raider1 meta interleave=true</command>
+&prompt.crm.conf;<command>crm configure clone cl-raider2 raider2 meta interleave=true</command>
+&prompt.crm.conf;<command>crm configure colocation col-cmd-with-dlm inf: ( cl-raider1 cl-raider2 ) cl-dlm</command>
+&prompt.crm.conf;<command>crm configure order o-dlm-before-cmd Mandatory: cl-dlm ( cl-raider1 cl-raider2 )</command></screen>
+      </listitem>
+    </itemizedlist>
+   </step>
    <step>
     <para>Review your changes with
      <command>show</command>.</para>