16th September 2023 (Europe 1) - Developer Documentation
Skip to content

16th September 2023 (Europe 1)

Scope

We have worked hard to deliver a great Insights Hub experience, but we are still tracking some known issues. If you find others, please give us your feedback by contacting our Insights Hub Support.

We recommend that you read the following release notes carefully. These notes contain important information for installation and use.

This Release Notes is relevant for Insights Hub region Europe 1, for release in September 2023.

Agent Management

Applicable for:

  • MindAccess IoT Value Plan Subscribers
  • MindAccess Developer Plan Subscribers
  • MindAccess Operator Plan Subscribers

What's new?

  • Within this release, it is now possible to scale your agents suiting to your requirement using the Upgrade tool.
  • Our current TLS certificates signed by CA QuoVadis are going to expire on 29th October 2023. These certificates will be rotated with new certificates signed by new CA DigiCert between 17th October 2023 to 24th October 2023. Please make sure that the device's trust store has a DigiCert Global Root G2 certificate, which can be downloaded from http://cacerts.digicert.com/DigiCertGlobalRootG2.crt.

Asset Manager

Applicable for:

  • MindAccess IoT Value Plan Subscribers
  • MindAccess Developer Plan Subscribers
  • MindAccess Operator Plan Subscribers
  • Capability Packages Subscribers
  • Low Code Starter Kit

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.
  • If you are using app specific roles, you need to assign plugin roles as well. This is now only possible for MindConnect LIB plugin, MindConnect Nano and MindConnect IoT2040.
  • 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.

Asset Management API

Applicable for:

  • MindAccess IoT Value Plan Subscribers
  • MindAccess Developer Plan Subscribers
  • MindAccess Operator Plan Subscribers
  • Capability Packages Subscribers
  • Low Code Starter Kit

Advance information

Setting page size limitations to 200 is found to greatly improve application performance when requesting asset-related data.

**Asset management GET APIs** 
GET assetmgmturl/assets?size=200 
GET assettypemgmturl/assettypes?size=200 
GET assettypemgmturl/aspecttypes?size=200

All customers, users, app builder needs to adapt basis on above changes, if not done.

Known issues

  • Currently, it is possible to use a variable name equal to the aspect name which leads to errors, for example in Fleet Manager.

Cross-Tenancy

Applicable for:

  • MindAccess IoT Value Plan Subscribers
  • MindAccess Developer Plan Subscribers
  • MindAccess Operator Plan Subscribers
  • Capability Packages Subscribers
  • Low Code Starter Kit

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 cannot 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.

Dashboard Designer

What's new?

With this release, roles for Dashboard Designer Add On must be assigned to users via the Settings app to activate Dashboard Designer Add On on the Launchpad, starting from 18th October 2023. The Roles you set in the Settings app (dashboarddesigner.creator or dashboarddesigner.viewer) will override Roles set in Dashboard Designer. This change comes as we introduce a new Role concept that allows you to selectively enable and/or disable the Launchpad icon for your Subtenant users.

Data Exploration built on Tableau®

Applicable for:

  • MindAccess IoT Value Plan Subscribers
  • MindAccess Developer Plan Subscribers
  • MindAccess Operator Plan Subscribers

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.

Developer Cockpit

Applicable for

  • Subscribers of Capability Packages
  • Subscribers of MindAccess Developer Plan

Known issues

  • The Insights Hub Core APIs (such as Asset Management) cannot yet be invoked from API apps when used as external dependencies from standard applications hosted on distinct tenants.
  • Currently, not all roles and scopes are supported by custom app credentials. In this case, use the other provided options.
  • Application versions that contain a "#" character cannot be deployed in the Operator Cockpit. We advise customers not to use "#" in production version strings.
  • Applications cannot be deleted after being transferred to the production system.
  • The System is automatically suggesting an Internal App Name and an Initial Version for more convenience.
  • Layout issues in Internet Explorer 11 in combination with high resolution displays and 125 % font scaling.

Edge Analytics

