Release Notes 5.0.0
About this document
This document provides late-breaking information about IIoT Core v5.0.0. It may also include information that was not available at the time the technical documentation for this product was published, as well as a list of known issues and possible solutions.
Intended audience
This document is intended for customers and Hitachi Vantara partners who license and use IIoT Core.
Accessing product downloads
Product software downloads are available on Hitachi Vantara Support Connect: https://support.pentaho.com/.
Log in and select Product Downloads to access the most current downloads, including important updates that may have been made after the release of the product.
About this release
You can use IIoT Core to gain insights into your industrial operations by onboarding and processing data close to its source through a flexible and composable architecture.
IIoT Core includes a small gateway software stack called the IIoT Gateway that can ingest data from automation and IIoT devices. The gateway software and device is managed by a management node referred to as IIoT Core Services that is operated through a user interface. IIoT Core Services also serves as a data aggregator for multiple gateways.
Features
The following features and enhancements are new in this release:
· IIoT Core Services
o Asset hierarchy supporting tree structure with parent-child relationships
o Convenient visual navigation and management of asset hierarchy
o Digital Twin type association for assets
o Machine Learning (ML) Service integration
o Single sign-on with Machine Learning (ML) Service
o Supports InfluxDB 2.1
o Supports RedHat 8.4
o Supports Google Kubernetes Engine 1.21.6
o Supports Kubernetes Engine 1.21.6 for on-premises environments
· IIoT Gateway
o Connect to multiple Modbus endpoints using the existing Modbus connector provided by the IIoT Gateway software
o Supports gateway hardware based on ARM architecture
o Supports Ubuntu 20.04
o Supports RedHat 8.4.
Notice about API changes
The Asset Model has changed in IIoT Core v5.0. The v4.2 asset API has been retired and replaced by a new v5.0 API with different input and outputs. As a result, any third-party code that relies in the v4.2 asset API should be updated to use the new v5.0 asset API.
The following APIs have changed in IIoT Core v5.0:
| Description | URL | API changes |
| Get asset by type | /api/v1/hiota-asset/assets | The avatar type is not accepted as a query parameter. New API: For avatar asset, use "List Asset Instances" at If the name parameter is provided, it returns the assets filter by name. |
| Create asset | /api/v1/hiota-asset/assets | Does not accept the payload under the avatar field. New API: For avatar asset, use "Create Asset Instance" at |
| List top hierarchy assets by type | /api/v1/hiota-asset/assets | Does not accept the avatar type as a query parameter. New API: For avatar asset, use "Retrieve a list of asset instances at top hierarchy" at |
| Filter assets by attribute | /api/v1/hiota-asset/assets | Response payload doesn’t have an avatar section. New API: For avatar asset, use "Filter asset instances by attribute" at It also can support search using a few built-in attributes, like description. |
| Filter assets by property | /api/v1/hiota-asset/assets | Response payload doesn’t have an avatar section. |
| List child assets | /api/v1/hiota-asset/assets/{assetId}/children | Response payload doesn’t have an avatar section. New API: For avatar asset, use "List Asset's Downstream assets" at |
| Get/update asset by ID | /api/v1/hiota-asset/assets | Response payload has an empty avatar section. New API: For avatar asset, use "Get/Update/Delete Asset Instance by Id" at |
| List collection's asset | /api/v1/hiota-asset/collections/{collectionId} | Response payload doesn’t have an avatar section. |
The following APIs are unchanged from v4.2 and are compatible with v5.0:
| Description | URL |
| List Collections | /api/v1/hiota-asset/collections |
| Create Collection | /api/v1/hiota-asset/ collections |
| Get/Delete/Update Collection | /api/v1/hiota-asset/collections/{collectionId} |
| List Asset Status | /api/v1/hiota-asset/assets/{assetId}/status |
| Get Asset Status | /api/v1/hiota-asset/assets/{assetId}/status |
| Append Asset Image | /api/v1/hiota-asset/assets/{assetId}/image |
| Delete Asset by Id | /api/v1/hiota-asset/assets/{assetId} |
Resolved Issues
· Pressing the Archive button now archives the record correctly in line with the success alert message in the user interface.
· A problem editing the Modbus protocol adapter configuration in the IIoT Core Services (Edge Manager) UI has been fixed.
· The Invalid Character warning message in the installer script has been fixed.
· An issue has been resolved where the data flow in a data route to an InfluxDB destination would stop as a result of any changes in Database bucket name, Table name, or field.
· The memory leak in MinIO due to a Linux kernel issue has been fixed.
Known Issues and workarounds
· If the Gateway is disconnected from IIoT Core for a long time, the Gateway may run out of Store and Forward volume space. The way to mitigate this issue is to tune the Store and Forward retry count and interval parameters via the IIoT Core Services (Edge Manager) UI until the error no longer occurs. A specific value cannot be recommended as that value depends on the Gateway data ingestion rate. The higher the data volume, the more likely that Store and Forward will use up the available volume space in the event of a disconnect.
· Running the IIoT Core 5.0.0 installer produces multiple warning messages, which can be safely ignored.
· While uploading files to the repository from the IIoT Core Services UI using Firefox or Safari, if an upload disruption occurs due to browser logout or page refresh, then the resume upload function will fail. If this happens, restart the upload.
Documentation
IIoT Core product documentation is available here:
https://help.hitachivantara.com/Documentation/Lumada/Lumada_Industrial_DataOps/IIoT_Core
Copyrights and licenses
© 2019, 2022 Hitachi, Ltd. All rights reserved.
No part of this publication may be reproduced or transmitted in any form or by any means, electronic or mechanical, including copying and recording, or stored in a database or retrieval system for commercial purposes without the express written permission of Hitachi, Ltd., or Hitachi Vantara LLC (collectively "Hitachi"). Licensee may make copies of the Materials provided that any such copy is (i) created as an essential step in utilization of the Software as licensed and is used in no other manner; or (ii) used for archival purposes. Licensee may not make any other copies of the Materials. "Materials" mean text, data, photographs, graphics, audio, video and documents.
Hitachi reserves the right to make changes to this Material at any time without notice and assumes no responsibility for its use. The Materials contain the most current information available at the time of publication.
Some of the features described in the Materials might not be currently available. Refer to the most recent product announcement for information about feature and product availability or contact Hitachi Vantara LLC at https://support.hitachivantara.com/e...ontact-us.html.
Notice: Hitachi products and services can be ordered only under the terms and conditions of the applicable Hitachi agreements. The use of Hitachi products is governed by the terms of your agreements with Hitachi Vantara LLC.
By using this software, you agree that you are responsible for:
1) Acquiring the relevant consents as may be required under local privacy laws or otherwise from authorized employees and other individuals; and
2) Verifying that your data continues to be held, retrieved, deleted, or otherwise processed in accordance with relevant laws.
Notice on Export Controls. The technical data and technology inherent in this Document may be subject to U.S. export control laws, including the U.S. Export Administration Act and its associated regulations, and may be subject to export or import regulations in other countries. Reader agrees to comply strictly with all such regulations and acknowledges that Reader has the responsibility to obtain licenses to export, re-export, or import the Document and any Compliant Products.
Hitachi and Lumada are trademarks or registered trademarks of Hitachi, Ltd., in the United States and other countries.
AIX, AS/400e, DB2, Domino, DS6000, DS8000, Enterprise Storage Server, eServer, FICON, FlashCopy, GDPS, HyperSwap, IBM, Lotus, MVS, OS/390, PowerHA, PowerPC, RS/6000, S/390, System z9, System z10, Tivoli, z/OS, z9, z10, z13, z14, z/VM, and z/VSE are registered trademarks or trademarks of International Business Machines Corporation.
Active Directory, ActiveX, Bing, Excel, Hyper-V, Internet Explorer, the Internet Explorer logo, Microsoft, the Microsoft Corporate Logo, MS-DOS, Outlook, PowerPoint, SharePoint, Silverlight, SmartScreen, SQL Server, Visual Basic, Visual C++, Visual Studio, Windows, the Windows logo, Windows Azure, Windows PowerShell, Windows Server, the Windows start button, and Windows Vista are registered trademarks or trademarks of Microsoft Corporation. Microsoft product screen shots are reprinted with permission from Microsoft Corporation.
iPhone, iPad, iPod touch, and App Store are registered trademarks or service marks of Apple Inc.
iOS is a trademark or registered trademark of Cisco in the U.S. and other countries and is used under license.
All other trademarks, service marks, and company names in this document or website are properties of their respective owners.
Copyright and license information for third-party and open source software used in Hitachi Vantara products can be found at https://www.hitachivantara.com/en-us...any/legal.html.