Tricloud Nexus Documentation
  • Welcome
  • Introduction
    • Overview of Tricloud Nexus
    • Purpose and Scope of the Documentation
    • Release Notes
      • 2024-12-20 - Release 1.8
      • 2024-10-05 - Release 1.7
      • 2024-07-01 - Release 1.6
      • 2024-02-25 - Release 1.5
      • 2023-10-09 - Release 1.4
      • 2023-05-09 - Release 1.3.1
      • 2023-04-28 - Release 1.3
      • 2023-02-14 - Release 1.2
    • Quick Start Guide
      • Provision an Edge device
      • Create Asset Hierarchy with emulated data
      • Deploy Hierarchy to Edge device
      • Gain Insights from Queries
      • Nexus Edge SDK
Powered by GitBook
On this page
  • Edge Devices
  • Setup an Edge Device
  • Prerequisites
  • Create a device configuration
  • Provision the device
  • Verify Device Connectivity
  • Additional Setup
  • Hostname Allow-list

Was this helpful?

  1. Introduction
  2. Quick Start Guide

Provision an Edge device

Before configuring data collection or deploying modules and application you need to provision an edge device. This quick-start will guide you through provisioning of an edge device.

PreviousQuick Start GuideNextCreate Asset Hierarchy with emulated data

Last updated 4 months ago

Was this helpful?

Edge Devices

An edge device in Tricloud Nexus is based on Azure IoT Edge, which supports a range of OS options. To learn more about the capabilities and supported systems, see the official documentation.


Setup an Edge Device

Follow these instructions to create and connect an Edge device to Tricloud Nexus.

Prerequisites

Before provisioning an edge device and connecting it to Tricloud Nexus, you must first install a supported OS on the target computer. You must also ensure that the target computer has outbound network connectivity to a set of pre-defined hostnames, which is used during provisioning and for data collection. See this list of hostnames used by edge devices.

Create a device configuration

To provision a device in Tricloud Nexus, the first thing to do is to create a configuration for the device.

  1. First select Configurations under the Management section in the navigation menu.

  2. Then click Add in the Devices toolbar.

  3. In the New Device Configuration dialog enter a unique device id (NOTE: a device id can only contain the characters A-Z, a-z, 0-9, -, _) and then click Save.

  4. The device configuration will appear under the Unprovisioned device list

Provision the device

Once the device configuration has been created, the next step is to provision the device and connect it to Tricloud Nexus.

  1. Go to Settings under the newly created device configuration.

  2. Select Provision Device.

  3. In the Provision a Device dialog, first select the device OS (Linux or Windows) and then select the variant and version.

  4. Then select a Provisioning Endpoint, which in most scenarios is already pre-selected and then select an Enrollment option, which this quick-start guide assumes is set to Symmetric Key attestation mechanism.

  5. Then follow the on-screen instructions for:

    1. Prerequisites: login and download of the device installation script

    2. Installation: Runs the installation and provisioning script

    3. Verification: Steps to ensure that the device is provisioned and connected successfully

Verify Device Connectivity

The verification step in the provisioning dialog will test outbound connectivity from the device to the platform. It is also possible to verify connectivity from the Management Portal. Follow the steps to verify connectivity.

  1. Go to Monitoring under Operations section in the navigation menu.

  2. Expand the device tree and select the newly provisioned device.

  3. A dialog will then show if the platform has connectivity to the device as shown here:

  4. Click Ok to close the dialog.

You have now provisioned a device and can continue to create an Asset Hierarchy.


Additional Setup

To ensure successful device provisioning and connectivity to Azure, the following section describes additional requirements.

Hostname Allow-list

In order to provision a device, deploy modules and ingest data to Azure, a set of public endpoints needs to be whitelisted for outbound traffic from the edge device. This list is an example and will need to be updated to the specific installation of the platform.

Name
Purpose
Hostname
Port(s)

Tricloud Nexus Support Files

Contains installation files used during device provisioning.

tricloudnexussupport.blob.core.windows.net

443

Microsoft Linux Package Repository

Official Linux package repository for IoT Edge runtime binaries.

443

Microsoft Artifact Registry

Official Artifact Registry for IoT Edge system container images.

443

Official Tricloud Nexus Container Registry

Official Container Registry for Tricloud Nexus container images.

tricloud.azurecr.io

443

Azure IoT Hub Device Provisioning Service

Instance specific Azure resource, used to connect devices to the platform.

global.azure-devices-provisioning.net, <instancename>.azure-devices-provisioning.net

443

Azure IoT Hub

Instance specific IoT Hub used for device management and data ingestion.

<instancename>.azure-devices.net

443, 5671, 8883

Azure Container Registry

Instance specific container registry used by edge devices to pull container images.

<instancename>.azurecr.io

443

Azure Storage Account

Instance specific cloud storage used for data ingestion.

<instancename>.blob.core.windows.net

443

Click Ping Device in the device toolbar.

packages.microsoft.com
mcr.microsoft.com
Dialog showing the result of pinging the device