Warn about XTypes in Fast DDS v3 (#1021)

Signed-off-by: cferreiragonz <[email protected]>
eProsima · Jan 29, 2025 · c16c505 · c16c505
1 parent 8e9a8da
commit c16c505
Show file tree

Hide file tree

Showing 5 changed files with 14 additions and 3 deletions.
diff --git a/code/DDSCodeTester.cpp b/code/DDSCodeTester.cpp
@@ -970,7 +970,7 @@ void dds_domain_examples()
 
         pqos.properties().properties().emplace_back(
             "fastdds.type_propagation",
-            "enabled");
+            "disabled");
         //!--
     }
 }

diff --git a/code/XMLTester.xml b/code/XMLTester.xml
@@ -3277,7 +3277,7 @@
                     <properties>
                         <property>
                             <name>fastdds.type_propagation</name>
-                            <value>enable</value>
+                            <value>disabled</value>
                         </property>
                     </properties>
                 </propertiesPolicy>

diff --git a/docs/fastdds/property_policies/non_consolidated_qos.rst b/docs/fastdds/property_policies/non_consolidated_qos.rst
@@ -509,4 +509,4 @@ The different property values have the following effects on the local |DomainPar
             :language: xml
             :start-after: <!-->TYPE_PROPAGATION_PROPERTY<-->
             :end-before: <!--><-->
-            :lines: 2-4,6-16,18-19
+            :lines: 2-4,6-17,19-20
diff --git a/docs/fastdds/troubleshooting/troubleshooting.rst b/docs/fastdds/troubleshooting/troubleshooting.rst
@@ -44,3 +44,8 @@ issues.
 
 * If having problems with transmitting **large samples such as video or point clouds**, please refer to
   :ref:`use-case-largeData`.
+
+* Fast DDS v3 introduced the new feature :ref:`XTypes<dynamic-types>`, which allows to discover remote types.
+  In consequence, discovery traffic can be increased during start up.
+  If you are experiencing high load during discovery, try disabling the new feature.
+  Please refer to :ref:`disable type propagation<property_type_propagation>` to learn how to do it.
diff --git a/docs/notes/migration_guide.rst b/docs/notes/migration_guide.rst
@@ -10,6 +10,12 @@ Migration Guide to Fast DDS v3
 This document aims to help during the migration process from eProsima *Fast DDS version* 2 to *Fast DDS version* 3.
 For more information about all the updates, please refer to the :ref:`release notes <release_notes>`.
 
+.. warning::
+    Fast DDS v3 introduces a new feature :ref:`XTypes<dynamic-types>` that allows to discover remote types.
+    In consequence, discovery traffic can be increased during start up.
+    If you are experiencing high load during discovery, try disabling the new feature.
+    Please refer to :ref:`disable type propagation<property_type_propagation>` to learn how to do it.
+
 Migration Steps
 ---------------