Table of Contents

General Feature Release 10.5.7

Note

For known issues with this version, refer to Known issues.

Important

Before you upgrade to this DataMiner version, make sure version 14.40.33816 or higher of the Microsoft Visual C++ x86/x64 redistributables is installed. Otherwise, the upgrade will trigger an automatic reboot of the DMA in order to complete the installation.

The latest version of the redistributables can be downloaded from the Microsoft website:

Tip

New features

Automation: Hash property of GetScriptInfoResponseMessage now contains a hash value of the script [ID 42616]

A Hash property has now been added to the GetScriptInfoResponseMessage. This property will contain a calculated hash value of the script based on the following script data:

  • Name

  • Description

  • Type

  • Script options:

    • Options included in the hash value calculation:

      • DebugMode
      • SkipElementChecks
      • SkipInfoEventsSet
      • SupportsBackAndForward
      • AllowUndef
      • WebCompliant (see soft-launch option UseWebIAS)

    • Options not included in the hash value calculation:

      • None
      • RequireInteractive
      • SavedFromCube
      • HasFindInteractiveClient
    Note

    For more information on the different script options, see options attribute.

  • CheckSets

  • Protocols

  • Memories

  • Parameters

  • Executables

    Note

    Executable code will be trimmed. All empty lines before and after the code will be removed.

Note

Author will not be included in the hash value as changing the author would result in a different value being calculated.

All hash values of all Automation scripts will be added as AutomationScriptHashInfo objects to the Automation script hash value cache file AutomationScriptHashCache.txt, located in the C:\Skyline DataMiner\System Cache\ folder. This file will be updated one minute after an Automation script was created or updated or one minute after a GetScriptInfoMessage was called.

Format of an AutomationScriptHashInfo object: Script Name;LastUpdate;Calculated hash

Example: Automation script;638786700548555379;48bcb02e89875979c680d936ec19ad5e9697f7ed73498fd061aecb73e7097497

Automation scripts: Generating information events when editing a connection in a QAction [ID 42783]

The SLNet message EditConnection, which can be used to edit a connection from within a QAction, now has a GenerateInformationEvents property. If this property is set to true, information events will be generated when a connection is created, updated, or deleted.

Automation: New OnRequestScriptInfo entry point [ID 42969]

In an Automation script, you can now implement the OnRequestScriptInfo entry point. This will allow other Automation scripts (or any other code) to request information about the script in question, for example to find out which profile parameter values a script needs in order to orchestrate a device.

Using the entry point

To use the entry point, add a method with the following signature to the script:

[AutomationEntryPoint(AutomationEntryPointType.Types.OnRequestScriptInfo)]
public RequestScriptInfoOutput OnRequestScriptInfoRequest(IEngine engine, RequestScriptInfoInput inputData)

Both RequestScriptInfoInput and RequestScriptInfoOutput have a Data property of type Dictionary<string, string>, which can be used to exchange information between the script and other code. We strongly recommend keeping the passed data below 20 MB (i.e. 10 million characters). If larger chunks need to be passed, a reference to that information should be passed instead.

It is allowed to pass null as input data and to return null as output data.

Arguments

If the script has any script parameters, dummies or memory files, then these are not required when executing the OnRequestScriptInfo entry point. However, they are required when executing the Run method of that same script.

  • When an omitted script parameter is used in the entry point logic, retrieving the script parameter is possible, but its value will be an empty string.
  • When an omitted dummy is used in the entry point logic, retrieving the dummy is possible, but it will refer to DMA ID -1 and element ID -1. Any actions that use the dummy will fail with an exception.
  • When an omitted memory file is used in the entry point logic, retrieving the memory file is possible, but it will refer to a linked file that is empty. Retrieving a value using the memory file will fail with an exception.
Subscript

To execute the OnRequestScriptInfo entry point within Automation, you have to use the following PrepareSubScript method on Engine or IEngine:

RequestScriptInfoSubScriptOptions PrepareSubScript(String scriptName, RequestScriptInfoInput input)

The script should be started synchronously. It will return a subscript options object with an Output property containing the information returned by the script. The Input property can be used to check or update the data sent to the script.

Executing subscripts is limited to a maximum of 10 levels.

ExecuteScriptMessage

The ExecuteScriptMessage can be used to trigger the entry point using an SLNet connection.

