WSL ဖွဲ့စည်းမှု

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

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

1. WSL ဖွင့်ခြင်းနှင့် configure လုပ်ခြင်း

ဤအခန်းသည် လိုအပ်သော အခြေခံ setting များကို ပြီးမြောက်စေရန် လမ်းညွှန်ပေးပါမည်။ ဤအခန်းကို ပြီးမြောက်ပြီးနောက် အခန်း ၂ ကို ဖတ်ပြီး command ရနိုင်ခြင်းနှင့် install အောင်မြင်ခြင်း ကွာခြားချက်ကို နားလည်ပါ။ Install တွင် ပြဿနာရှိနေသေးပါက အခန်း ၃ ကို ကိုးကားပါ။

1.1 စနစ်လိုအပ်ချက်များ စစ်ဆေးခြင်း

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

• Windows 10: Version 1903 သို့မဟုတ် အထက်၊ Build သည် 18362 သို့မဟုတ် အထက် ဖြစ်ရပါမည်။
• Windows 11: Version အားလုံး ပံ့ပိုးသည်။

IMPORTANT

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

1.2 Hardware Virtualization ဖွင့်ခြင်း

WSL 2 သည် virtualization technology အပေါ် အခြေခံ၍ run သည်၊ ထို့ကြောင့် motherboard BIOS/UEFI တွင် virtualization technology ကို enable ပြုလုပ်ထားရပါမည်။

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

1.3 Windows ဆက်စပ်လုပ်ဆောင်ချက်များ ဖွင့်ခြင်း

Windows ၏ "Windows Subsystem for Linux" နှင့် "Virtual Machine Platform" လုပ်ဆောင်ချက်များကို ဖွင့်ရပါမည်။

နည်းလမ်း A: Graphical Interface မှတစ်ဆင့် (အကြံပြု)

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

နည်းလမ်း B: Command Line မှတစ်ဆင့် (Administrator အခွင့်အရေး)

PowerShell ကို administrator အဖြစ် run ပြီး အောက်ပါ command များကို လုပ်ဆောင်ပါ-

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

# Virtual machine platform ကို enable လုပ်ပါ
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

ပြီးပါက ကွန်ပျူတာကို လက်ဖြင့် ပြန်လည်စတင်ပါ။

1.4 WSL Kernel တပ်ဆင်ခြင်း/အဆင့်မြှင့်ခြင်း

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

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

1.5 WSL 2 ကို Default Version အဖြစ် သတ်မှတ်ခြင်း

အသစ် install လုပ်သော ဖြန့်ဝေမှုများသည် default အနေဖြင့် WSL 2 ကို အသုံးပြုစေရန် terminal တွင် အောက်ပါ command ကို လုပ်ဆောင်ပါ-

wsl --set-default-version 2

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

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

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

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

Command ရနိုင်ခြင်းသည် ဖော်ပြသည်မှာ-

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

သို့သော် Linux ဖြန့်ဝေမှုကို အောင်မြင်စွာ install လုပ်ရန် နောက်ထပ် အခြေအနေများ လိုအပ်သေးသည်။ မကြာခဏ တွဲကျတတ်သည့်နေရာများ-

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

TIP

ရိုးရိုးရှင်းရှင်းပြောရလျှင်: WSL command အသုံးပြုနိုင်ခြင်း ≠ Linux အသင့်ဖြစ်နေခြင်း။ "ဝင်ခွင့်လက်မှတ်" ကိုသာ ရထားပြီး စနစ်ကို တကယ် install မလုပ်ရသေးပါ။

3. Install မအောင်မြင်မှု စစ်ဆေးခြင်း

အခန်း ၁ အတိုင်း configuration ပြီးမြောက်ပြီး (သို့မဟုတ် သင်ကိုယ်တိုင် configuration ပြီးပြီဟု ထင်ပါက) wsl --install ကို run ပါက မအောင်မြင်သေးပါက အောက်ပါအတိုင်း အစီအစဉ်အတိုင်း စစ်ဆေးပါ။

3.1 ဦးစွာ "One-Click Check" ပြုလုပ်ပါ

PowerShell ကို administrator အဖြစ် run ပြီး အစဉ်လိုက် လုပ်ဆောင်ပါ-

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

