WSL setup

WSL Dashboard ကို အသုံးမပြုမီ, Windows system တွင် WSL 2 ကို မှန်ကန်စွာဖွင့်ပြီး configure လုပ်ထားရပါမည်။ ဤစာရွက်စာတမ်းကို အောက်ပါ အဓိက အပိုင်း သုံးပိုင်း ခွဲထားသည်:

1. WSL ကိုဖွင့်ပြီး configure လုပ်ပါ: WSL 2 ၏ အခြေခံ install နှင့် configure လုပ်ခြင်းကို ပြီးမြောက်ပါ။
2. Command ရနိုင်ခြင်းသည် install အောင်မြင်ခြင်းမဟုတ်: wsl command အလုပ်လုပ်နိုင်ခြင်းသည် Linux ကို အောင်မြင်စွာ install လုပ်နိုင်သည်ဟု မဆိုလိုပါ။
3. Install မအောင်မြင်ပါက ဖြေရှင်းခြင်း: configure ပြီးမြောက်ပြီးနောက် install မအောင်မြင်ပါက စစ်ဆေး၍ ပြုပြင်သည့် နည်းလမ်းများ။

1. WSL ကိုဖွင့်ပြီး configure လုပ်ပါ

ဤအခန်းသည် လိုအပ်သော အခြေခံ setup ကို ပြီးမြောက်စေရန် သင့်အား လမ်းညွှန်ပေးပါလိမ့်မည်။ ဤအခန်းပြီးမြောက်ပြီးနောက်, command ရနိုင်ခြင်းနှင့် install အောင်မြင်ခြင်းကြား ခြားနားချက်ကို သိရှိရန် အခန်း 2 ကိုဖတ်ပါ; install လုပ်ရာတွင် ပြဿနာများရှိပါက အခန်း 3 ကိုကြည့်ပါ။

1.1 System လိုအပ်ချက်များကို စစ်ဆေးပါ

WSL 2 တွင် Windows version အတွက် အနည်းဆုံး လိုအပ်ချက်များရှိသည်။ Win + R နှိပ်ပါ, winver ရိုက်ထည့်ပြီး သင့် version ကို စစ်ဆေးပါ:

• Windows 10: version 1903 သို့မဟုတ်နောက်ပိုင်း, နှင့် Build 18362 သို့မဟုတ် ပိုမြင့်ရမည်။
• Windows 11: ဗားရှင်းအားလုံးကို ပံ့ပိုးထားသည်။

IMPORTANT

သင့် version အလွန်နိမ့်ပါက, "Windows Update" မှတစ်ဆင့် သင့် system ကို အရင်အဆင့်မြှင့်ပါ။

1.2 Hardware virtualization ကိုဖွင့်ပါ

WSL 2 သည် virtualization နည်းပညာပေါ်တွင် အခြေခံ၍ အလုပ်လုပ်သည်, ထို့ကြောင့် motherboard ၏ BIOS/UEFI တွင် Virtualization Technology ကို မဖြစ်မနေ ဖွင့်ထားရမည်။

• စစ်ဆေးနည်း: "Task Manager" ဖွင့်ပါ -> "Performance" tab -> "CPU".
• အခြေအနေကြည့်ပါ: အောက်ညာဘက်ရှိ "Virtualization" အခြေအနေသည် "Enabled" အဖြစ် ပြသရမည်။
• ဖွင့်နည်း: မဖွင့်ထားပါက, ကွန်ပျူတာကို restart လုပ်ပြီး BIOS/UEFI setup သို့ဝင်ကာ, Intel VT-x သို့မဟုတ် AMD-V ကဲ့သို့သော option ကိုရှာပြီး Enabled အဖြစ် သတ်မှတ်ပါ။

1.3 Windows features ကိုဖွင့်ပါ

သင်သည် Windows ၏ "Windows Subsystem for Linux" နှင့် "Virtual Machine Platform" features များကို ဖွင့်ရမည်။

နည်းလမ်း A: GUI မှတစ်ဆင့် (အကြံပြုထားသည်)