var input = new RequestScriptInfoInput
{
  Data = new Dictionary<string, string>
  {
    { "Action", "RequestValues" },
  },
};

new ExecuteScriptMessage
{
  ScriptName = scriptName,
  Options = new SA(new []{ "DEFER:FALSE" }),
  CustomEntryPoint = new AutomationEntryPoint
  {
    EntryPointType = AutomationEntryPoint.Types.OnRequestScriptInfo,
    Parameters = new List<object> { input },
  },
};

When an ExecuteScriptMessage is sent, an ExecuteScriptResponseMessage will be returned. The information is returned in an EntryPointResult.Result property of type RequestScriptInfoOutput.

This message should not be used to request the information in an Automation script.

Changes

Enhancements

BrokerGateway will now reconfigure the NATS cluster before a DMA is added to or removed from the DMS [ID 42494]

From now on, when BrokerGateway detects that a DataMiner Agent is about to be added to or removed from a DataMiner System, it will reconfigure the NATS cluster before the DataMiner Agent is actually added or removed.

Similarly, when BrokerGateway detects that a DataMiner Agent is about to be added to a Failover setup, it will reconfigure the NATS cluster before the DataMiner Agent is actually added.

Note

When BrokerGateway fails to reconfigure the NATS cluster, the DataMiner Agent will not be added or removed.

GQI: 'Get object manager instances' data source now supports real-time updates [ID 42530]

On systems using the GQI DxM, the Get object manager instances data source now supports real-time updates.

For more information on real-time updates, see Query updates.

New connector installed as part of an application package will now automatically be set as production version [ID 42623]

When a new connector is installed for the first time on a DMS as part of an application package, from now on, it will automatically be set as production version.

Also, when, in DataMiner Cube, the current production version of a connector was set as production again, up to now, the alarm and trend templates of that connector would incorrectly not be copied to the production version when you clicked Yes in the Copy templates? dialog box.

DataMiner upgrade: ModuleInstaller upgrade action timeout has been increased to 30 minutes [ID 42659]

Up to now, the ModuleInstaller upgrade action would time out after 15 minutes. As this action typically runs for more than 15 minutes, this would ofter cause a notice to be logged.

From now on, the ModuleInstaller upgrade action will only time out after 30 minutes.

Swarming: Enhanced error handling [ID 42667]

Because of a number of enhancements, error handling has improved when swarming elements from one DataMiner Agent to another.

Visual Overview in the web apps: Enhanced behavior in case of a failing visual overview request [ID 42677]

When a request for a visual overview in a web app failed, up to now, that request would incorrectly not be removed, causing it to block all subsequent requests for a visual overview in a web app. From now on, when a request for a visual overview in a web app fails, it will be removed from the list of pending requests.

Enhanced processing of service deletions [ID 42754]

When a service was migrated from one DMA to another within the same DMS, in some cases, the service would be deleted by the DMA that hosted the service originally instead of the DMA that was hosting the service when it was migrated. This could potentially lead to issues within the cluster.

From now on, the message ordering the deletion of a service will always be sent to the DMA that is hosting the service. That DMA will then forward the message to the other DMAs within the cluster.

Service & Resource Management: Enhanced retrieval of service definitions [ID 42810]

Because of a number of enhancements, overall performance has increased when retrieving service definitions.

Also, SLNet and SLDataGateway will now exchange data faster thanks to the use of protobuf serialization.

Enhanced performance when upgrading BrokerGateway [ID 42812]

Because of a number of enhancements, overall performance has increased when upgrading BrokerGateway.

Failover: Enhanced performance when executing a Failover switch [ID 42842]

Because of a number of enhancements, overall performance has increased when executing a Failover switch.

Security Advisory BPA test: Enhancements [ID 42850] [ID 42914]

A number of enhancements have been made to the Security Advisory BPA test.

For example, the BPA test is now able to run on the offline agent of a Failover setup.

Also, when the BPA test is run on a system with a local Cassandra or Elasticsearch database, a notice will now appear, saying that a local Cassandra/Indexing setup is no longer recommended.

DataMiner upgrade packages will now automatically upgrade the ModelHost and Copilot DxMs [ID 42896]

From now on, when a DataMiner upgrade is performed on a system containing a ModelHost and/or a Copilot DxM, these modules will automatically be upgraded.

BrokerGateway: Enhanced performance [ID 42900]

