Skip to main content
Hitachi Vantara Lumada and Pentaho Documentation

Manage industrial assets

You can use the IIoT Core Services to build and manage digital industrial assets.

What are digital industrial assets?

With IIoT Core, you can create digital twins, digital representations of real world industrial assets, also called digital industrial assets or assets for short. Digital industrial assets can be complex assets consisting of a large tree of child assets, or they can be small component-level assets.

Assets have metadata where you can define attributes such as the name of the asset, its location, and its sensors. You can attach its digital twin (if available) as well as one or more data routes that define how the asset data flows to its destination.

Process summary

You can build a digital industrial asset using the IIoT Core Services UI (also called Edge Manager) as follows:

  1. Create an asset type to define an asset template and thereby simplifying the process of building an industrial asset.
  2. Create an asset using that asset type as a template.

    Repeat these steps to build the needed hierarchical asset structure by adding child assets to existing assets.

  3. Verify the data routes associated with each asset in Create and view data routes for assets.
  4. Use Hitachi Vantara’s ML Services component to build and train Machine Learning (ML) models. Hitachi Vantara will help you with modeling and creating digital twins. For more information, see the Machine learning service user documentation.
  5. In the IIoT Core Services UI, attach Digital Twin types if available for the asset.

Working with asset types

Asset types are templates that provide a quicker and more consistent way of creating assets.

Create an asset type

You can create asset types on the Administration tab of the IIoT Core Services UI.

Procedure

  1. In the IIoT Core Services UI, select the Administration tab, then the Asset Types sub-tab.

  2. Click Add Asset Type to create an asset type.

    The Create Asset Types window opens.
    FieldDescription
    Asset Type NameEnter a meaningful name for the asset type. The name has to be unique. Once the asset type is saved, the asset type name cannot be changed.
    Asset Type DescriptionProvide a description of the asset type to clarify its purpose.
  3. Click Add Attributes to add static attributes to the asset, such as Model ID or Year.

    A new row is added to the Asset Attributes list.If you enter an invalid attribute, an error message appears..
    FieldDescription
    RequiredSelect the Required check box if the attribute is mandatory. When you select this box, you cannot delete the attribute during asset creation.
    Attributes NameEnter a meaningful name for the attribute.
    TypeSpecify the data type for the attribute. For predefined asset types, the data type is specified when creating the asset type.
    Default ValueThe default attribute value used when creating an asset with this asset type. It has to correspond to the specified Type.
    DescriptionDescribe the purpose of the attribute.
    ActionClick Save to save the attribute.
  4. Click Add Properties to add properties to the asset.

    Asset properties are dynamic data received from the sensor, such as Load or Temperature.
    FieldDescription
    Property NameEnter a property name that indicates what kind of data is received.
    TypeSpecify the data type for the sensor data.
    SaveClick Save to save the property.
  5. At the bottom of the screen, click Create to create the asset type.

Results

The new asset type is created. You can view it at the top of the Asset Types list.

Edit an asset type

If it is not used by an asset, you can edit the asset type. If it is being used, you must first delete the assets that use the respective asset type.

NoteOnce you create an asset type, you cannot change its name.

Procedure

  1. In the IIoT Core Services UI, select the Administration tab, then Asset Types.

  2. Click the pencil icon for the asset type that you want to edit.

    The Edit Asset Type page opens.
    NoteIf you receive an error when you click the pencil icon, the asset type is already in use.
  3. Make your changes.

  4. Click Save to keep your changes.

Delete an asset type

You can delete an asset type in IIoT Core Services if it is not used by any assets.

Procedure

  1. In the IIoT Core Services UI, select the Administration tab.

  2. Click the trash bin icon for the asset type that you want to delete.

    If you receive an error, check whether the asset type is used by one or more assets.
  3. Click Delete in the confirmation window.

Results

The asset type is removed from the asset type list.

Working with assets

You can create and manage industrial assets in the IIoT Core Services UI.

Create an asset

You can use the following procedure both for creating top-level (parent) assets and for creating child assets in the IIoT Core Services UI. You can add child assets at any level in the Asset Structure pane.

Before you begin

Before creating assets, one or more asset types must be available. See Create an asset type.

Procedure

  1. In the IIoT Core Services UI, select the Asset tab.

  2. Perform one of the following steps:

    • To create an asset without a parent, click Add Asset.
    • In the Asset Structure pane, to create a child asset for an existing asset select the Actions menu ( GUID-860D1A4B-E960-45FE-81C1-4D6E31957DF8-low.png ) for the asset , then Add Asset Child.
  3. Complete the asset information on the Create Asset page:

    FieldDescription
    NameEnter a name for the asset. The name must be unique.
    Parent AssetID of the parent asset, if any. If you are creating a child asset, this field is auto-populated with the name of the parent asset. If you are creating a top-level asset, this field is not applicable.
    Asset TypeSelect one of the predefined asset types from the list. If attributes and properties were added when the asset type was created, they appear in their respective sections below.
    DescriptionProvide a description of the asset to clarify its purpose.
    ImageSelect an image of your choice to represent the asset.
  4. Click Add Attribute to add static attributes to the asset, such as Model ID or Year.

    Some asset types have predefined attributes. For those attributes, you can only modify the Value field. If an attribute is not required, you can delete it. Predefined asset types are created on the Asset Types sub-tab of the Administration tab (see Create an asset type).
    FieldDescription
    Attribute NameEnter a meaningful name for the attribute.
    TypeSpecify the data type for the attribute. For predefined asset types, the data type is specified when creating the asset type.
    ValueThe attribute value. This value must correspond to the specified Type.
    DescriptionProvide a short description of the attribute.
    ActionClick Save to save the new or modified attribute. For predefined attributes, click Edit to edit the Value field.
  5. Click Add Properties to add properties to the asset..

    Asset properties are dynamic data received from the asset, such as Load or Temperature..
    FieldDescription
    Property NameEnter a name that indicates what kind of sensor data is received.
    TypeSpecify the data type for the sensor data.
    SaveClick Save to save the new or modified property.
  6. At the bottom of the page, click Save to save the asset.

