WSL কনফিগার করুন

WSL Dashboard ব্যবহারের আগে, আপনার Windows সিস্টেমে WSL 2 পরিবেশ সঠিকভাবে সক্রিয় ও কনফিগার করা আবশ্যক। এই ডকুমেন্টটি নিম্নলিখিত তিনটি মূল অংশে বিভক্ত:

1. WSL সক্রিয় ও কনফিগার করুন：WSL 2-এর মৌলিক ইনস্টলেশন ও কনফিগারেশন সম্পন্ন করুন।
2. কমান্ড চলে মানে ইনস্টল সফল নয়：ব্যাখ্যা করে যে wsl কমান্ড চালানো মানে Linux সফলভাবে ইনস্টল করা যাবে এমন নয়।
3. ইনস্টল ব্যর্থতার সমস্যা সমাধান：কনফিগারেশন শেষে ইনস্টল ব্যর্থ হলে পরীক্ষা ও মেরামতের পদ্ধতি।

1. WSL সক্রিয় ও কনফিগার করুন

এই অধ্যায় আপনাকে প্রয়োজনীয় মৌলিক সেটআপ সম্পন্ন করতে গাইড করবে। এই অধ্যায় শেষে, কমান্ড উপলব্ধতা ও ইনস্টল সফলতার মধ্যে পার্থক্য জানতে অধ্যায় 2 পড়ুন; ইনস্টলে এখনও সমস্যা থাকলে অধ্যায় 3 দেখুন।

1.1 সিস্টেম প্রয়োজনীয়তা পরীক্ষা

WSL 2-এর জন্য Windows সংস্করণে ন্যূনতম প্রয়োজনীয়তা রয়েছে। Win + R চাপুন, আপনার সংস্করণ পরীক্ষা করতে winver লিখুন:

• Windows 10: সংস্করণ 1903 বা উচ্চতর, এবং Build 18362 বা উচ্চতর হতে হবে।
• Windows 11: সব সংস্করণ সমর্থিত।

IMPORTANT

যদি আপনার সংস্করণ খুব পুরনো হয়, তবে আগে "Windows আপডেট"-এর মাধ্যমে সিস্টেম আপগ্রেড করুন।

1.2 হার্ডওয়্যার ভার্চুয়ালাইজেশন সক্রিয় করুন

WSL 2 ভার্চুয়ালাইজেশন প্রযুক্তির উপর চলে, তাই মাদারবোর্ড BIOS/UEFI-তে ভার্চুয়ালাইজেশন টেকনোলজি (Virtualization Technology) সক্রিয় থাকতে হবে।

• পরীক্ষা পদ্ধতি: "টাস্ক ম্যানেজার" → "পারফরম্যান্স" ট্যাব → "CPU" খুলুন।
• স্থিতি দেখুন: নিচে ডানদিকে "ভার্চুয়ালাইজেশন" স্থিতি "সক্ষম" থাকতে হবে।
• সক্রিয় করার পদ্ধতি: সক্রিয় না থাকলে, আপনাকে কম্পিউটার পুনরায় চালু করে BIOS/UEFI সেটিংসে যেতে হবে, Intel VT-x বা AMD-V-এর মতো অপশন খুঁজে Enabled-এ সেট করুন।

1.3 Windows সম্পর্কিত ফিচার সক্রিয় করুন

আপনাকে Windows-এর "Linux-এর জন্য Windows সাবসিস্টেম" ও "ভার্চুয়াল মেশিন প্ল্যাটফর্ম" ফিচার সক্রিয় করতে হবে।

পদ্ধতি A: গ্রাফিকাল ইন্টারফেসের মাধ্যমে (সুপারিশকৃত)

1. Win + S চাপুন, "Windows ফিচার চালু বা বন্ধ করুন" খুঁজে খুলুন।
2. নিম্নলিখিত দুটি অপশন টিক দিন:
   • Linux-এর জন্য Windows সাবসিস্টেম (Windows Subsystem for Linux)
   • ভার্চুয়াল মেশিন প্ল্যাটফর্ম (Virtual Machine Platform)
3. "ঠিক আছে" ক্লিক করুন, এবং অনুরোধ করা হলে কম্পিউটার পুনরায় চালু করুন।

পদ্ধতি B: কমান্ড লাইনের মাধ্যমে (অ্যাডমিন অনুমতি)

PowerShell অ্যাডমিনিস্ট্রেটর হিসেবে চালান এবং নিম্নলিখিত কমান্ডগুলো চালান:

# WSL সক্রিয় করুন
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