Because of a number of enhancements, overall BrokerGateway performance has increased, especially after adding or removing DMAs from the cluster.

BrokerGateway: Enhanced error handling [ID 42929]

A number of enhancements have been made to BrokerGateway with regard to error handling, especially in case of connection problems.

Migrating to BrokerGateway no longer requires a DataMiner restart [ID 42930]

From DataMiner 10.5.0 [CU2]/10.5.5 onwards, you can migrate from the SLNet-managed NATS solution (NAS and NATS services) to the BrokerGateway-managed NATS solution (nats-server service) using the NATSMigration tool.

Up to now, changes made to the MaintenanceSettings.xml file during the migration required DataMiner to be restarted. As these changes will now be read at run-time, it will no longer be required to restart DataMiner when migrating.

GQI: Sort operator now supports real-time updates when GQI DxM is being used [ID 42941]

When a GQI query that included a Sort operator was used in a component of which the Update data option was enabled, up to now, the Sort operator would incorrectly prevent updates through real-time events. As a result, the component would be updated through notification events instead.

From now on, on systems using the GQI DxM, a Sort operator will forward all real-time events, resulting in rows being added, updated and removed as soon as an update is received.

Important

Sorting will not be re-evaluated on update. As a result, if an update is received for a sorting column, the table will no longer be sorted correctly.

Failover: Enhanced performance when executing a Failover switch [ID 42983]

Because of a number of enhancements, overall performance has increased when executing a Failover switch.

Fixes

SLNet could leak memory when the progress.log file was deleted after a DataMiner upgrade [ID 42040]

In some cases, the SLNet process could leak memory when the progress.log file was deleted after a DataMiner upgrade had been performed.

Credentials Library: Problem when the same group was added more than once in the UpdateLibraryCredentialMessage [ID 42248]

Because of an issue in SLNet, up to now, if the same group would be added more than once in the UpdateLibraryCredentialMessage (i.e. the SLNet message used to add or update credentials), duplicated Group tags would end up in the Library.xml file. As a result, in DataMiner Cube, the updated credential would get stuck, showing a "[modified]" tag.

Not all DCF interfaces would be listed in the Connectivity tab of an element's Properties window [ID 42591]

When, in e.g. DataMiner Cube, you opened the Connectivity tab in the Properties window of an element, in some rare cases, not all DCF interfaces would be listed.

Alarm with a source other than "DataMiner" could incorrectly impact the alarm severity of a service [ID 42724]

In some cases, an alarm with a source other than "DataMiner" could incorrectly impact the alarm severity of a service, even though the alarm was already cleared or no longer had any of its service impact fields filled in.

LDAP users added as part of an LDAP user group would incorrectly appear as local users instead of domain users [ID 42743]

Up to now, LDAP users who had been added to DataMiner as part of an LDAP user group would incorrectly appear as local users instead of domain users.

Problem with SLNet caused by 'DefaultUpgradeOptions' element in MaintenanceSettings.xml file [ID 42746]

When, in the MaintenanceSettings.xml file, the <SLNet> element contained a <DefaultUpgradeOptions> sub-element, up to now, SLNet would fail to start up correctly.

Note

The above-mentioned <DefaultUpgradeOptions> element will be added to the MaintenanceSettings.xml file the first time you make any changes to the default upgrade options. To change these options in DataMiner Cube, go to System Center > System Settings > Upgrade.

Problem with SLNet and/or SLHelper when the NATS connection between them was unavailable [ID 42755]

When the NATS connection between SLNet and SLHelper was unavailable, in some cases, either of those processes could stop working.

Problem when deleting a newly created service that had failed to load [ID 42775]

When a service was created, in some cases, loading that new service would fail, even though a service.xml file had correctly been added on disk.Moreover, deleting that service would also fail, making it impossible to create a new service with an identical name.

From now on, when a new service fails to load, additional logging will be added, and a backup service.xml file will be created in the C:\Skyline DataMiner\Recycle Bin\ folder for debugging purposes.

Also, when the service that failed to load is deleted, an attempt will be made to delete the files and folders associated with that service in order to prevent any subsequent issues when creating a new service with an identical name.

Active clients would not receive an updated ElementInfoEventMessage after an element had been swarmed [ID 42778]

