Improve persistent device name warning (#393)

bsc#1226367 jsc#DOCTEAM-1466
SUSE · Jun 21, 2024 · dea1797 · dea1797
1 parent 057ecd7
commit dea1797
Show file tree

Hide file tree

Showing 2 changed files with 12 additions and 5 deletions.
diff --git a/xml/ha_cluster_md.xml b/xml/ha_cluster_md.xml
@@ -77,11 +77,7 @@
    </listitem>
   </itemizedlist>
 
-  <para>
-   For better stability, use persistent device names
-   such as <literal>/dev/disk/by-id/<replaceable>DEVICE_ID</replaceable></literal>
-   instead of <literal>/dev/sd<replaceable>X</replaceable></literal> names.
-  </para>
+  &warning-persistent-shared-storage-name;
 
   <procedure>
    <step>

diff --git a/xml/phrases-decl.ent b/xml/phrases-decl.ent
@@ -652,3 +652,14 @@
      <systemitem class="resource">softdog</systemitem> can be used as kernel
      watchdog module.</para>
    </important>'>
+
+<!ENTITY warning-persistent-shared-storage-name '<warning xmlns="http://docbook.org/ns/docbook">
+  <title>Always use persistent device names</title>
+  <para>
+    Always use cluster-wide persistent device names, such as
+    <literal>/dev/disk/by-id/<replaceable>DEVICE_ID</replaceable></literal>.
+    Unstable device names like <literal>/dev/sd<replaceable>X</replaceable></literal> or
+    <literal>/dev/dm-<replaceable>X</replaceable></literal> might become mismatched on different
+    nodes, causing major problems across the cluster.
+  </para>
+</warning>'>