Applicable for:

  • Edge Analytics Subscribers
  • Capability Packages Subscribers

Known Issues

  • Note: When executing too many Analysis Packages with a Trigger Rule of condition type "Continuous", the CPU performance of the Edge Device can easily be exceeded. Also in other scenarios dependent of tasks running in parallel on the Edge Device, CPU load and also memory usage can get too high. Please check the Edge Analytics log for corresponding warnings.
  • When uploading Event Based Data Upload or Data Upload package to an Edge 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.
  • 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.
  • A bugfix has been introduced for Custom Analysis Packages, which can lead to incompatible existing Templates. In this case please export the flow and recreated the Custom Analysis Package.
  • In case the Cycle Time for a Custom Analysis Package is put to the template UI, an input value is overwritten with the default value.
  • It is recommended to use at minimum Mozilla version 78.0.2 or Microsoft Edge version 83. To ensure the app will be loaded correct.

Event Management

Applicable for:

  • MindAccess Developer Plan Subscribers
  • MindAccess Operator Plan Subscribers

What's new?

  • Within this release, we have improved the Technical protection limit for P&P2 tenant.

Identity and Access Management

Applicable for:

  • MindAccess Developer Plan Subscribers
  • MindAccess Operator Plan Subscribers
  • Capability Packages Subscribers
  • Low Code Starter Kit

Known issues

  • If you have problems logging off in Internet Explorer 11, please refer to Overcoming Logout Problems in IE11.
  • 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.

Integrated Data Lake

Applicable for:

  • Subscribers of Integrated Data Lake

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.
  • Within this release, scheduled time series job cannot be created for sub-tenant user.

IoT and Storage Services: File Service

Applicable for:

  • MindAccess IoT Value Plan Subscribers
  • MindAccess Developer Plan Subscribers
  • MindAccess Operator Plan Subscribers
  • Capability Packages Subscribers
  • Low Code Starter Kit

Known issues

  • For security reasons, a strict timeout is enforced. Currently, this leads to the situation that the size of a file which can be uploaded/ downloaded depends on the network bandwidth at client side.
  • When uploading files to the File Service, a file name cannot contain blank spaces. Blank spaces in the file name will prevent the file from being stored.
  • After deleting an asset, the associated files might still be accessible for up to 30 minutes as this data is deleted asynchronously.
  • After deleting a file, it will take some time (up to 60 seconds) to create the file with the same name again.
  • After creating or deleting the file, it will take some time (up to 3 seconds) to get the file in "search file" API.

IoT and Storage Services: Time Series Service

Applicable for:

  • MindAccess IoT Value Plan Subscribers
  • MindAccess Developer Plan Subscribers
  • MindAccess Operator Plan Subscribers
  • Capability Packages Subscribers
  • Low Code Starter Kit

Known issues

  • The maximum payload size of a message sent to Time Series Service as part of a PUT request cannot exceed 1 MB, out of which 400 KB is reserved for internal use.
  • The service will never return more than 2000 records in a response.
  • After deleting an asset, respective time series data might still be accessible for sometimes this data is deleted asynchronously.
  • When getting the job status of a bulk import job, the response might not always contain detailed information on errors that occurred.
  • When ingesting time series data for multiple asset and aspects in single request, the combination of records should be unique.
  • Get Latest Value with query parameter "latestValue = true" will work with a delay up to 2 hours from the time of ingestion. Refer to developer documentation 'sample' section for more information.
  • While using Get Latest Value with query parameter "latestValue = true", historic/late arriving data may take more than 1 day to reflect in the response.

IoT and Storage Services: Aggregates Service

Applicable for:

  • MindAccess IoT Value Plan Subscribers
  • MindAccess Developer Plan Subscribers
  • MindAccess Operator Plan Subscribers
  • Capability Packages Subscribers
  • Low Code Starter Kit

Advance information

Known issues

  • Currently, IoT Timeseries aggregate service is not able to perform Secure Data Sharing access validation.

