Ericsson Device and Data Management

Last modified: Jul 9, 2019 @ 14:54

Release Notes

This document describes all the new features, enhancements, and changes included in this release of the Device and Data Management (DDM) service. For detailed information about using the DDM features, see the online documentation in the DDM documentation portal.

To find out what versions you have installed, check the information in the About window in your DDM Admin dashboard.

Release Version: DDM 19B1

Release Date: w27

Note:

  • DMM 19B1 covers DDM Core 2.4, DDM Core UM 1.2, LwM2M Gateway 1.6, LwM2M BSS 1.2, BSSi 1.1, MQTT Gateway 2.2., and HTTP Gateway 1.1.
  • This Release Note covers DDM Core 2.4, LwM2M Gateway 1.6, LwM2M BSS 1.2, DDM Core UM 1.2, and HTTP Gateway 1.1.

Contents

Main End User Improvements

Additional information is found in section Release Details.

New Features
Device network creation cleanup.
Exclusion of Ericsson specific devices.
Register Interface updated and Interface for Deregister added.
Disabled TLS version less than 1.2.
New Web Admin API Endpoints
Nothing for this release.
New Southbound Commands
Nothing for this release.
Other End User Improvements
Nothing for this release.
Customer Issues Solved
Issue Description ID
Difference of timestamp entries in the customer environment. Time differences are observed between the environments, NTP not enabled. DDM-89734
Clarification in Device Profile API.

 

Added Type fields in Device Profile to make the usage easier to understand. The Type fields are Bootstrap,LwM2M, and Bootstrap and LwM2M. DDM-89623

Release Details

Features

New Features

Details for New Features – From Web Admin API and GUI Perspective (Northbound Interface)
Feature Description Documentation
Device network creation cleanup. Device network creation operation automatically produces a set of defaults for the following functionalities:

1. Smart Object types (latest LwM2M 1.0 types).

2. Default locations.

3. Default setting categories (Device Message Queue, LwM2M server, PSK, Certificate Based Authentication, and MQTT Topic Filters).

4.Default data collector types (LwM2M Classic and MQTT Classic).

5.Default device types (LwM2M undefined).

N/A
Exclusion of Ericsson specific devices. 1.Ericsson specific devices (AppIot Internal) are excluded from device metrics aggregation, since only the customer created devices are billed.

2.By default, the sensor storage aggregation is set to generate usage report for current month only.

N/A
Details for New Features – From Device Perspective (Southbound Interface)
Nothing for this release.
Details for New Features – From HTTP Gateway Perspective
Feature Description Documentation
Register Interface updated and Interface for Deregister added. 1.Register Interface is updated to send DeviceRegisterRequest to DDM. Device status will be online in DDM, post to device registration.

2.Interface for Deregister is added to send DeviceDeregisterRequest to DDM. Device status will be offline in DDM, post to device registration.

See HTTP Gateway in the DDM Documentation Portal.
Disabled TLS version less than 1.2. TLS version less than 1.2 are not supported by HTTP Gateway. N/A

Web Admin API

New API Endpoints

API documentation:

  • If you are using DDM standalone, see swagger.
  • If you are using Ericsson IoT Accelerator, see apidoc.
    Note: Open this link with Google Chrome.

For details, see Overview of APIs in the DDM documentation portal.

Web Admin API – New API Endpoint
Nothing for this release.

Changed API Endpoints

API documentation:

  • If you are using DDM standalone, see swagger.
  • If you are using Ericsson IoT Accelerator, see apidoc.
    Note: Open this link with Google Chrome.

For details, see Overview of APIs in the DDM documentation portal.

 

Web Admin API – Changed API Endpoint
Description Change Description
GET /api/v3/devices
Returns a paged list of Devices. Added parameters:

IsIncludeInternalItems

By default, items that are internally used by the system are excluded from listings.
For backward compatibility PagedRequest contains a new optional property IsIncludeInternalItems.

If internal items are required, this property can be set to true.

Filter out internal Devices.

If Hardware Type ID of Device is 100006, that specific Device will be excluded.

GET /api/v3/DataCollectorTemplates
Returns a paged list of DataCollectorTemplates. Added parameters:

IsIncludeInternalItems

By default, items that are internally used by the system are excluded from listings.
For backward compatibility PagedRequest contains a new optional property IsIncludeInternalItems.

If internal items are required, this property can be set to true.

Filter out internal DataCollectorTemplates.

If Hardware Type ID of DataCollectorTemplate is 100000, that specific DataCollectorTemplate will be excluded.

 

GET /api/v3/dataCollectors
Returns a paged list of DataCollectors in the DeviceNetwork based on the applied filters and search string. Added parameters:

IsIncludeInternalItems

By default, items that are internally used by the system are excluded from listings.
For backward compatibility PagedRequest contains a new optional property IsIncludeInternalItems.

If internal items are required, this property can be set to true.

Filter out internal DataCollector.

If Hardware Type ID of Datacollector is 100000, that specific DataCollector will be excluded.

 

 

GET /api/v3/devicetemplates
Returns a single DeviceTemplate. Added parameters:

IsIncludeInternalItems

By default, items that are internally used by the system are excluded from listings.
For backward compatibility PagedRequest contains a new optional property IsIncludeInternalItems.

If internal items are required, this property can be set to true.

Filter out internal DeviceTemplates.

If Hardware Type ID of DeviceTemplates is 100006, that specific DeviceTemplate will be excluded.

GET /api/v3/smartobjecttypes
Returns a paged list of all SmartObjectsTypes. Added parameters:

IsIncludeInternalItems

By default, items that are internally used by the system are excluded from listings.
For backward compatibility PagedRequest contains a new optional property IsIncludeInternalItems.

If internal items are required, this property can be set to true.

Filter out internal SmartObjectTypes.

By default, SmartObjectTypes containing the following IDs are excluded:

100007
100101

GET /api/v3/resources
Returns a paged list of all Resources. Added parameters:

IsIncludeInternalItems

By default, items that are internally used by the system are excluded from listings.
For backward compatibility PagedRequest contains a new optional property IsIncludeInternalItems.

If internal items are required, this property can be set to true.

Filter out internal Resources.

By default, Resources with ResourceType in the range (inclusive) 100000 – 101000 are excluded.

 

GET /api/v3/resourcetypes/{id}
Returns a single ResourceType. Added parameters:

IsIncludeInternalItems

By default, items that are internally used by the system are excluded from listings.
For backward compatibility PagedRequest contains a new optional property IsIncludeInternalItems.

If internal items are required, this property can be set to true.

Filter out internal ResourceTypes.

By default, Resources with ResourceType in the range (inclusive) 100000 – 101000 are excluded.

 

Note: APIs which are having isIncludeInternalItems parameter with no impact are listed in document APIList_isIncludeInternalItems.

Removed API Endpoints

API documentation:

  • If you are using DDM standalone, see swagger.
  • If you are using Ericsson IoT Accelerator, see apidoc.
    Note: Open this link with Google Chrome.

For details, see Overview of APIs in the DDM documentation portal.

Web Admin API Removed API Endpoints
Nothing for this release.

Southbound HTTP Commands

HTTP GW Interface
Nothing for this release.

Known Limitations

Known Limitations
Nothing for this release.

Known Issues

Known Issues
Downtime occurs, when you restart the HTTP gateway pod in Kubernetes environment.