# ভার্চুয়াল মেশিন প্ল্যাটফর্ম সক্রিয় করুন
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

সম্পন্ন হলে, দয়া করে ম্যানুয়ালি কম্পিউটার পুনরায় চালু করুন।

1.4 WSL কার্নেল ইনস্টল/আপডেট করুন

আধুনিক Windows সংস্করণ Microsoft Store-এর মাধ্যমে WSL আপডেট পেতে পারে।

• ডাউনলোড ঠিকানা: Microsoft Store - Windows Subsystem for Linux
• ম্যানুয়াল ডাউনলোড: স্টোর ব্যবহার করা না গেলে, WSL GitHub Releases থেকে সর্বশেষ .msixbundle বা .msi ইনস্টলেশন প্যাকেজ ডাউনলোড করে অফলাইন ইনস্টল করুন।

1.5 WSL 2-কে ডিফল্ট সংস্করণ হিসেবে সেট করুন

নতুন ইনস্টল হওয়া ডিস্ট্রো যাতে ডিফল্টভাবে WSL 2 ব্যবহার করে তা নিশ্চিত করতে, টার্মিনালে চালান:

wsl --set-default-version 2

1.6 সাধারণ প্রশ্ন

• ত্রুটি 0x80370102: সাধারণত BIOS-এ ভার্চুয়ালাইজেশন সক্রিয় না থাকা, বা Hyper-V বিরোধের কারণে হয়।
• WSL 1 ও WSL 2-এর মধ্যে স্যুইচ: আপনি wsl --set-version <ডিস্ট্রো নাম> 2 দিয়ে বিদ্যমান WSL 1 ইনস্ট্যান্সকে WSL 2-তে আপগ্রেড করতে পারেন।

2. কমান্ড চলে মানে ইনস্টল সফল নয়

wsl --version, wsl -l -v ইত্যাদি কমান্ড স্বাভাবিকভাবে চালানো এই অর্থ বহন করে না যে Linux ইনস্টল করার শর্ত প্রস্তুত। দুটি ভিন্ন পর্যায়, এদের সমান ধরা যায় না।

কমান্ড চলে, শুধু এটা বোঝায়:

• ✅ Windows-এ WSL কম্পোনেন্ট সক্রিয়/ইনস্টল হয়ে আছে
• ✅ wsl.exe কমান্ড-লাইন টুল ব্যবহারযোগ্য
• ✅ সিস্টেম WSL সম্পর্কিত কমান্ড চিনতে পারে

কিন্তু Linux ডিস্ট্রো সফলভাবে ইনস্টল করতে অতিরিক্ত শর্ত পূরণ করতে হবে। সাধারণ যেসব জায়গায় আটকে যায়:

1. ভার্চুয়ালাইজেশন বন্ধ: BIOS/UEFI-তে VT-x / AMD-V সক্রিয় নেই, WSL 2 শুরু হতে পারে না, বা ডিস্ট্রো ইনস্টলে ভার্চুয়ালাইজেশন ত্রুটি দেখায় (পরীক্ষা পদ্ধতি 1.2 হার্ডওয়্যার ভার্চুয়ালাইজেশন সক্রিয় করুন দেখুন)।
2. Windows সংস্করণ/Build খুব পুরনো: WSL 2-এর কার্নেল ও সংস্করণের প্রয়োজনীয়তা আছে, হোম সংস্করণ, পুরনো এন্টারপ্রাইজ ইমেজে ফিচার কম থাকতে পারে (পরীক্ষা পদ্ধতি 1.1 সিস্টেম প্রয়োজনীয়তা পরীক্ষা দেখুন)।
3. Linux ডিস্ট্রো আসলে ইনস্টল হয়নি: wsl -l -v শুধু ইনস্টল করা ডিস্ট্রো তালিকাভুক্ত করে, কিছু ইনস্টল না থাকলে তালিকা খালি থাকে, এর মানে সরাসরি Ubuntu চালানো যাবে এমন নয়।
4. নেটওয়ার্ক / Microsoft Store সমস্যা: wsl --install -d <ডিস্ট্রো>-কে স্টোর বা নেটওয়ার্ক থেকে ইমেজ আনতে হয়, কোম্পানির নেটওয়ার্ক, প্রক্সি, ফায়ারওয়াল সব বাধা দিতে পারে।
5. অপর্যাপ্ত অনুমতি: ডিস্ট্রো ইনস্টল বা WSL সেটিংস পরিবর্তনে অ্যাডমিন অনুমতি প্রয়োজন।

TIP