1. Win + S နှိပ်ပါ, "Windows features ဖွင့် သို့မဟုတ် ပိတ်" ကိုရှာပြီး ဖွင့်ပါ။
2. အောက်ပါ နှစ်ခုကို check လုပ်ပါ:
   • Windows Subsystem for Linux
   • Virtual Machine Platform
3. "OK" နှိပ်ပြီး prompt လာသောအခါ ကွန်ပျူတာကို restart လုပ်ပါ.

နည်းလမ်း B: Command line မှတစ်ဆင့် (admin)

PowerShell ကို admin အဖြစ် run ပြီး အောက်ပါ command များကို execute လုပ်ပါ:

# WSL ကိုဖွင့်ပါ
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

# Virtual Machine Platform ကိုဖွင့်ပါ
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

Execute ပြီးပါက, ကွန်ပျူတာကို ကိုယ်တိုင် restart လုပ်ပါ.

1.4 WSL kernel ကို install / update လုပ်ပါ

ခေတ်မီ Windows version များသည် Microsoft Store မှတစ်ဆင့် WSL update များကို ရယူနိုင်သည်။

• Download လိပ်စာ: Microsoft Store - Windows Subsystem for Linux
• ကိုယ်တိုင် download: Store ကို အသုံးမပြုနိုင်ပါက, WSL GitHub Releases မှ အသစ်ဆုံး .msixbundle သို့မဟုတ် .msi install package များကို download လုပ်ပြီး offline install လုပ်နိုင်သည်။

1.5 WSL 2 ကို default version အဖြစ်သတ်မှတ်ပါ

အသစ် install လုပ်သော distribution များသည် default အားဖြင့် WSL 2 ကို အသုံးပြုကြောင်း သေချာစေရန်, terminal တွင် execute လုပ်ပါ:

wsl --set-default-version 2

1.6 အမေးများသောမေးခွန်းများ

• Error 0x80370102: အများအားဖြင့် BIOS တွင် virtualization မဖွင့်ထားခြင်း သို့မဟုတ် Hyper-V နှင့် ပဋိပက္ခဖြစ်ခြင်းကြောင့် ဖြစ်ပွားသည်။
• WSL 1 နှင့် WSL 2 ပြောင်းခြင်း: ရှိပြီးသား WSL 1 instance ကို WSL 2 သို့ အဆင့်မြှင့်ရန် wsl --set-version <分发版名称> 2 ကို အသုံးပြုနိုင်သည်။

2. Command ရနိုင်ခြင်းသည် install အောင်မြင်ခြင်းမဟုတ်

wsl --version, wsl -l -v စသည့် command များ ကောင်းမွန်စွာ အလုပ်လုပ်နိုင်ခြင်းသည် Linux install လုပ်ရန် အသင့်ဖြစ်နေပြီဟု မဆိုလိုပါ။ ၎င်းတို့နှစ်ခုသည် မတူညီသော အဆင့်များဖြစ်သည်; ၎င်းတို့ကို တူညီသည်ဟု မသတ်မှတ်နိုင်ပါ။

Command ရနိုင်ခြင်းသည် ဤအချက်များကိုသာ ဖော်ပြသည်:

• ✅ Windows တွင် WSL components များကို ဖွင့် / install လုပ်ထားပြီးဖြစ်သည်
• ✅ wsl.exe command line tool ရနိုင်သည်
• ✅ System သည် WSL ဆိုင်ရာ command များကို မှတ်မိနိုင်သည်

သို့သော် Linux distribution ကို အောင်မြင်စွာ install လုပ်ရန် နောက်ထပ် အခြေအနေများ လိုအပ်သည်။ အများအားဖြင့် ပြဿနာဖြစ်စေသော နေရာများ:

