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 Oracle Server data - the IOTA Oracle Driver must be configured and deployed within a network which has access to required Oracle Servers. 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 Oracle 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 Oracle 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 the Oracle Driver to be used in Tag and Asset searches - specific Oracle connections must be configured from within IOTA Vue UI.

Warning

Oracle 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 Oracle Driver tab named Oracle within the selected site.
4. At the top right corner - click on the Add icon.

The Oracle Server connection dialog will appear.

connection dialog

1. Required Provide the Name for the Oracle Connection. All search results will be prefixed with this name
2. Required Specify the Oracle server Host name or IP address.
3. Required Specify the SID or Service Name.
4. Required Specify the Username and password.
5. Specify the full Connection String. Note, This setting overrides all other parameters.
6. Please check the Use in Quick Search check-box if Oracle Connection should be used for tag and asset searches.
7. Click on the Apply button to save changes.

Tips

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