সহজ কথায়: WSL কমান্ড চলে ≠ Linux প্রস্তুত, শুধু "প্রবেশ টিকিট" পেয়েছেন, আসলে সিস্টেম ইনস্টল হয়নি।

3. ইনস্টল ব্যর্থতার সমস্যা সমাধান

অধ্যায় 1 অনুযায়ী কনফিগারেশন সম্পন্ন করার (বা আপনি মনে করেন সম্পন্ন হয়েছে) পরও যদি wsl --install ব্যর্থ হয়, তবে নিম্নলিখিত ক্রমে পরীক্ষা করুন।

3.1 আগে "এক-ক্লিক চেক" করুন

PowerShell অ্যাডমিনিস্ট্রেটর হিসেবে চালান, ক্রমানুসারে চালান:

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

• ✅ যদি দুটি কমান্ডই সফলভাবে চলে, তাহলে WSL ঐচ্ছিক কম্পোনেন্ট সক্রিয়, ভার্চুয়ালাইজেশন শর্ত প্রায় পূরণ হয়েছে।
• ❌ ব্যর্থ হলে, সরাসরি কী নেই তা জানায় (যেমন ভার্চুয়াল মেশিন প্ল্যাটফর্ম, Hyper-V, BIOS ভার্চুয়ালাইজেশন ইত্যাদি)।

তারপর systeminfo চালান, আউটপুটে Virtualization Enabled In Firmware: Yes দেখার বিষয় নিশ্চিত করুন। উপরের সবগুলোতে কোনো ত্রুটি না থাকলে, wsl --install চালিয়ে ডিস্ট্রো ইনস্টল করা নিরাপদ।

NOTE

কোনো কমান্ডই 100% নিশ্চিত করতে পারে না যে wsl --install সফল হবে, তবে উপরের পরীক্ষা ইনস্টল শর্ত পূরণ হয়েছে কি না নিশ্চিত করতে পারে।

3.2 ম্যানুয়াল পরীক্ষার তালিকা

যদি "এক-ক্লিক চেক" সমস্যা শনাক্ত না করতে পারে, তবে একে একে পরীক্ষা করুন:

1. BIOS/ফার্মওয়্যার ভার্চুয়ালাইজেশন সক্রিয় কি না পরীক্ষা: অ্যাডমিন PowerShell-এ systeminfo চালান, আউটপুটে Virtualization Enabled In Firmware: Yes থাকতে হবে।
2. Windows ফিচার সক্রিয় কি না পরীক্ষা:

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

   দুটি কমান্ডের স্থিতিই Enabled হওয়া উচিত।
3. WSL ব্যবহারযোগ্য কি না পরীক্ষা: wsl --version চালান, স্বাভাবিক আউটপুট আসা উচিত; কমান্ড পাওয়া যায় না বললে, WSL কম্পোনেন্ট ইনস্টল নেই, অধ্যায় 1-এ ফিরে যান।
4. WSL 2 ব্যবহারযোগ্য কি না পরীক্ষা (কার্নেল ও ভার্চুয়াল মেশিন প্ল্যাটফর্ম): wsl --set-default-version 2 চালালে সফল হওয়া উচিত। সাধারণ ব্যর্থতার কারণ: ভার্চুয়াল মেশিন প্ল্যাটফর্ম সক্রিয় নেই, বা BIOS-এ VT-x / AMD-V সক্রিয় নেই।

3.3 সাধারণ ব্যর্থতার কারণ দ্রুত তালিকা

অবস্থা	বিবরণ	সমাধান
BIOS-এ ভার্চুয়ালাইজেশন সক্রিয় নেই	অবশ্যই ব্যর্থ	পুনরায় চালু করে BIOS-এ VT-x / AMD-V সক্রিয় করুন (দেখুন 1.2)
Windows 10 19041-এর নিচে	wsl --install সমর্থিত নয়	সিস্টেম আপগ্রেড করুন (দেখুন 1.1)
এন্টারপ্রাইজ পরিবেশে Hyper-V / ভার্চুয়ালাইজেশন নিষ্ক্রিয়	সম্ভবত ব্যর্থ	সিস্টেম অ্যাডমিনের সাথে যোগাযোগ করুন
পুরনো হোম সংস্করণ সিস্টেম	ম্যানুয়াল ইনস্টল প্রয়োজন	1.4 অনুযায়ী WSL কার্নেল ম্যানুয়ালি ইনস্টল করুন

3.4 ত্রুটি 0xc03a0014: ভার্চুয়াল ডিস্ক সাপোর্ট প্রোভাইডার পাওয়া যায়নি