1. Virtualization ပိတ်ထားသည်: BIOS/UEFI တွင် VT-x / AMD-V မဖွင့်ထားပါက, WSL 2 စတင်နိုင်မည်မဟုတ်, သို့မဟုတ် distribution install လုပ်သောအခါ virtualization error ကို အစီရင်ခံပါလိမ့်မည် (စစ်ဆေးနည်းအတွက် 1.2 Hardware virtualization ကိုဖွင့်ပါ ကိုကြည့်ပါ)။
2. Windows version/build အလွန်နိမ့်သည်: WSL 2 တွင် kernel နှင့် version အတွက် လိုအပ်ချက်များရှိသည်; Home version, အလွန်နိမ့်သော enterprise image များတွင် features များ မပြည့်စုံနိုင်ပါ (စစ်ဆေးနည်းအတွက် 1.1 System လိုအပ်ချက်များကို စစ်ဆေးပါ ကိုကြည့်ပါ)။
3. Linux distribution ကို အမှန်တကယ် install မလုပ်ရသေးပါ: wsl -l -v သည် install လုပ်ထားသော distribution များကိုသာ စာရင်းပြပါသည်; ဘာမှ install မလုပ်ထားပါက စာရင်းအလွတ်ဖြစ်နေမည်, Ubuntu ကို တိုက်ရိုက် run နိုင်သည်ဟု မဆိုလိုပါ။
4. Network / Microsoft Store ပြဿနာများ: wsl --install -d <发行版> သည် Store သို့မဟုတ် network မှ image ကို ရယူရန် လိုအပ်သည်; ကုမ္ပဏီ network, proxy, firewall အားလုံး ပိတ်ဆို့နိုင်သည်။
5. ခွင့်ပြုချက် မလုံလောက်ပါ: distribution install လုပ်ရန် သို့မဟုတ် WSL settings ပြောင်းရန် admin ခွင့်ပြုချက် လိုအပ်သည်။

TIP

ရိုးရိုးရှင်းရှင်း ဆိုရလျှင်: WSL command အလုပ်လုပ်ခြင်းသည် Linux အသင့်ဖြစ်ပြီဟု မဆိုလိုပါ; ၎င်းသည် "ဝင်ခွင့်လက်မှတ်" ရရှိခြင်းသာဖြစ်ပြီး, အမှန်တကယ် system ကို install မလုပ်ရသေးပါ။

3. Install မအောင်မြင်ပါက ဖြေရှင်းခြင်း

အခန်း 1 အရ configure ပြီးမြောက်ပြီးနောက် (သို့မဟုတ် သင်ပြီးမြောက်ပြီဟု ထင်နေပါက), wsl --install execute လုပ်သော်လည်း မအောင်မြင်ပါက, အောက်ပါ အစီအစဉ်အတိုင်း စစ်ဆေးပါ။

3.1 ဦးစွာ တစ်ချက်နှိပ်စစ်ဆေးခြင်း လုပ်ပါ

PowerShell ကို admin အဖြစ် run ပြီး, အစဉ်လိုက် execute လုပ်ပါ:

wsl --install --no-distribution
wsl --set-default-version 2

• ✅ ဤ command နှစ်ခုလုံး ကောင်းမွန်စွာ အလုပ်လုပ်ပါက, WSL optional components များ ဖွင့်ထားပြီး, virtualization အခြေအနေများ အကြမ်းဖျင်း ပြည့်စုံပြီဟု ဆိုလိုသည်။
• ❌ မအောင်မြင်ပါက, ဘာလိုအပ်နေသည်ကို တိုက်ရိုက် ပြပါလိမ့်မည် (ဥပမာ Virtual Machine Platform, Hyper-V, BIOS virtualization စသည်)။

ထို့နောက် systeminfo ကို execute လုပ်ပြီး, output တွင် Virtualization Enabled In Firmware: Yes ပေါ်လာကြောင်း သေချာပါစေ။ အထက်ပါ အားလုံး error မရှိပါက, wsl --install ဖြင့် distribution install လုပ်ရန် စိတ်ချနိုင်သည်။

NOTE