MindConnect Device Management

What's new?

  • Within this release, we have partially improved the mass importing and exporting.

Insights Hub Monitor

Applicable for:

  • MindAccess IoT Value Plan Subscribers
  • MindAccess Developer Plan Subscribers
  • MindAccess Operator Plan Subscribers
  • Capability Packages Subscribers

Known issues

  • This application is only supported on a normal desktop computer, and is not supported on mobile devices like tablets.
  • Work orders are not supported for sub-tenants

Operator Cockpit

Applicable for:

  • Subscribers of Capability Packages
  • Subscribers of MindAccess Operator Plan

Known issues

  • Limitations for update of Cloud Foundry applications:
  • The service instance names for each service should be same in the current and new version of the application. If the service instance names are different in the new version and the existing version of an application, then the existing service instances will not be readily available even after zero-downtime version upgrade.

  • During manual deployment of a new version of an application, do not use the same component names as available in the existing version. This might create name conflicts and usability issues. In order to avoid such conflicts, while deploying a new version of an application, append green at the end of the component name.

  • For every individual (single) application, one Cloud Foundry space must be deployed.

  • After modifying the authorization of a user via the Operator Cockpit user interface, the change is not immediately visible. The user has to close the browser and login again.
  • After deployment of an app, there is a security feature in place validating if the app is known to Insights Hub or the app has somehow been modified. Sometimes issues occur with regards to name changes or deploying from various folders. The apps need to be deployed as they are assigned from the developer.

Rules

Applicable for:

  • MindAccess IoT Value Plan Subscribers
  • MindAccess Developer Plan Subscribers
  • MindAccess Operator Plan Subscribers
  • Capability Packages Subscribers
  • Low Code Starter Kit

Known issues

  • Rules are not enabled for sub-tenant users.

Insights Hub Start for Free

Known issues

  • Insights Hub Start for Free is only compatible with a web browser and therefore cannot be launched from a mobile browser.
  • The creation of tenant takes approximately 2 minutes.
  • If the TourGuide is interrupted, check that your internet connection is stable. If this is not the problem, then re-launch the user journey from your Launchpad.
  • The data coming from the simulated pump asset will only be available the first 7 days after account creation.
  • While trying to launch an auto registered app which was created with the same name as that of a deleted app, a "Forbidden" error occurs.
    Workaround: The issue does not occur if you re-launch the browser after registration and then launch the app again.
  • For tenants with Enabled Session Persistency (see documentation), it is not recommended to use Google Chrome in incognito mode.

Subtenant Functionality

Applicable for:

  • MindAccess IoT Value Plan Subscribers
  • MindAccess Developer Plan Subscribers
  • MindAccess Operator Plan Subscribers

Known issues

  • 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

Applicable for:

  • Subscribers of Capability Packages
  • Subscribers of MindAccess Plan

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 Service

Applicable for:

  • Subscribers of Capability Packages
  • Subscribers of MindAccess Plan

Known issues

  • The Report tab is undergoing a major backend upgrade and hence shows a temporary outage. Once the upgrade is completed, new version of the tab will be made available.

Insights Hub Business Intelligence

Applicable for:

  • Subscribers of Insights Hub Business Intelligence

Known issues

  • For using Insights Hub Business Intelligence and Insights Hub Business Intelligence, a minimum screen size of 800x600 is required.
  • Any request within Insights Hub Business Intelligence is limited to an execution time of 60 sec.
  • The "share via link" functionality works unreliable.
  • For the time series data type “LONG”, only safe integer values are supported from (-2^53+1 to (2^53-1). Values outside of that range will be reset to safe integer values, example: 263 will be reset to 2^53-1.

Visual Flow Creator

Applicable for:

  • Visual Flow Creator Subscribers
  • Capability Packages Subscribers
  • Low Code Starter Kit

Known issues:

  • Compute hours are assigned to the main tenant only.
Last update: October 25, 2023

Except where otherwise noted, content on this site is licensed under the Development License Agreement.