Merge pull request #5305 from SkylineCommunications/43440+43686

RNs 43440 + 43686

Author: MariekeGO

dataminer/Administrator_guide/Swarming/SwarmingFAQ.md

@@ -45,3 +45,9 @@ The only way to see this at present is to attempt to swarm the element via the A
 ## How do Agents know which elements to host when starting up?
 
 This info is stored in the database together with the element. Each element has a field storing its current host. When an element swarms to another Agent, this field is updated.
+
+## What happens to a relational anomaly group when elements are swarmed?
+
+When an element is swarmed that contains a parameter that is being monitored in a [relational anomaly group](xref:Relational_anomaly_detection), the monitoring will continue as before if DataMiner version 10.5.11/10.6.0 or higher is used.<!-- RN 43686 --> Even if all elements in the group are swarmed to another Agent, the relational anomaly group itself will continue to be hosted on the same DataMiner Agent.
+
+In versions prior to DataMiner 10.5.11/10.6.0, relational anomaly groups will stop working in such a case, as all elements within a group need to be hosted on the same Agent in such versions.

dataminer/Operator_guide/Alarms/Working_with_alarms/Advanced_analytics_features/Relational_Anomaly_Detection/RAD_API.md

@@ -22,6 +22,9 @@ All messages in the RAD API reside in the `Skyline.DataMiner.Analytics.Rad` name
 
 Each request message sent to DataMiner will return a response message of the corresponding type. For example, an `AddRADParameterGroupMessage` will receive an `AddRADParameterGroupResponseMessage` in response, confirming that the request was processed successfully.
 
+> [!NOTE]
+> Prior to DataMiner 10.5.11/10.6.0<!-- RN 43440 -->, RAD API messages must be sent to the Agent monitoring the parameters in the relational anomaly group. If the Agent cannot be determined, an exception will be thrown.
+
 ## Example
 
 Below you can find an example of an Automation script that uses the RAD API to add a RAD parameter group with four parameter instances for each element of which the name begins with `Commtia LON`.

dataminer/Operator_guide/Alarms/Working_with_alarms/Advanced_analytics_features/Relational_Anomaly_Detection/Relational_anomaly_detection.md

@@ -83,7 +83,7 @@ From DataMiner 10.5.6/10.6.0 onwards<!--RN 42602-->, [deleting a relational anom
 
 ## Limitations
 
-- Currently, RAD cannot monitor parameters hosted on multiple DataMiner Agents within a single group. All parameters in a group must be hosted on the same DMA. Prior to DataMiner 10.5.9/10.6.0<!--RN 43320-->, the *RelationalAnomalyDetection.xml* file on a given DMA could only include parameters hosted on that DMA.
+- Monitoring parameters hosted on **multiple DataMiner Agents within a single relational anomaly group** is only supported from DataMiner 10.5.11/10.6.0 onwards.<!-- RN 43686 --> In previous DataMiner versions, all parameters in a group must be hosted on the same DMA. This also means that in previous DataMiner versions, a relational anomaly group will stop working if any elements in that group are [swarmed](xref:Swarming) to other DMAs. In addition, prior to DataMiner 10.5.9/10.6.0<!--RN 43320-->, the *RelationalAnomalyDetection.xml* file on a given DMA can only include parameters hosted on that same DMA.
 
 - Some parameter behavior will cause RAD to work less accurately. For example, if a parameter responds to another parameter with a delay, such as a door opening gradually lowering a room's temperature, RAD may generate less precise results.
 

src/DataMiner/SLAnalyticsTypes/Rad/GetRADParameterGroupsMessage.cs

@@ -9,6 +9,13 @@ namespace Skyline.DataMiner.Analytics.Rad
     /// Message to retrieve the relational anomaly detection parameter group names.
     /// Results in a <see cref="GetRADParameterGroupsResponseMessage"/>.
     /// </summary>
+    /// <remarks>
+    ///     <list type = "bullet" >
+    ///         <item>
+    ///             <description>From DataMiner 10.5.11/10.6.0 onwards (RN 43440), GetRADParameterGroupsMessage retrieves a list of all RAD parameter groups that have been configured across all Agents in the cluster. In earlier DataMiner versions, it only retrieves the RAD parameter groups hosted on the local Agent.</description>
+    ///         </item>
+    ///     </list>
+    /// </remarks>
     [Serializable]
     public class GetRADParameterGroupsMessage : GetSessionedAnalyticsMessage
     {