wsl --install အောင်မြင်မည်ဟု 100% အာမခံနိုင်သော command မရှိပါ, သို့သော် အထက်ပါ စစ်ဆေးမှုသည် install အခြေအနေများ ပြည့်စုံခြင်း ရှိမရှိကို သေချာစေနိုင်သည်။

3.2 ကိုယ်တိုင် စစ်ဆေးရန် စာရင်း

"တစ်ချက်နှိပ်စစ်ဆေးခြင်း" ဖြင့် ပြဿနာကို ရှာမတွေ့ပါက, တစ်ခုချင်းစီ စစ်ဆေးပါ:

1. BIOS/firmware virtualization ဖွင့်ထားခြင်း ရှိမရှိ စစ်ဆေးပါ: admin PowerShell တွင် systeminfo execute လုပ်ပါ, output တွင် မဖြစ်မနေ Virtualization Enabled In Firmware: Yes ကို တွေ့ရမည်။
2. Windows features များ ဖွင့်ထားခြင်း ရှိမရှိ စစ်ဆေးပါ:

   Get-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux
   Get-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform

   Command နှစ်ခုလုံး၏ အခြေအနေသည် Enabled ဖြစ်ရမည်။
3. WSL ရနိုင်ခြင်း ရှိမရှိ စစ်ဆေးပါ: wsl --version execute လုပ်သောအခါ ပုံမှန် output ထွက်ရမည်; command မတွေ့ပါက, WSL components များ install မလုပ်ရသေးဟု ဆိုလိုသည်, အခန်း 1 သို့ ပြန်သွားပါ။
4. WSL 2 (kernel & Virtual Machine Platform) အသုံးပြုနိုင်ခြင်း ရှိမရှိ စစ်ဆေးပါ: wsl --set-default-version 2 သည် အောင်မြင်စွာ ပြန်တက်ရမည်။ အဖြစ်များသော မအောင်မြင်ရသည့် အကြောင်းရင်းများ: Virtual Machine Platform မဖွင့်ထားခြင်း, သို့မဟုတ် BIOS တွင် VT-x / AMD-V မဖွင့်ထားခြင်း။

3.3 အဖြစ်များသော မအောင်မြင်ရသည့် အကြောင်းရင်းများ အမြန်ဇယား

အခြေအနေ	ရှင်းလင်းချက်	ဖြေရှင်းနည်း
BIOS virtualization ပိတ်ထားသည်	မဖြစ်မနေ မအောင်မြင်ပါ	Restart လုပ်ပြီး BIOS တွင် VT-x / AMD-V ဖွင့်ပါ (1.2 ကိုကြည့်ပါ)
Windows 10 19041 အောက်	wsl --install ကို မပံ့ပိုးပါ	System အဆင့်မြှင့်ပါ (1.1 ကိုကြည့်ပါ)
Enterprise environment က Hyper-V / virtualization ပိတ်ထားသည်	မအောင်မြင်နိုင်ပါ	System admin ကို ဆက်သွယ်ပါ
ဟောင်းနေသော Home version system	ကိုယ်တိုင် install လုပ်ရန် လိုအပ်သည်	1.4 အရ WSL kernel ကို ကိုယ်တိုင် install လုပ်ပါ

3.4 Error 0xc03a0014: Virtual disk support provider ကို ရှာမတွေ့ပါ

Error message မှာ Cannot find a virtual disk support provider for the specified file ဖြစ်သည်။ ၎င်းသည် Linux distribution ၏ ပြဿနာမဟုတ်ပါ, ယင်းအစား Windows ၏ VHD/VHDX virtual disk stack သည် ကောင်းမွန်စွာ အလုပ်မလုပ်ခြင်း ဖြစ်သည်; distribution ကို register လုပ်သောအခါ, ext4.vhdx ကို create/mount လုပ်ရာတွင် WSL 2 မအောင်မြင်ပါ။

