Device Configuration¶
After you click + Add device on the Device Overview page, you can configure a new Edge Device and create an onboarding file.
This page has the following sections:
| Section | Description |
|---|---|
| Left section | Shows the list of devices. |
| Right section | Shows the device configuration. |
Synchronizing Edge Device Types
Only Edge Device Types that are synchronized with the IEM are available.
The IEM admin can synchronize Edge Device Types under Admin Management > Device Catalog.
For more information, see the Admin UI > Device Catalog subsection in the Industrial Edge Management - Operation manual.
Procedure¶
To configure a device, proceed as follows:
- Select a
deviceto start the configuration. - Configure the device as required within the following sections:
- Mandatory information
- Network
- Proxy.
-
Complete the configuration.
The onboarding file
device-<deviceId>.jsonis downloaded.
NOTICE
Based on the device capabilities, the sections Network and Proxy can differ.
Mandatory information¶
This section contains the mandatory inputs for creating and downloading the onboarding file:
| Field | Description |
|---|---|
| Device name | Define the device name. |
| Username | Enter the email address. |
| Password | Enter the password. |
| Expiration time of onboarding file | Select a value between 1 hour and 60 days. |
Network¶
This section has three optional subsections.
Network Interface¶
You can add network interfaces based on the device type capabilities.
To do this, click on Add network interface in the Network interfaces section.
The following options are available:
| Option | Description |
|---|---|
| DHCP | The IP address, subnet mask, and gateway are assigned automatically. |
| Manual | The IP address, subnet mask, and gateway are mandatory and must be entered when you create the network interface. This is only applicable if the selected device type is not cellular-capable. |
| DNS addresses | Primary and secondary DNS addresses are optional for both types. |
| Gateway NIC | The first created network interface is the gateway type by default. One NIC must be a gateway nic. |
| NIC identification | Create a network interface with MAC addresses or Ethernet labels. |
| Gateway change | Change the gateway NIC in the list of network interfaces. |
| Ethernet-capable device types | Add NICs with Ethernet labels or MAC addresses. |
| Mixed NIC identification | If the first NIC uses an Ethernet label, all following NICs must also use Ethernet labels. The same rule applies to MAC addresses. |
| Editing | Edit and delete added interfaces. |
| Cellular interface | If the selected device type has cellular capabilities, add a cellular network interface by selecting Cellular in the Add network interface pop-up menu. |
| Cellular fields | The cellular option includes an Access Point Name (APN) field and optional fields for PIN, username, and password. Only one cellular-capable network interface can be added. |
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 the respective Edge Device Type to find out whether you must configure the network interface settings for the Edge Device.
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 servers by clicking on Add NTP server in the NTP server section.
The following options are available:
| Option | Description |
|---|---|
| Multiple NTP servers | Add more than one NTP server. |
| Preferred NTP server | Mark one NTP server as preferred. This is optional. |
| Editing | Edit and delete added servers. |
Time synchronization of the Industrial Edge Management and Edge Devices
A reliable operation of Industrial Edge Management and Edge Devices requires time synchronization. To synchronize the time correctly, an NTP server is required. You can use the default Debian NTP servers after you connect the PC that runs Industrial Edge Management to the internet. If you operate Industrial Edge Management and Edge Devices in a local network without internet access, provide your own NTP server that both systems can reach.
Docker Internal Network¶
By default, the Edge Device contains two Docker networks: one for the proxy redirect and one for the docker0 interface that you create with the IP Address input field.
If you install an app that creates a new Docker network on the Edge Device, the Docker network of the installed app must not overlap with the Docker networks of the Edge Device and requires 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 contains the proxy settings:
| Field | Description |
|---|---|
| Proxy server URL | Enter the proxy server URL. |
| Username | Enter the username. |
| Password | Enter the password. |
| No proxy addresses | Enter addresses that must bypass the proxy. |
Proxy server configuration
The proxy server must be specified together with its port number.
Ports 80, 443, and 2020 are not permitted for use.