IoT Value Plan Subscribers, MindAccess Developer Plan Subscribers and MindAccess Operator Plan Subscribers

APIs and Services

MindSphere will adhere to the API request URL validations in the upcoming release. This is a step to make the platform more secure. The API request URLs will be validated based on the use of trailing slash characters in requests pointing to dedicated resources. Please refer to the list below which contains examples of incorrect URLs and correct URLs. This will be applicable to all APIs in MindSphere.

Examples of malformed requests

Examples of well-formed requests

GET https://gateway.{region}-{environment}.{mindsphere-domain}/api/iottsaggregates/v3/aggregates/{assetId}/{aspectName}/

GET https://gateway.{region}-{environment}.{mindsphere-domain}/api/iottsaggregates/v3/aggregates/{assetId}/{aspectName}

GET https://{tenantName}-assetmanagement.{region}.{mindsphere-domain}/api/assetmanagement/v3/assets/{id}/?includeShared=true

GET https://{tenantName}-assetmanagement.{region}.{mindsphere-domain}/api/assetmanagement/v3/assets/{id}?includeShared=true

PUT https://{tenantName}-assetmanagement.{region}.{mindsphere-domain}/api/assetmanagement/v3/assettypes/{id}/

PUT https://{tenantName}-assetmanagement.{region}.{mindsphere-domain}/api/assetmanagement/v3/assettypes/{id}

Asset Manager

What's new?

  • We simplified the cleanup of asset-types and all created instances. You can now see all directly instantiated assets of the selected asset type in the Asset Manager tab "Usages" and clean them up. This will help you to clean up activities in regards of quota enforcement.

  • We rearranged the order of fields displayed per aspect depending on the job at hand. When viewing the aspect, the focus is now on the name and value. When editing the aspect you also get more information on the data type.

Known issues

  • If a VFC workflow for an asset in a subtenant exists, it is not shown in the respective tile in the Asset Manager for a tenant admin.

  • Fleet Manager navigation is not working correctly if you have to re-login, as query parameters are lost. This problem will be addressed soon. Please try again by clicking the Fleet Manager navigation button.

  • If you are using app specific roles you need to assign plugin roles as well. This is up to now only possible for MindConnect LIB plugin.

  • The Connectivity Management view currently only shows assets derived by BasicAgent, MindConnect Nano, MindConnect IoT2040, MindConnect Library or Industrial Edge or a derived type of the mentioned ones.

CMS X-Tools V5.0.0.6

Known issues

  • General: X-Tools is capable of uploading huge amounts of data, but you need to keep in mind the limits and purchased size of your MindSphere plan at all times.

  • If the asset path in a Storage Profile contains more than one asset, it might lead to creation of duplicate assets. It can be fixed by deleting those duplicated assets, changing, saving and restarting the Storage Profile.

  • See locally installed release notes.

Cross-Tenancy

Known issues

  • Only single asset sharing is available in the first release.

  • Sharing of assets derived from basicAgent and their corresponding plugins is not yet supported.

  • Tenant assets can not be moved under collaborators root asset or shared assets.

  • The successful implementation of a new sharing is normally completed within 2 minutes. If the new sharing is not successful within this time, the internal retry mechanism starts automatically after 4 minutes to complete the sharing. This issue will be addressed soon to prevent delays in the implementation.

Data Exploration built on Tableau®

Known issues

  • If you receive NULL values for timestamps on a Windows PC, please change your language for non-Unicode programs to English (United States). You'll find the settings in Control Panel → Region and Language → Administrative.

Identity and Access Management

Known issues

  • If you have problems logging off in Internet Explorer 11, please refer to Overcoming Logout Problems in IE11

  • After a user's role assignments have been changed, e.g., using the Settings app, the changes do not immediately become active. The user must re-login, e.g., by closing the browser and logging in again.

  • App specific roles: 

    • Additional core app roles are coming soon.

    • Some apps are still accessible via their direct URL and allow the use of shared functionality if the user has been granted rights via the app-specific role of a different app.

  • After modifying the authorization of a user via Identity Management Service, the change is not immediately visible. The user must then close the browser and login again.

Integrated Data Lake

What's new?

  • It is now possible to delete multiple objects via the user interface of Data Explorer.

