Windows 10/11 - WSL 2 업그레이드

 

---

WSL 사용법 – How To Start WSL

1

WSL 설치와 사용법

2

WSL 기본 명령 사용법

3

설치 디렉토리 경로 변경

4

WSL ssh 설치와 접속

5

Docker 설치하기

6

Ubuntu apt 오류 해결

7

iptables-legacy 전환 해결

8

Docker Desktop 설치

9

WSL 2 업그레이드

10

VHDX 디스크 마운트 방법

 

WSL은 windows 10에서는 기본 wsl v1 이고 windows 11에서는 WSL 2가 기본입니다.

그래서 .vhdx 이미지를 백업하거나 import 하는 일부 명령이 작동하지 않습니다. 

 

 WSL 1과 WSL 2의 차이점

• WSL 1: 리눅스 커널을 에뮬레이션하여 실행. 속도는 빠르지만 호환성에 제한이 있음.
• WSL 2: 실제 리눅스 커널을 포함하여 더 높은 호환성과 성능 제공. Docker 등 다양한 개발 환경에서 필수적.

 

 WSL 1 vs WSL 2  기술 비교

구분	WSL 1	WSL 2
운영체계	Windows 10	Windows 11이상
기본 구조	리눅스 시스템 호출(System Call)을 Windows NT 커널로 직접 변환	실제 리눅스 커널을 VM(Hyper-V 기반) 으로 실행
커널	리눅스 커널 없음 → Windows NT 커널이 리눅스 호출을 에뮬레이션	Microsoft가 제공하는 진짜 Linux 커널 포함
호환성	일부 시스템 호출 미지원 → Docker, FUSE 등 실행 불가	100% 리눅스 커널 호환 → Docker, FUSE, 최신 배포판 완벽 지원
성능	네이티브 Windows 호출 변환 → 일부 작업은 빠름, 하지만 리눅스 전용 기능 제한	VM 기반이지만 리눅스 네이티브 성능 제공, I/O, 시스템 호출 호환성 우수
파일시스템	Windows NTFS와 직접 연결 → Windows 파일 접근 속도 빠름	VHDX 기반 가상 디스크 사용 → Linux 내부 성능은 좋지만 Windows 파일 접근은 상대적으로 느림
네트워크	Windows와 동일한 네트워크 스택 공유	VM 기반 별도 네트워크 인터페이스 사용
리소스 관리	Windows 프로세스와 거의 동일하게 동작	VM으로 실행되므로 CPU/메모리 관리가 Hyper-V 방식
업데이트 방식	Windows 업데이트에 포함	Microsoft Store에서 WSL 자체 업데이트 가능 (독립적)

 

 

---

WSL 2  업데이트 

 

ㅁ Windows 업데이트 확인/ 환경 설정

• Windows 10: 버전 2004 이상 필요
• Windows 11: 기본적으로 WSL 2 지원

 

• 필수 구성 요소 설치 PowerShell을 관리자 권한으로 실행 후 아래 명령어 입력:
  powershell

  dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
  dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
  

   

   

---

ㅁ WSL update

WSL 커널 업데이트 패키지 설치 Microsoft 공식 사이트에서 WSL2 Linux 커널 업데이트 패키지를 다운로드 후 설치.

 

- WSL 자체를 최신 버전으로 업데이트합니다.
  최신 버전에는 새로운 기능(--vhd 옵션 등), 성능 개선, 버그 수정, 최신 Linux 커널 업데이트가 포함됩니다.

 * wsl --vhd 옵션이 작동하지 않는경우  wsl --update 명령으로 업그레이드를 하여야 합니다.

1) wsl --update
  *) 실행 후에는 Windows 재부팅이 필요할 수 있습니다.

2)  wsl --set-default-version 2

3)  wsl --set-version OracleLinux_9_5    2     : 이미지를 WSL2로 업데이트 합니다.

  

PS D:\VM_OS\WSL_export> wsl --update
업데이트 확인 중입니다.
Linux용 Windows 하위 시스템 최신 버전이 이미 설치되어 있습니다.


PS D:\VM_OS\WSL_export> wsl --version
WSL 버전: 2.6.3.0
커널 버전: 6.6.87.2-1
WSLg 버전: 1.0.71
MSRDC 버전: 1.2.6353
Direct3D 버전: 1.611.1-81528511
DXCore 버전: 10.0.26100.1-240331-1435.ge-release
Windows 버전: 10.0.19045.3448


PS D:\VM_OS\WSL_export> wsl --set-default-version 2
WSL 2와의 주요 차이점에 대한 자세한 내용은 https://aka.ms/wsl2를 참조하세요

작업을 완료했습니다.

 

wsl --update가 
변환이 실패하는 가장 흔한 이유는:
- VirtualMachinePlatform 기능 미설치
- BIOS에서 가상화(VT-x/AMD-V) 꺼짐
- Windows 버전이 낮음 (Win10 2004 미만)

 

3)  wsl --set-version OracleLinux_9_5 2
  *  재부팅후 다음을 실행 합니다.  아래와 같이 기존 이미지를 WSL 2로 업그레이드를 하였으므로 
      export를 하여 vhdx 파일로 백업과 복구가 가능할 것입니다.

