본문으로 건너뛰기
버전: docs v25.02

For Windows 10

Updated 2024.12.17

WSL 활성화​

WSL 환경 설정​

WSL이 안정적으로 동작하기위해 Windows 설정에서 다음의 사항을 변경합니다.

  • WSL 관련 기능 활성화
    1. Windows 설정에서 "Windows 기능 켜기/끄기"를 검색하여 실행합니다.
    2. 'Hyper-V'를 활성화하고 확인 버튼을 클릭합니다.
    3. 'Linux용 Windows 하위 시스템'를 활성화하고 확인 버튼을 클릭합니다.
    4. '가상 머신 플랫폼'를 활성화하고 확인 버튼을 클릭합니다.
    5. PC 재부팅 합니다.

WSL 설치 및 동작 확인​

WSL (Linux용 Windows 하위 시스템)은 Windows에서 Linux 기능에 엑세스 할 수 있는 환경을 제공합니다.

WSL은 Windows 10 버전 2004 이상(빌드 19041 이상) 부터 지원합니다.

Power Shell을 관리자 권한으로 실행하고 다음의 명령어가 동작하는지 확인합니다.

wsl --install

명령어가 동작하지 않으면 다음의 링크를 참고하여 WSL을 설치하세요. https://learn.microsoft.com/ko-kr/windows/wsl/install

status 명령어를 입력하여 WSL Kernerl이 설치되어 버전이 표시 되는지 확인합니다.

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

Kernel Version: 5.10.102.1

WSL Default Version이 1인 경우 다음 링크에서 update 파일을 다운 받아서 설치합니다. https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi

Edge App 설치​

설치 파일 다운로드​

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​

파일을 추출하고 관리자 권한으로 edgeapp_installer.exe를 실행합니다.

실행 후 "다음"을 클릭하고 다음과 같은 적절한 정보를 입력합니다:

  • Edge Conductor 설정

    1. Edge Conductor IP : 사용하려는 Edge Conductor의 IP 주소를 입력합니다.
    2. Edge Conductor PORT : 사용하려는 Edge Conductor의 포트를 입력합니다.
    3. Http, Https settings : Edge Conductor와의 통신에 사용할 프로토콜을 선택합니다.

  • Edge App Configuration

    1. DataInputPath : 추론할 데이터가 생성되는 경로를 입력합니다. (DOS 경로, 예: C:\TEST)
    2. DataOutputPath : 추론 결과 압축 파일이 저장될 경로를 입력합니다. (None을 입력하면 로컬에 저장되지 않습니다.)
    3. Note : Edge Conductor에 Edge App 등록시 식별할 수 있는 값을 입력합니다.

정보를 입력한 후 "다음"을 클릭하고 다음과 같은 적절한 정보를 입력합니다:

  • AWS Configuration
    1. aws access key : 사용하려는 AWS access key를 입력합니다.
    2. aws secret key : 사용하려는 AWS secret key를 입력합니다.
    3. aws region : 사용하려는 AWS의 리전을 입력합니다.

정보를 입력한 후 "다음"을 클릭하여 설치를 진행합니다. "끝"을 클릭하여 edgeapp_installer.exe를 닫고, 설치 후 나타나는 PowerShell 창이 닫힐 때까지 기다립니다. 창이 닫힌 후 바탕화면에 Edge Start, Edge Stop, Viewer에 대한 바로 가기가 생성되었는지 확인합니다. (나오지 않으면 바탕화면에서 F5버튼을 눌러주세요.)

Edge App 삭제​

관리자 권한으로 윈도우 powershell 터미널 실행​

  • 아래 명령어를 순차적으로 입력합니다
    1. wsl --terminate wsl_image_3.0.0
    2. wsl --unregister wsl_image_3.0.0
    3. wsl -l -v

위 3번 명령어를 수행했을때 wsl_image_3.0.0가 보이지 않아야 됩니다.

바탕화면의 'edge-viewer' 바로가기 삭제​

  • 윈도우 시작메뉴에 'edge-viewer' 아이콘을 추가했다면 삭제합니다.

How to Use Edge App​

바탕화면에서 Edge Start를 클릭하여 EdgeApp을 실행할 수 있습니다. 로컬에서 추론 결과를 확인하려면 바탕화면에서 Viewer를 실행하여 Edge 브라우저를 열어야 합니다. 사용을 중지하려면 바탕화면에서 Edge Stop을 실행하여 애플리케이션을 종료하십시오.

Trouble Shooting​

바탕화면의 'Edge Start'를 실행하였으나 실행이 제대로 되지 않습니다.

  • vmcompute 흐름 제어 보호 비활성화
    1. Windows설정에서 "Windows 보안"을 검색하여 실행합니다.
    2. 앱 및 브라우저 컨트롤을 클릭합니다.
    3. Exploit Protection 설정을 클릭합니다.
    4. 프로그램 설정을 클릭하고 + 버튼을 클릭하여 프로그램을 추가해 사용자 지정으로 정확한 파일 경로 선택을 클릭합니다.
    5. C:\Windows\System32\vmcompute.exe를 선택합니다.
    6. 리스트에서 흐름 제어 보호 (CFG)를 찾아 비활성화하고 적용을 클릭합니다.
    7. PC 재부팅 합니다.

Edge App 삭제시 powershell 터미널에서 wsl 명령어 입력 후 진행되지 않습니다.

  • 작업관리자 열기
    1. 작업관라자의 '서비스' 탭에서 'LxssManager'의 PID를 확인합니다.
    2. powershell 터미널을 관리자 권한으로 실행합니다.
    3. 'wmic process where ProcessID= delete' 명령어를 입력합니다. 이 때 1번에서 확인한 PID 번호를 ProcessID= 뒤에 적어줍니다.