Improve persistent device name warning (#393)

bsc#1226367 jsc#DOCTEAM-1466
SUSE · Jun 21, 2024 · a8a8f41 · a8a8f41
1 parent a7da861
commit a8a8f41
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
@@ -75,11 +75,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
@@ -612,3 +612,14 @@
 &prompt.root;<command>systemctl</command> start pacemaker</screen>
   </listitem>
  </itemizedlist>">
+
+<!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>'>