ဦးစွာ အနည်းဆုံး verification လုပ်ပါ: PowerShell ကို admin အဖြစ် run ပြီး, New-VHD test ကို execute လုပ်ပါ (ဥပမာ New-VHD -Path C:\test.vhdx -SizeBytes 1GB)။ ဤ command သည်လည်း အလားတူ error ကို အစီရင်ခံပါက, ပြဿနာသည် 100% Windows ဘက်တွင်ရှိပြီး, distribution နှင့် မသက်ဆိုင်ပါ။

အောက်ပါ အစီအစဉ်အတိုင်း စစ်ဆေး၍ ပြုပြင်ပါ:

1. Virtual Disk service မလည်ပတ်ပါ: services.msc ဖွင့်ပြီး, Virtual Disk service ကိုရှာကာ, startup type ကို "Automatic" အဖြစ် သတ်မှတ်ပြီး ၎င်းကို start လုပ်ပါ။

2. WSL / Virtual Machine Platform features များ မဖွင့်ထားပါ (သို့မဟုတ် အကျိုးမသက်ရောက်ပါ): 1.3 Windows features ကိုဖွင့်ပါ ရှိ command များကို ပြန် execute လုပ်ပြီး, ထို့နောက် မဖြစ်မနေ restart လုပ်ရမည်။ Windows Home version တွင် အပြည့်အစုံ Hyper-V မရှိပါ, သို့သော် WSL 2 သည် Virtual Machine Platform သာလိုအပ်သည်, Hyper-V management interface မဟုတ်ပါ။

3. Virtual disk driver/device မရှိပါ: Device Manager ဖွင့်ပြီး, "System devices / Storage controllers" တွင် အောက်ပါတို့ ရှိမရှိ စစ်ဆေးပါ:

   • Microsoft Virtual Disk Provider
   • Microsoft Virtual Drive Enumerator
   • Microsoft VHD Loopback Controller

   မရှိပါက hdwwiz.exe မှတစ်ဆင့် ကိုယ်တိုင် ထည့်နိုင်သည် (Storage controllers → Microsoft → Microsoft VHD Loopback Controller), နှင့် FsDepends service ကို disable မလုပ်ထားကြောင်း သေချာပါစေ။

4. Import လုပ်ထားသော image သည် WSL လိုအပ်ချက်များနှင့် မကိုက်ညီပါ: wsl --import --vhd အသုံးပြုသောအခါ, VHDX သည် မဖြစ်မနေ ext4 file system ဖြစ်ရမည်; LUKS encrypted disk, သာမန် raw.img, Live ISO သို့မဟုတ် NTFS/FAT format လုပ်ထားသော အလွတ် disk မဖြစ်ရပါ။ .img / .qcow2 / .iso ကို wsl --import --vhd ဖြင့် တိုက်ရိုက် import လုပ်၍မရပါ။

5. Path/ခွင့်ပြုချက်/file system ပြဿနာများ: Target directory သည် မဖြစ်မနေ NTFS disk ပေါ်တွင် ရှိရမည် (FAT32/exFAT အလုပ်မလုပ်ပါ); path တွင် တရုတ်စာလုံးများ, space နှင့် အထူးသင်္ကေတများ ရှောင်ပါ; network drive, OneDrive, compressed folder မှ import မလုပ်ပါနှင့်; မဖြစ်မနေ တကယ့် admin PowerShell ကို အသုံးပြုပါ (သာမန် terminal မဟုတ်ပါ)။

6. System components များ ပျက်စီးနေသည်: DISM နှင့် SFC ကို အစဉ်လိုက် run ပြီး system components များကို ပြုပြင်ပြီးနောက် ပြန်ကြိုးစားပါ:

   DISM.exe /Online /Cleanup-Image /RestoreHealth
   sfc /scannow

TIP

Third-party virtual machines (VirtualBox, VMware) သို့မဟုတ် security software ၏ sandbox/hardening features များ (ဥပမာ 360, Huorong) သည် virtual disk လုပ်ဆောင်ချက်များကို အနှောင့်အယှက်ဖြစ်စေနိုင်သည်; ဖြေရှင်းသောအခါ ၎င်းတို့ကို ခဏပိတ်ပြီး စမ်းကြည့်ပါ။