Skip to main content
Version: Next

For Windows 10

Updated 2024.12.17

Enabling WSL​

WSL Environment Setup​

To ensure WSL operates stably, make the following changes in Windows settings:

  • Enable WSL related features
    1. Search for "Turn Windows features on or off" in Windows settings and run it.
    2. Enable 'Hyper-V' and click OK.
    3. Enable 'Windows Subsystem for Linux' and click OK.
    4. Enable 'Virtual Machine Platform' and click OK.
    5. Reboot your PC.

Installing and Verifying WSL​

WSL (Windows Subsystem for Linux) provides an environment to access Linux features on Windows. WSL is supported from Windows 10 version 2004 (build 19041)

Run PowerShell as an administrator and verify the following command works:

wsl --install

If the command does not work, refer to the following link to install WSL: https://learn.microsoft.com/en-us/windows/wsl/install

Enter the status command to verify the WSL kernel is installed and the version is displayed:

wsl --status
----------------------------------------------------------
Default Version: 2

Kernel Version: 5.10.102.1

If the WSL Default Version is 1, download and install the update file from the following link: https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi

Edge App Installation​

Download the Installation Files​

for Cloud Edge Conductor​

Download Link: Edge App Installer

  • WSL Base Image: v3.0.0
  • Edge App : v3.3.0

for On-Premise Edge Conductor​

Download Link: Edge App Installer

  • WSL Base Image: v3.0.0
  • Edge App : v3.3.0

Execute edgeapp_installer.exe​

Extract the files and run edgeapp_installer.exe with administrator privileges.

After running, click "Next" and fill in the appropriate information as follows:

  • Edge Conductor Configuration

    1. Edge Conductor IP : Enter the IP address of the Edge Conductor you want to use.
    2. Edge Conductor PORT : Enter the port of the Edge Conductor you want to use.
    3. Http, Https settings : Select the protocol for communication with the Edge Conductor.

  • Edge App Configuration

    1. DataInputPath : Enter the path where the data to be inferred is generated. (DOS path, e.g., C:\TEST)
    2. DataOutputPath : Enter the path where the inference result compressed file will be saved. (If you enter None, it will not be saved locally.)

After filling in the information, click "Next" and fill in the appropriate information as follows:

  • AWS Configuration
    1. aws access key : Enter the access key of the AWS you want to use.
    2. aws secret key : Enter the secret key of the AWS you want to use.
    3. aws region : Enter the region of the AWS you want to use.

After filling in the information, click "Next" to proceed with the installation. Click "Finish" to close edgeapp_installer.exe, and wait until the PowerShell window that appears after installation closes. Once the window closes, check if the shortcuts for Edge Start, Edge Stop, and viewer have been created on the desktop.

Edge App Uninstall​

Run Windows PowerShell terminal as Administrator​

  • Input the following commands sequentially
    1. wsl --terminate wsl_image_3.0.0
    2. wsl --unregister wsl_image_3.0.0
    3. wsl -l -v

After executing the third command, wsl_image_3.0.0 should not be visible.

Delete the 'edge-viewer' shortcut on the desktop​

  • If you have added the 'edge-viewer' icon to the Windows start menu, delete it as well.

How to Use Edge App​

You can run EdgeApp by clicking Edge Start on the desktop. To check the inference results locally, you need to run the viewer on the desktop to open the Edge browser. To stop using it, run Edge Stop on the desktop to terminate the application.

Trouble Shooting​

When run 'Edge Start' on the desktop, but it doesn't run properly.

  • Disable vmcompute Control Flow Guard (CFG)
    1. Search for "Windows Security" in Windows settings and run it.
    2. Click on "App & browser control."
    3. Click on "Exploit protection settings."
    4. Click on "Program settings" and then click the + button to add a program to customize and select the exact file path.
    5. Select C:\Windows\System32\vmcompute.exe.
    6. In the list, find "Control flow guard (CFG)" and disable it, then click Apply.
    7. Reboot your PC.

The process does not continue after inputting the wsl commands in the PowerShell terminal for removing the Edge App.

  • Open Task Manager
    1. Check the PID of 'LxssManager' from the 'Services' tab in Task Manager.
    2. Run the PowerShell terminal as Administrator.
    3. Input the 'wmic process where ProcessID= delete' command. At this time, input the PID number you checked in step 1 right after ProcessID=.