diff --git a/xml/ha_cluster_md.xml b/xml/ha_cluster_md.xml
index c406937c3..baf468d6c 100644
--- 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
index 6c3fc7e7b..76e21a126 100644
--- 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>'>