Skip to content

Device Configuration

After you click + Add device on the Device Overview page, you can start the configuration of a new Edge Device to finally create an onboarding file.

This page is split into two sections:

  • Left section: List of devices

    NOTICE

    Synchronizing Edge Device Types
    Only Edge Device Types that are synchronized with the IEM are available. The admin of the IEM can synchronize Edge Device Types with the IEM under Admin Management > Device Catalog. You find further information on synchronizing Edge Device Types in the Admin UI > Device Catalog subsection in the Industrial Edge Management - Operation manual.

  • Right section: Configuration

Procedure

  1. Select a device to begin the configuration
  2. Configure the device as required within the following sections:
    • Mandatory information
    • Network
    • Proxy
  3. Upon the completing of the configuration, an onboarding file named onboarding-<deviceName>.json is downloaded

NOTICE

Based on the device capabilities, the sections Network and Proxy can differ.

Mandatory information

This section includes all mandatory inputs to create and download the onboarding file:

  • Device name
  • Username (Email address)
  • Password
  • Expiration time of onboarding file (Range 1 hour to 60 days)

Network

This section has three optional subsections:

Network Interface

You can add network interface(s) based on device type capabilities by clicking Add network interface button from Network interfaces section.

  • First network interface created will be gateway type by default. One NIC has to be a gateway nic.
  • Network interface can be created using MAC addresses or Ethernet labels.
  • You can change the gateway NIC from the list of network interfaces.
  • For device types with Ethernet capabilities, you can add NICs with either Ethernet labels or MAC addresses.
  • If the first NIC is created with an Ethernet label, all subsequent NICs must also use Ethernet labels, and the same applies to MAC addresses.
  • Added interfaces can be edited and deleted.

NOTICE

You can find the available type of the network interface connection of the respective Edge Device Types in the Edge Device Type details under Admin Management > Device Catalog. Contact the Device Builder or check the documentation of that Edge Device Type to know, if you must configure the network interface settings for the Edge Device or not.

NOTICE

Configuring a DNS server is recommended to avoid unexpected system behavior. Without a customized configuration, some services may use a public DNS, which requires internet access.

NTP Server

You can add NTP server(s) by clicking Add NTP server button from NTP server section.

  • You can add multiple NTP servers.
  • Also maximum one NTP server (optionally) can be marked as preferred.
  • Added servers can be edited and deleted.

NOTICE

Time synchronization of the Industrial Edge Management and Edge Devices
A flawless operation of the Industrial Edge Management and Edge Devices require time synchronization of the Industrial Edge Management and Edge Devices. To properly synchronize the time on the Industrial Edge Management and Edge Devices, an NTP server is required. Either use the default configured Debian NTP servers which will be used once you connect the PC, on which the Industrial Edge Management is running, with the Internet. Or, when you operate the Industrial Edge Management and Edge Devices disconnected from the Internet in your local network, provide an own NTP server to which the Industrial Edge Management and Edge Devices must be able to connect to.

Docker Internal Network

By default, the Edge Device contains 2 Docker networks, 1 for the proxy-redirect and 1 for the docker0 interface (that you create via the IP Address input field).
When you install an app which creates a new Docker network on the Edge Device, the Docker network of the installed app must not overlap the Docker networks of the Edge Device and need free Docker network IP ranges on the Edge Device.
By default, the docker0 interface starts with 172.17.0.0. Using a different docker0 interface is optional.

Proxy

This section allows you to fill in proxy inputs:

  • Proxy server URL
  • Username
  • Password
  • No proxy addresses

NOTICE

Proxy server configuration
The proxy server must be specified along with its port number. Ports 80, 443, and 2020 are not permitted for use.