Known issues

  • In Time Series Import user interface, the user can only view first level of child asset at the moment when importing the time series data.  The workaround for this approach is to use backend API to import data related to multiple child assets

  • It is observed that browser crashes randomly when trying to download files > 400MB.  It is advisable to use backend API for downloading objects > 400MB

  • When uploading the data using cross account access via native applications e.g. AWS CLI, the default permission is set to user of the account. The user has to provide the parameter (--acl bucket-owner-full-control) so the bucket owner (Integrated Data Lake) will get the necessary access to generate pre-signed URLs.

MindConnect Edge Analytics

Known Issues

  • When uploading Event Based Data Upload or Data Upload package to MindConnect Nano device and there are no enabled input signals within the Analysis Package configuration, the update ends in error state "Prepare Environment or Update/Start Configuration". Having critical error message in User Logs.

  • Note: A full configured monitoring of the Analyzing Packages Vibration Characteristic Values and Vibration Frequency Spectra with all channels of one SM1281 can exceed the CPU performance of the MindConnect Nano. Also in other scenarios dependent of tasks running in parallel on the MindConnect Nano, CPU load can get to high. The recommendation is to use only two fully configured Vibration Frequency Spectra Analyzing Packages in parallel.

  • Deactivating a data point within a MindConnect data source will not deactivate a connection check in Edge Analytics Engine. This can lead to an error if the target device is no longer available.

  • DataBus and Event Based Data Upload configuration can be created without data or deactivated data, which will lead to a critical error on project start.

  • In some sporadic cases of a configuration update via Edge Analytics Manager it is possible that the Mind Connect Nano gets stuck in "project stopping" - In this case, the MindConnect Nano should be rebooted.

  • If a migration of SM1281 configuration has been done with EAE Version 1.0.6 speed is shown with unit m/s - The configuration has to be recreated to fix this issue and show a correct unit in rpm.

OPC Pub Sub

What's new?

  • It is now possible to write the unit of a variable to the proper field so that it can be interpreted by all the applications. This will significantly enhance the user experience in all applications showing assets onboarded via OPC UA Pub/Sub.

Subtenant Functionality

Known issues

  • The subtenant use case is not yet supported by Data Flow Engine.

  • Applications can use the subtenant functionality via the provided APIs. Tenant administrators should pay attention when assigning such apps to subtenant users as subtenant isolation cannot be ensured by the platform. The app might expose data to the user that is not intended to be seen.

  • When moving an asset from a parent tenant to a subtenant, there might be a delay of up to 30 minutes until a subtenant user will be able to see data related to that asset.

  • Please be aware, if you provide a user (even subtenant user) the role "mdsp:core:TenantAdmin", this user is then able to get access to all kinds of tenant data.

Upgrade

What's new?

  • We have improved the product description text for CF RAM Upgrade.

  • Within this release, we have introduced a new feature for the Developer and Operator to access Time Series Ingest and Storage Upgrade by using the Upgrade tool.

Known issues

  • Currently no personalized notifications for subscriptions (TenantAdmin) or subscription requests (StandardUser) are available.

  • Purchasing request notifications are send to all tenant admins.

  • Upgrade is providing a fast provisional access to the requested quota. It requires an approval by the commercial contact who will be informed separately.

  • Supported Language: English only.

  • Supported Currency: EUR only.

Usage Transparency

Fixed issues

  • We fixed an issue with displaying sum of Visual Flow Creator Compute Hours of a month on Customer Dashboard.

Known issues

  • In "Reports" or "Overview" section in few cases a time out error message appears when loading the page for a while. As a workaround, after this error occurs, reload the report for the same month with a second click.

  • Upgrades purchased on Upgrade Tool will be displayed on Customer Dashboard with 30 minutes delay.

Visual Explorer

Known issues

  • Any request within Visual Explorer is limited to an execution time of 60 sec.

  • The "share via link" functionality works unreliable.

  • Support time series data types “LONG” with values for safe integer ->(253-1) to (253-1).

  • If the value is e.g. 263 the value will be reset to safe integer ->253-1.

Visual Flow Creator

Known issues

  • Subtenant users cannot use the time series subscription node.