General Main Release 10.5.0 – Breaking changes
Note
For known issues with this version, refer to Known issues.
Parameter latch states will now be reset after every DataMiner restart [ID 39495]
In order to increase overall performance when starting up elements, parameter latch states will no longer be persistent by default. They will be reset after every DataMiner restart.
If you want to have persistent parameter latch states, do the following:
Open the MaintenanceSettings.xml file.
In the
AlarmSettings
section, add thePersistParameterLatchState
option, and set it to true.<AlarmSettings> ... <PersistParameterLatchState>true</PersistParameterLatchState> ... </AlarmSettings>
Restart the DataMiner Agent.
Important
- From now on, by default (or when the
PersistParameterLatchState
option is set to false in MaintenanceSettings.xml), parameter latch states will no longer be written to or fetched from the database. This means that, after every DataMiner restart, all parameter latch states will be reset. - Element, service and view latch states will remain persistent as before.
GQI - 'Get alarms' data source: Updated 'Alarm ID' and 'Root Alarm ID' columns [ID 40372]
In the Get alarms data source, the following columns have been updated:
Column | Former contents | New contents |
---|---|---|
Alarm ID | HostingDMAID/AlarmID | DMAID/EID/RootAlarmID/AlarmID |
Root Alarm ID | HostingDMAID/RootAlarmID | DMAID/EID/RootAlarmID |
Note
"DMAID" refers to the DataMiner ID of the DataMiner Agent where the element was originally created. "HostingDMAID" refers to the DataMiner ID of the DataMiner Agent currently hosting the element and managing its alarms. Most of the time, these two values will be the same, but they may differ, for example, when an element is exported from one Agent and imported onto another Agent. In this case, the element retains the original DMAID, but the HostingDMAID will reflect the new Agent's ID.
Automation: SubScriptOptions.SkipStartedInfoEvent will now by default be set to true [ID 40867]
If you have created an Automation script that launches subscripts, you can use the SkipStartedInfoEvent
option to specify whether "Script started" information events should be generated for the subscripts or not.
Up to now, this SkipStartedInfoEvent
option would by default be set to false. From now on, it will by default be set to true.
DataMiner Object Models: An exception will now be thrown when an issue occurs for any of the DomInstances that are created, updated, or deleted in bulk [ID 41546]
From now on, if an issue occurs for any of the DomInstances
that are getting created, updated, or deleted in bulk (e.g. validation), a BulkCrudFailedException<DomInstanceId>
will be thrown. The Result
property in the exception can be used to check for which DomInstances
the call succeeded or failed. For information on how to implement this flow, refer to the Checking issues example.
As an alternative, the TryCreateOrUpdate
or TryDelete
methods can be used. When the operation fails for one of the DomInstances
, those calls will return false. The result
output parameter will contain:
The list of successfully processed items, as is the case for
CreateOrUpdate
andDelete
.A list of
DomInstance
IDs that failed to be created, updated, or deleted.The trace data per
DomInstance
ID.
For each of these methods, the trace data of that call is still available and will contain the trace data for all processed DomInstances
.
Important
In DataMiner versions prior to DataMiner Feature Release 10.5.0/10.5.2, when any validation issue occurs, no exception is thrown (even when ThrowExceptionsOnErrorData
is true) when calling the CreateOrUpdate
or Delete
methods. Instead, the result of the call should be used to check for which DomInstances
the call succeeded or failed.
Note
When creating, updating or deleting a single DomInstance
, you can now also use the TryCreate
, TryUpdate
and TryDelete
methods as an alternative in order to avoid having to check for exceptions. These methods are also available for other objects that make use of the CRUD helper component.