Example: Configure an EFLOW device

The following example walks you through the process of setting up an Edge for Linux on Windows (EFLOW) device.

Set up your device

1. Install a supported version of Windows on a physical device or a virtual machine. See Understand operating system and bandwidth requirements for details about supported Windows versions.

2. If your device is a virtual machine, ensure that nested virtualization is enabled.

   1. If your device is an Azure virtual machine, choose a SKU that supports nested virtualization when you create the virtual machine. For example, Standard E8ds v5 (8 vcpus, 64 GiB memory.

   2. If your device is a Hyper-V virtual machine:

      1. Shut down the virtual machine.

      2. On the Hyper-V host, run the following command in an administrative PowerShell window, replacing <VMName> with the name of your VM as it is displayed in the Hyper-V management console:

         Set-VMProcessor -VMName <VMName> -ExposeVirtualizationExtensions $true

      3. Start the virtual machine.

      4. Install Hyper-V within the virtual machine.

Configure your device

3. Create a device in the Edge Management portal, selecting Windows x64 as the platform. See Add a Device Twin for more details.

4. Pair your device by running the pairing command in an administrative PowerShell window on your device. See Pair a device twin with an edge device for more details.

   The pairing command installs required software on the device, and this may cause the device to reboot. If your device reboots, generate and run the pairing command again, then proceed to the next step. If your device does not reboot, continue with the next step.

5. The pairing process continues. When you are asked if you want to run software from an untrusted publisher identified as Microsoft Corporation, select A for Always run.

   

6. After the pairing process completes, verify the status of your device in the Edge Management portal.

Add the Edge Module SDK module to your device

7. Select your device in the Edge Management portal.

8. Select the Modules tab.

9. Add the AVEVA Edge Module SDK Module to your device.

10. Set the required parameters for the module:

    1. Select which Version of the Edge Module SDK to install.

    2. Enter the Module Control Service Port number.

    3. Enter the Module Control Service Local Host Port number.

11. Select Update to save your changes.

12. Select the Deployment tab.

13. Enter a licence duration, then select Publish to update your device.

14. Allow a few minutes for your device to update, and then verify your device has changed to deployed status in the portal.

Verify the Edge Module SDK module

15. Run the following command in an administrative PowerShell window on your device to initiate a terminal connection to the Linux container:

    Connect-EflowVm

16. Run the following command in the Linux container to display the current network configuration:

    ifconfig

17. Identify the current IP address for eth0.

    

18. Identify the Module Control Service Port configured for your Edge Module SDK module.

    

19. Open a browser on your device, and navigate to http://<IP address>:<Module Control Service Port> to display the SDK test page, verifying that your device and module are configured and running.