Creating a configuration file

Procedure

1. Open and log into the Management UI.

2. Navigate to the Edge Devices menu item.

3. In the Edge Devices screen, click New Edge Device.
   The New Edge Device screen is displayed.
   

4. In the Device tab, enter all the required information according to the New Edge Device ‑ Parameters subsection.

!!! info "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.

1. After entering all required information, click Next.
   
   The Network Interface tab is displayed.
   

2. To configure the network interface settings for the Edge Device, click the icon under the Network Interface section.
   Configuring the network interface settings for the Edge Device is optional. It depends on the Edge Device Type whether you must configure the network interface settings or not. If you do not need to configure the network interface settings, the Edge Device is using the default network interface settings provided by the Device Builder. In this case, you can proceed configuring an NTP server and a Docker network as described from step 11 ongoing.

   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.

   The Add Network Interface screen is displayed.
   
   Depending on the Edge Device Type, the Edge Device Type and its network interfaces are displayed at the top of the screen.

3. Enter the network interface settings of the Edge Device according to the New Edge Device ‑ Parameters subsection.

4. If required, set up a Layer 2 network access on this Edge Device under the Layer 2 (L2) for Apps section.
   Setting up a Layer 2 network access for apps is optional. You find more information on the Layer 2 network access for apps in the Layer 2 network access subsection.
   When setting up a Layer 2 network access, enter the required information according to the New Edge Device ‑ Parameters subsection.

5. When finished, click Add.
   The configured network interface is added.
   If you have entered a MAC address, the MAC address is displayed in the table.
   
   If you have selected an Ethernet label, instead of the MAC address, the Ethernet label is displayed in the table.
   
   You can add more than 1 network interface by clicking the icon again and adding another network interface. If the maximum number of network interfaces is reached, the icon is disabled.
   If you have configured a Layer 2 network access, the L2 check mark is activated which means that the L2 network access is enabled.
   
   If you click again the button to add another network interface, the Layer 2 for Apps (L2) section displays Already configured. You can just configure 1 Layer 2 network access per Edge Device.

6. Select 1 Network Time Protocol (NTP) server you want to use for this Edge Device under the NTP Server section.
   When you already have configured an NTP server during the setup of the Industrial Edge Management or when you added an NTP server in the Maintenance UI settings and selected the Use Same NTP On IED check box, the NTP servers are displayed under the NTP Server section.
   
   If you want to use an other NTP server, enter the NTP server in the Server Name input field, click the plus icon and select the newly added NTP server.
   

   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.

7. If you want to change the default Docker network, click the Docker Internal Network check box.
   
   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.

8. In the IP Address input field, select the IP address of the docker0 interface you want to use for the Edge Device.
   The IP address of the docker0 interface is the start of the docker0 interface. The subnet mask is not configurable.

9. Click Next.

10. In the Proxy tab, enter, if needed, all required proxy information according to the New Edge Device ‑ Parameters subsection.
    

11. Click Create.
    A configuration file named device-'deviceID' is downloaded to the standard download folder of your Internet browser.

NOTICE

The onboarding file is valid for two hours. You can re-create the onboarding file by clicking on the three dots of the device tile and select "Create Onboarding File".