Setup & Config 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 Update"-এর মাধ্যমে সিস্টেম আপগ্রেড করুন।

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

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

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

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

আপনাকে Windows-এর "Windows Subsystem for Linux" এবং "Virtual Machine Platform" ফিচার সক্রিয় করতে হবে।

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

1. Win + S চাপুন, "Windows ফিচার চালু বা বন্ধ করুন" খুঁজে খুলুন।
2. নিম্নলিখিত দুটি অপশনে টিক দিন:
   • 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 সংস্করণ/বিল্ড খুব পুরনো: 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 সার্ভিস খুঁজুন, স্টার্টআপ টাইপ "স্বয়ংক্রিয়" (Automatic) করুন এবং এটি চালু করুন।

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, হুওরং) ভার্চুয়াল ডিস্ক অপারেশনে বাধা দিতে পারে; সমস্যা সমাধানের সময় সাময়িকভাবে বন্ধ করে আবার চেষ্টা করুন।