UI Data Source Configuration

Due to distributed IOTA Vue architecture - each on-premise data driver installation requires 3 steps:

• Install the on-premise driver service
• Register the data driver in IOTA Vue user interface.
• Configure server connections per each registered data driver

This section covers the data driver registration and server connection configurations in IOTA Vue user interface.

Overview

In order for IOTA Vue to access CONNECT data services data - the IOTA Driver for CONNECT data services (CDS) must be configured and deployed within a network which has access to required CONNECT data services tenants. The IOTAVue uses distributed "mesh-like" data source topology:

Users are free to define what Region and Site mean for their unique deployment.

Name	Example	Description
Region	us-east-1	geographical territory, similar to availability regions
Site	siteB	specific plant or a building

To simplify the installation process, the IOTA Software provides an automated driver installer generation. The user is only required to select/create a region and site. Then for selected driver type, download the installer. The installer will contain all necessary CDS (ADH) Driver configuration with public and private keys for secure communication with the IOTA Vue message bus.

To access the Data Sources menu, click at the top right corner on the "hamburger" icon, then select Data Sources.

open_datasources

Add Region

Click on the Add icon to add a new region, then in the popup dialog - enter the region name.

There are two input fields:

• Region name
• Channel name (optional)

The region name is a user-friendly name, and the channel name can contain abbreviations. If the channel name is not provided, it is automatically assigned to the region name on the Apply button click.

Add Site

Click on the Add icon to add a new site, then in the popup dialog - enter the site name. Make sure the Aveva DataHub checkbox is selected. Each site can contain multiple driver types. For each checked driver type - the instance pane will contain selected driver tabs to which connection instances can be added.

There are three input fields:

• Site name
• Driver type
• Channel name (optional)

The site name is a user-friendly name, and the channel name can contain abbreviations. If the channel name is not provided, it is automatically assigned to the site name on the Apply button click.

Add connection

In order for CDS (ADH) Driver to be used in Tag, Asset and Timeframe searches - specific CONNECT data services connection(s) must be configured from within IOTA Vue UI.

Warning

The CDS (ADH) Driver for specific region and site combination must be installed prior to creating a new connection instance.

To add a new connection instance, navigate to data sources menu, then:

1. Select region of interest
2. Select the site of interest
3. Select the CDS (ADH) Driver tab named Aveva DataHub within the selected site.
4. At the top of Aveva DataHub tab left corner - click on the Add icon.

The CONNECT data services connection dialog will appear.

Note

The CDS (ADH) Driver uses HTTPS to communicate to CONNECT data services endpoint.

connection dialog

1. Required Provide the Name for the specific CONNECT data services Connection. All search results will be prefixed with this name
2. Specify the CONNECT data services resource URL. Default: https://uswe.datahub.connect.aveva.com
3. Required Specify the Namespace Id.
4. Required Specify the Tenant Id.
5. Required Specify the Client Id.
6. Required Specify the Client Secret.
7. Specify the Seeq Host URL.
8. Specify the Seeq Datasource Id which maps to this specific CDS (ADH) configuration: resource, namespace id and tenant id.
9. Please check the Use in Quick Search if CONNECT data services should be used for Tags, Asset, Timeframe searches.
10. Click on the Apply button to save changes.

Tips

If CONNECT data services Connection has the Use in Quick Search check-box selected, it becomes available in the search sidebar.