Results

If you created a child asset, the new asset is displayed under the parent asset where it was created in the Asset Structure pane. If you created a top-level asset, it is displayed as a top-level tree node and an asset card is added in the main window.

Edit an asset

You can edit an asset in the asset inventory using the IIoT Core Services UI. However, the asset name cannot be changed once it is created.

Procedure

  1. In the IIoT Core Services UI, select the Asset tab to view the asset inventory.

  2. In the Asset Structure pane, navigate to the relevant asset, double-click the asset, then click Edit.

    Alternatively, select the Actions menu ( GUID-860D1A4B-E960-45FE-81C1-4D6E31957DF8-low.png ) of a selected asset and then click Edit.
  3. Make the necessary edits.

    NoteYou cannot delete attributes that were set to Required when the asset type was created. To modify these settings, see Edit an asset type.
  4. Click Save to save your changes.

Delete an asset

You can delete an asset in the IIoT Core Services UI if it has no child assets.

CautionEach data route is associated with an asset, so deleting an asset also deletes any data routes associated with it.

Procedure

  1. In the IIoT Core Services UI, select the Asset tab to enter the asset inventory.

  2. Navigate to the location of the asset in the Asset Structure pane and select the Actions menu ( GUID-860D1A4B-E960-45FE-81C1-4D6E31957DF8-low.png ) for the asset, then Delete.

    Alternatively, browse the asset cards and select the Actions menu ( GUID-860D1A4B-E960-45FE-81C1-4D6E31957DF8-low.png ), then Delete.If the asset has any child assets, you must delete them first.
  3. Click Delete to confirm that you want to delete the asset, otherwise Cancel.

Results

The asset is removed from the Asset Structure pane and the asset card is removed from the main window.

Create and view data routes for assets

You can use the IIoT Core Services UI to create and manage data routes. For instructions, see Create a data route using the IIoT Core Services UI.

In the asset management part of the UI, you can see which data routes are associated with your asset using the following procedure.

Procedure

  1. In the IIoT Core Services UI, select the Asset tab.

  2. Click an asset in the Asset Structure navigation.

    Alternatively, select View from the Actions menu ( GUID-860D1A4B-E960-45FE-81C1-4D6E31957DF8-low.png ) of any given asset.
  3. Click the Data Routes tab to view the data routes associated with the digital twin.

  4. Click View for a route to see the data route information.

Activate and deactivate Digital Twin mode

When Machine learning service are turned on and models are available, you can use the IIoT Core Services UI to select an ML model and activate Digital Twin mode.

For more information about Machine learning service and to create a Digital Twin type, contact your Hitachi Vantara representative.

Procedure

  1. In the IIoT Core Services UI, select the Asset tab.

  2. Click an asset in the Asset Structure navigation.

    Alternatively, select View from the Actions menu ( GUID-860D1A4B-E960-45FE-81C1-4D6E31957DF8-low.png ) of any given asset.
  3. To add a Digital Twin model, select the Models tab and click Add Model.

    The Add Model window opens.
  4. Click the Available Models list and select a model.

  5. Click Activate to activate Digital Twin mode.

Results

When successfully activated, IIoT Core receives data for the digital twin. View its status and analysis on the Insights and Events tabs.

View insights for digital twins

Once a digital twin has been activated, you can use the IIoT Core Services UI to gain analytical insights.

Procedure

  1. In the IIoT Core Services UI, select the Asset tab.

  2. Click an asset in the Asset Structure navigation.

    Alternatively, select View from the Actions menu ( GUID-860D1A4B-E960-45FE-81C1-4D6E31957DF8-low.png ) of any given asset.
  3. Click the Insights tab to view anomaly scores and other analytics.

    Browse the time scale to get information about other time segments.

View digital twin events

Once a digital twin has been activated, you can examine events at different timepoints and related analytics.

Procedure

  1. In the IIoT Core Services UI, select the Asset tab.

  2. Click an asset in the Asset Structure navigation.

    Alternatively, select View from the Actions menu ( GUID-860D1A4B-E960-45FE-81C1-4D6E31957DF8-low.png ) of any given asset.
  3. Click the Events tab to view the event history.

  4. Click View for a given timestamp to the event report details.