Installation - Azure/iotedge-eflow GitHub Wiki

Table of Contents

  1. How can I install EFLOW in a Windows host?
  2. Issue: Deployment failed because of errors with the EFLOW VM creation
  3. Issue: Error when checking EFLOW Pre-requisites on a target device
  4. Issue: Certificate Trust problem with Deploy-Eflow - Signature is not valid

How can I install EFLOW in a Windows host?

Follow the steps in Install and provision Azure IoT Edge for Linux on a Windows device to set up a device with IoT Edge for Linux on Windows.

Issue: Deployment failed because of errors with the EFLOW VM creation

This error could be related to multiple things. However, it's generally attributed to turned off virtualization or having some issues with virtualization settings inside UEFI/BIOS.

If the problem persists, check that the virtualization is correctly configurated in the UEFI/BIOS settings. You can check if Intel Virtualization is enabled without going to BIOS in Windows 10 using the following guide.

Another potential cause of the problem is the lack of storage needed for the VM to be installed. If you're using the default EFLOW disk size 10 GB), check you have the available 12 GB needed in your targeted drive. If not, free up some space and try again, or use another drive.

Also, check the minimum requirements. It's important to allocate the necessary memory (check Architecture & Requirements). However, it's important not to allocate all the host memory to the VM.

Issue: Error when checking EFLOW Pre-requisites on a target device

Generally, this problem is caused by a lack of connection to the Windows host. To verify connectivity, start by trying to establish a connection to the Windows target device using WAC. If a connection can't be established, then try to troubleshoot the target device connectivity.

Issue: Certificate Trust problem with Deploy-Eflow - Signature is not valid

  1. Run CertMgr on a machine that has internet connectivity
  2. Expand Trusted Publisher \ Certificates folder
  3. Open Certificate Issued To Microsoft Corporation
  4. Open Certificate Path and verify that the certificate chain is complete showing the following

MicrosoftCert

  1. Open Details tab and select Copy to File
  2. In the Certificate Export Wizard click Next
  3. Select DER encoded binary X.509 (.CER) then select Next
  4. Save file as “Trusted Publisher” then select Next then Finish and OK to confirm Export
  5. Return to Certificate Path tab and select Microsoft Code Signing PCA 2011 and select View Certificate
  6. Repeat steps 5-8 naming this one “Intermediate CA”
  7. Select OK to close this certificate returning back to the view of #4 above
  8. Select Microsoft Root Certificate Authority 2011 and select View Certificate
  9. Repeats steps 5-8 naming this one “Root CA”
  10. Close all certificates and CertMgr
  11. Copy all three certificates to the target device you need to repair.
  12. On the Target device right click on “Root CA” and select Install Certificate
  13. Store Location = Local Machine and select Next
  14. Select Place all certificates in the following store then select Browse and choose Trusted Root Certification Authorities, OK then Next and Finish and OK to confirmation
  15. Right click on “Intermediate CA” and select Install Certificate
  16. Store Location = Local Machine and select Next
  17. Select Place all certificates in the following store then select Browse and choose Intermediate Certificate Authorities, OK then Next and Finish and OK to confirmation
  18. Right click on “Trusted Publisher” and select Install Certificate
  19. Store Location = Local Machine and select Next
  20. Select Place all certificates in following store then select Browse and choose Trusted Publishers, OK then Next and Finish and OK to confirmation
  21. Now run CertMgr on the target device
  22. Under Trusted Publishers\Certificates open Microsoft Corporation and select Certification Path. You should see the same thing from step 4 above.

Issue: EFLOW 1.1.2111.17111 Update - Cannot deploy using static IP

The EFLOW 1.1.2111.17111 update introduced a bug in the way we handle Static IP. This bug is only present in fresh MSI installations.

⚠️ **GitHub.com Fallback** ⚠️