diff --git a/xml/cap_admin_service_broker.xml b/xml/cap_admin_service_broker.xml
index 439726c8..79b8cb16 100644
--- a/xml/cap_admin_service_broker.xml
+++ b/xml/cap_admin_service_broker.xml
@@ -797,5 +797,15 @@ mysql-service  1        Mon May 21 11:40:11 2018  DEPLOYED  cf-usb-sidecar-mysql
     </para>
    </important>
   </sect2>
+  <sect2 xml:id="sec-cap-minibroker-upgrades">
+   <title>Upgrading &productname; When Using Minibroker</title>                 
+   <para>                                                                       
+    If you are upgrading &productname; to 1.5.2 and already use Minibroker to   
+    connect to external databases and are using &kube; 1.16 or higher, which is 
+    the case with &caasp; 4.1, you will need to update the database version to  
+    a compatible version and migrate your data over via the database’s suggested
+    mechanism. This may require a database export/import.                       
+   </para>                                                                      
+  </sect2>
  </sect1>
 </chapter>
diff --git a/xml/cap_admin_upgrade.xml b/xml/cap_admin_upgrade.xml
index f227f473..6d5b055b 100644
--- a/xml/cap_admin_upgrade.xml
+++ b/xml/cap_admin_upgrade.xml
@@ -131,6 +131,17 @@
    <xref linkend="sec-cap-skipped-release"/>.
   </para>
 
+  <important>
+   <title>Upgrading &productname; When Using Minibroker</title>
+   <para>
+    If you are upgrading &productname; to 1.5.2 and already use Minibroker to
+    connect to external databases and are using &kube; 1.16 or higher, which is
+    the case with &caasp; 4.1, you will need to update the database version to
+    a compatible version and migrate your data over via the database’s suggested
+    mechanism. This may require a database export/import.
+   </para>
+  </important>
+
   <para>
    For upgrades from &productname; 1.5.1 to 1.5.2, if
    the <literal>mysql</literal> roles of <literal>uaa</literal> and