# wsl --update 후에 재부팅을 합니다.

# 배포판을 업그레이드 합니다.

PS D:\VM_OS\WSL_export> wsl --list -v
  NAME               STATE           VERSION
* wsloracle95        Stopped         1
  OracleLinux_9_5    Stopped         1
  

PS D:\VM_OS\WSL_export> wsl --set-version OracleLinux_9_5 2
WSL 2와의 주요 차이점에 대한 자세한 내용은 https://aka.ms/wsl2를 참조하세요

변환이 진행 중입니다. 이 작업은 몇 분 정도 걸릴 수 있습니다.
작업을 완료했습니다.



PS D:\VM_OS\WSL_export> wsl --list -v
  NAME               STATE           VERSION
* wsloracle95        Stopped         1
  OracleLinux_9_5    Stopped         2
PS D:\VM_OS\WSL_export>

 

WSL export /import with vhdx

 

 wsl --export OracleLinux_9_5 oraclelinux95.vhdx   --vhd
 
 wsl --import  Oracle95 D:\VM_OS\WSL_Oracle95  oraclelinux95.vhdx   --vhd

 wsl --set-default  Oracle95      # 새로 설치한 이미지를 기본으로 설정

 wsl --unregister wsloracle95    # 기존 이미지 삭제

 

PS D:\VM_OS\WSL_export> wsl --export OracleLinux_9_5 oraclelinux95.vhdx   --vhd
내보내기가 진행 중입니다. 이 작업은 몇 분 정도 걸릴 수 있습니다. (384 MB)

작업을 완료했습니다.



PS D:\VM_OS\WSL_export> wsl --import  Oracle95 D:\VM_OS\WSL_Oracle95  oraclelinux95.vhdx   --vhd
작업을 완료했습니다.

 

 

 

 

---

Windows 10/11 WSL 2  비교

 

구분	Windows 10 (버전 2004 이상)	Windows 11
1. OS 요구사항	Windows 10 2004 이상 필요 (19041+)	Windows 11은 기본적으로 WSL 2 지원
2. 필수 기능 활성화	PowerShell(관리자)에서: dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart	동일하게 VirtualMachinePlatform + WSL 기능 활성화 필요
3. BIOS 설정	BIOS/UEFI에서 가상화(VT-x/AMD-V) 켜기	동일
4. WSL 업데이트	wsl --update (Microsoft Store 버전 설치 권장)	wsl --update (기본적으로 Store 버전 포함)
5. 기본 버전 설정	wsl --set-default-version 2	동일
6. 배포판 설치	Microsoft Store에서 Ubuntu, Debian 등 설치	동일
7. 배포판 변환	wsl --set-version <배포판이름> 2	동일
8. 확인	wsl -l -v → VERSION이 2로 표시되면 성공	동일

 

---

 

(문제해결) wsl 1 에서는  --vhd 옵션이 오류가 납니다.

PS D:\VM_OS\WSL_export> wsl --export OracleLinux_9_5 exp_oracle_95.vhdx   --vhd
내보내기가 진행 중입니다. 이 작업은 몇 분 정도 걸릴 수 있습니다. (0 MB)

이 작업은 WSL2에서만 지원됩니다.
오류 코드: Wsl/Service/WSL_E_WSL2_NEEDED

 

 

• DISM(Deployment Image Servicing and Management) 도구를 이용해 Windows 기능을 켜는 명령입니다.
• VirtualMachinePlatform 기능을 활성화합니다.
• 이 기능은 WSL 2가 동작할 수 있도록 Hyper-V 기반 가상화 플랫폼을 제공합니다.
• 즉, WSL 2가 리눅스 커널을 VM 형태로 실행할 수 있게 해주는 핵심 기능입니다.

 

 

• 첫 번째 명령: WSL 2용 가상화 플랫폼 활성화

 

PS D:\VM_OS\WSL_export> dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

배포 이미지 서비스 및 관리 도구
버전: 10.0.19041.844

이미지 버전: 10.0.19045.3448

기능을 사용하도록 설정하는 중
[==========================100.0%==========================]
작업을 완료했습니다.
PS D:\VM_OS\WSL_export>

 

• 두 번째 명령: WSL 자체 기능 활성화

 

• 같은 방식으로 Windows Subsystem for Linux(WSL) 기능을 켭니다.
• 이 기능은 Windows에서 리눅스 실행 환경을 제공하는 기본 구성 요소입니다.
• WSL 1과 WSL 2 모두 이 기능이 필요합니다.

 

PS D:\VM_OS\WSL_export> dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

배포 이미지 서비스 및 관리 도구
버전: 10.0.19041.844

이미지 버전: 10.0.19045.3448

기능을 사용하도록 설정하는 중
[==========================100.0%==========================]
작업을 완료했습니다.

 

 

/online → 현재 실행 중인 Windows 시스템에 적용
/enable-feature → 특정 Windows 기능을 켜기
/featurename:<기능명> → 켜려는 기능 이름 지정
/all → 해당 기능과 필요한 종속 기능까지 모두 켜기
/norestart → 즉시 재부팅하지 않고, 나중에 사용자가 직접 재부팅하도록 설정