ত্রুটি বার্তা Cannot find a virtual disk support provider for the specified file। এটি Linux ডিস্ট্রোর সমস্যা নয়, বরং Windows-এর VHD/VHDX ভার্চুয়াল ডিস্ক স্ট্যাক সঠিকভাবে কাজ করছে না, WSL 2 ডিস্ট্রো রেজিস্ট্রেশন, ext4.vhdx তৈরি/মাউন্ট করতে ব্যর্থ হয়।

আগে ন্যূনতম ভেরিফিকেশন করুন: PowerShell অ্যাডমিনিস্ট্রেটর হিসেবে চালান, New-VHD পরীক্ষা চালান (যেমন New-VHD -Path C:\test.vhdx -SizeBytes 1GB)। এই কমান্ডও একই ত্রুটি দেখালে, সমস্যা 100% Windows পক্ষে, ডিস্ট্রোর সাথে সম্পর্কহীন।

নিম্নলিখিত ক্রমে সমস্যা সমাধান করুন:

1. Virtual Disk সার্ভিস চলছে না: services.msc খুলুন, Virtual Disk সার্ভিস খুঁজুন, স্টার্ট টাইপ "স্বয়ংক্রিয়" সেট করে চালু করুন।

2. WSL / ভার্চুয়াল মেশিন প্ল্যাটফর্ম ফিচার সক্রিয় নেই (বা কার্যকর হয়নি): 1.3 Windows সম্পর্কিত ফিচার সক্রিয় করুন-এর কমান্ডগুলো পুনরায় চালান, তারপর অবশ্যই পুনরায় চালু করুন। Windows হোম সংস্করণে সম্পূর্ণ Hyper-V নেই, কিন্তু WSL 2-তে শুধু ভার্চুয়াল মেশিন প্ল্যাটফর্ম লাগে, Hyper-V ম্যানেজমেন্ট ইন্টারফেস নয়।

3. ভার্চুয়াল ডিস্ক ড্রাইভার/ডিভাইস অনুপস্থিত: ডিভাইস ম্যানেজার খুলুন, "সিস্টেম ডিভাইস / স্টোরেজ কন্ট্রোলার"-এ নিম্নলিখিতগুলো আছে কি না দেখুন:

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

   অনুপস্থিত থাকলে hdwwiz.exe দিয়ে ম্যানুয়ালি যোগ করুন (স্টোরেজ কন্ট্রোলার → Microsoft → Microsoft VHD লুপব্যাক কন্ট্রোলার), এবং FsDepends সার্ভিস নিষ্ক্রিয় না তা নিশ্চিত করুন।

4. আমদানিকৃত ইমেজ WSL প্রয়োজনীয়তা পূরণ করে না: wsl --import --vhd ব্যবহার করলে, VHDX-কে ext4 ফাইল সিস্টেম হতে হবে, LUKS এনক্রিপ্টেড ডিস্ক, সাধারণ raw.img, Live ISO বা NTFS/FAT ফরম্যাটের খালি ডিস্ক হতে পারবে না। .img / .qcow2 / .iso সরাসরি wsl --import --vhd করা যায় না।

5. পাথ/অনুমতি/ফাইল সিস্টেম সমস্যা: লক্ষ্য ডিরেক্টরি NTFS ডিস্কে থাকতে হবে (FAT32/exFAT চলবে না); পাথে চীনা অক্ষর, স্পেস ও বিশেষ চিহ্ন এড়িয়ে চলুন; নেটওয়ার্ক ড্রাইভ, OneDrive, কমপ্রেসড ফোল্ডার থেকে আমদানি করবেন না; অবশ্যই আসল অ্যাডমিন PowerShell (সাধারণ টার্মিনাল নয়) ব্যবহার করুন।

6. সিস্টেম কম্পোনেন্ট ক্ষতিগ্রস্ত: ক্রমানুসারে DISM ও SFC চালিয়ে সিস্টেম কম্পোনেন্ট মেরামত করুন, তারপর আবার চেষ্টা করুন:

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

TIP

থার্ড-পার্টি ভার্চুয়াল মেশিন (VirtualBox, VMware) বা সিকিউরিটি সফটওয়্যারের স্যান্ডবক্স/প্রতিরক্ষা ফিচার (যেমন 360, Huorong) ভার্চুয়াল ডিস্ক অপারেশনে বাধা দিতে পারে, সমস্যা সমাধানে সাময়িকভাবে বন্ধ করে আবার চেষ্টা করুন।