In some cases, after an element had been swarmed, active clients would not receive an updated ElementInfoEventMessage, causing them to display the element as if it was still hosted on the source agent.

Problem when the element.xml file of an SNMPv3 element that used a credential library did not contain a base-16 community string [ID 42805]

Up to now, a GetElementMessage call would throw an exception when the element.xml file of an SNMPv3 element that used a credential library did not contain a base-16 community string. From now on, it will return an empty string instead.

SLAnalytics: Problem when an element of which a parameter was part of a RAD parameter group was swarmed [ID 42879]

When an element of which a parameter was part of a RAD parameter group was swarmed, SLAnalytics would incorrectly send a PagedDataRequest to retrieve RAD data from the MadModelRecord customdata table, causing SLNet to throw a NullReference exception.

From now on, when an element of which a parameter is part of a RAD parameter group is swarmed, SLAnalytics will no longer send a PagedDataRequest. Instead, it will log an error message.

Important

Until further notice, when an element of which a parameter is part of a RAD parameter group was swarmed, RAD monitoring will no longer be active for the parameter group in question. If you want RAD monitoring to stay active for the parameter group in question, then you will have to either adapt the configuration of the parameter group or undo the element swarming.

SLSNMPManager process responsible for SNMPv3 communication could disappear when it was not able to redirect a trap [ID 42888]

By default, an SLSNMPManager process responsible for SNMPv3 communication will listen for any incoming traps, and will forward, for example, SNMPv2 traps to the SLSNMPManager process responsible for SNMPv2 communication.

Up to now, when an SLSNMPManager process responsible for SNMPv3 communication was not able to communicate with the SLSNMPManager process to which it had to redirect a trap, in some cases, the process could stop working and disappear.

Failover: Online agent would not clear local information about elements, services, and redundancy groups from its event cache when going offline [ID 42890]

When, during a Failover switch, the online agent went offline, up to now, it would incorrectly not clear local information about elements, services, and redundancy groups from its event cache.

Failover: ClusterEndpoints.json files would not get updated correctly on offline agents when a DMA was added to the cluster [ID 42923]

Up to now, when a DMA was added to a DMS that contains one or more Failover pairs, in some cases, the C:\Skyline DataMiner\Configurations\ClusterEndpoints.json files would not get updated correctly on the offline agents.

Incorrect attempts to delete child DVE elements upon start or restart of a main DVE element [ID 42924]

When a main DVE element was started or restarted, up to now, an attempt would incorrectly be made to delete child DVE elements that had already been deleted, causing unnecessary information events like "Deleting element-connections for source..." to be generated.

Automation: Associated TXF files would not be removed when an Automation script was deleted [ID 42943]

When you create an Automation script, apart from an XML file containing the actual script, a number of TXF files will be created. These will contain cached query information to speed up XML querying. Up to now, when an Automation script was deleted, the associated TXF files would incorrectly not be removed.

Failover: Database status in 'Failover status' window would incorrectly always be displayed as OK on a system using STaaS [ID 42944]

When, in e.g. DataMiner Cube, you opened the Failover status window when connected to a system using STaaS, up to now, the database status would always be displayed as OK, even when STaaS was degraded.

DataMiner upgrade: VerifyClusterPorts prerequisite check could fail when SLXML was still running [ID 42947]

Up to now, during a DataMiner upgrade, the VerifyClusterPorts prerequisite check could fail when SLXML was still running.

Changes to LDAP users or LDAP groups would incorrectly not get synchronized among the DMAs in the cluster [ID 42950]

Up to now, changes to an LDAP user or an LDAP group would incorrectly not get synchronized among the DMAs in the cluster, not even after a midnight sync.

Failover: NATS communication error on online agent after a Failover switch [ID 42964]

After a Failover switch, in some cases, the ClusterEndpointManager would fail to initialize on the agent that had gone online. In the Failover Status window, NATS communication would show an error state.

Editing an element on a swarming-enabled system would incorrectly cause the element's alarm ID range to be reset to 1 [ID 42988]

On swarming-enabled systems, up to now, editing an element would cause the alarm ID of that element to incorrectly be reset to 1. For the element to generate alarms in the correct range again, either DataMiner or the element had to be restarted.

SLAutomation would leak memory each time an Automation script was run [ID 43073]

Since DataMiner 10.5.6, SLAutomation would leak memory each time an Automation script was run.

Improve this page