• ✅ ဤ command နှစ်ခုလုံး ချောမွေ့စွာ run နိုင်ပါက WSL optional component များ enable ဖြစ်ပြီး virtualization အခြေအနေ အခြေခံအားဖြင့် ပြည့်စုံကြောင်း ဆိုလိုသည်။
• ❌ မအောင်မြင်ပါက ဘာများလိုနေသည်ကို တိုက်ရိုက် ဖော်ပြပါမည် (ဥပမာ virtual machine platform၊ Hyper-V၊ BIOS virtualization စသည်)။

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

NOTE

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

3.2 လက်ဖြင့် စစ်ဆေးမှု စာရင်း

"One-click check" ဖြင့် ပြဿနာကို ရှာမတွေ့သေးပါက တစ်ခုချင်း စစ်ဆေးနိုင်သည်-

1. BIOS/firmware virtualization ဖွင့်ထားခြင်း ရှိမရှိ စစ်ဆေးခြင်း: Administrator PowerShell တွင် systeminfo run ပါ။ Output တွင် Virtualization Enabled In Firmware: Yes မြင်ရပါမည်။
2. Windows feature ဖွင့်ထားခြင်း ရှိမရှိ စစ်ဆေးခြင်း-

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

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

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

အခြေအနေ	ရှင်းလင်းချက်	ဖြေရှင်းနည်း
BIOS တွင် virtualization မဖွင့်ထား	သေချာပေါက် မအောင်မြင်သည်	ပြန်လည်စတင်ပြီး BIOS ဝင်၍ VT-x / AMD-V ဖွင့်ပါ ( 1.2 ကြည့်ပါ )
Windows 10 သည် 19041 အောက်	wsl --install ကို မပံ့ပိုးပါ	စနစ်အဆင့်မြှင့်ပါ ( 1.1 ကြည့်ပါ )
Enterprise environment တွင် Hyper-V / virtualization ပိတ်ထား	မအောင်မြင်နိုင်ပါ	System administrator ကို ဆက်သွယ်ပါ
ဟောင်းသော Home version	လက်ဖြင့် 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 ဖြန့်ဝေမှုကိုယ်တိုင်၏ ပြဿနာမဟုတ်ဘဲ Windows ၏ VHD/VHDX virtual disk stack ပုံမှန် အလုပ်မလုပ်ခြင်း ဖြစ်ပြီး WSL 2 သည် ဖြန့်ဝေမှု register လုပ်ခြင်း၊ ext4.vhdx ဖန်တီး/mount လုပ်ခြင်းတွင် မအောင်မြင်ပါ။

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

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

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

2. WSL / Virtual Machine Platform feature မဖွင့်ထားခြင်း (သို့မဟုတ် အကျိုးမသက်ရောက်ခြင်း): 1.3 Windows ဆက်စပ်လုပ်ဆောင်ချက်များ ဖွင့်ခြင်း တွင် ဖော်ပြထားသော command များကို ပြန်လည်လုပ်ဆောင်ပြီး ပြန်လည်စတင်ရန် မဖြစ်မနေ လိုအပ်သည်။ Windows Home edition တွင် 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. Imported Image သည် WSL လိုအပ်ချက်နှင့် မကိုက်ညီခြင်း: wsl --import --vhd ကိုအသုံးပြုသည့်အခါ VHDX သည် ext4 file system ဖြစ်ရပါမည်။ LUKS encrypted disk၊ သာမန် raw.img၊ Live ISO သို့မဟုတ် NTFS/FAT ဖြင့် format လုပ်ထားသော ဗလာဒစ်ခ် မဖြစ်နိုင်ပါ။ .img / .qcow2 / .iso များကို တိုက်ရိုက် wsl --import --vhd မပြုလုပ်နိုင်ပါ။

5. Path/အခွင့်အရေး/File System ပြဿနာ: Target directory သည် NTFS disk ပေါ်တွင် ရှိရပါမည် (FAT32/exFAT မရပါ)။ Path တွင် Chinese characters၊ space နှင့် special symbols များကို ရှောင်ပါ။ Network drive၊ OneDrive၊ compressed folder မှ import မလုပ်ပါနှင့်။ တကယ့် administrator PowerShell (သာမန် terminal မဟုတ်ဘဲ) ကို သေချာစွာ အသုံးပြုပါ။

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

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

TIP

Third-party virtual machines (VirtualBox, VMware) သို့မဟုတ် security software ၏ sandbox/hardening feature များ (360၊ Huorong စသည်) သည် virtual disk operation ကို အနှောင့်အယှက်ဖြစ်စေနိုင်သည်။ စစ်ဆေးရာတွင် ယာယီပိတ်ထားပြီး ပြန်စမ်းကြည့်ပါ။