লিনাক্স সাবসিস্টেম (WSL) সেটাপ এরর।

WSL2 Architecture: কার্নেল ভার্চুয়ালাইজেশন ও হাইপার-ভি (Hyper-V) লেয়ারের কারিগরি ব্যাকগ্রাউন্ড

আপনার উইন্ডোজ ১১ বা ১০ ওয়ার্কস্টেশনে কাস্টম পাইথন কোডিং, ডকার কন্টেইনারাইজেশন, কিংবা MERN স্ট্যাক ওয়েব ডেভলপমেন্টের জন্য WSL (Windows Subsystem for Linux) সেটআপ বা রান করার সময় কি হঠাৎ এরর কোড 0x80070003, 0x80370102, কিংবা 0xb000000d পপ-আপ করে পুরো টার্মিনাল ব্লক করে দিচ্ছে? wsl --install কমান্ড দেওয়ার পর স্ক্রিনে কি “The virtual machine could not be started because a required feature is not installed” অথবা “WslRegisterDistribution failed with error” মেসেজ দেখাচ্ছে? সাইবার সিকিউরিটি ল্যাব, ডেভলপার এনভায়রনমেন্ট কিংবা আইটি সিস্টেম অ্যাডমিনিস্ট্রেশনের পরিভাষায় এটি উইন্ডোজ কার্নেল এবং হার্ডওয়্যার ভার্চুয়ালাইজেশন সাবসিস্টেমের অত্যন্ত পরিচিত একটি কারিগরি ডেডলক।

কারিগরি ভাষায়, ওল্ড WSL1 ছিল কেবল একটি ট্রান্সলেশন লেয়ার, কিন্তু আধুনিক WSL2 হলো উইন্ডোজ কার্নেলের ভেতরে থাকা একটি সম্পূর্ণ লাইভ Lightweight Utility VM (Virtual Machine)। এই সাবসিস্টেমটি উইন্ডোজ ওএস কার্নেলের সাথে সরাসরি ইন্টারঅ্যাক্ট করতে মাইক্রোসফটের নিজস্ব হাইপারভাইজার আর্কিটেকচার Hyper-V Architecture এবং Virtual Machine Platform (VMP) এপিআই প্রটোকল ব্যবহার করে।

ল্যাপটপ বা পিসিতে অনবরত হাই-লোডে কাজ করার সময় ব্যাকগ্রাউন্ডে যদি উইন্ডোজের হাইপারভাইজার প্ল্যাটফর্ম রেজিস্ট্রি করাপ্ট হয়ে যায়, উইন্ডোজ ওএস আপডেটের পর লিনাক্স কার্নেল আপডেট প্যাকেজ (wsl_update_x64.msi) মিসম্যাচ করে, কিংবা পিসির মূল মাদারবোর্ড বায়োস (BIOS) লেভেলে হার্ডওয়্যার ভার্চুয়ালাইজেশন ফিচারটি ডিজেবল বা বন্ধ হয়ে থাকে—তবে উইন্ডোজ কার্নেল লিনাক্সের জন্য রিয়েল-টাইম মেমোরি এবং প্রসেসর থ্রেড বরাদ্দ করতে পারে না। এর ফলে ডাব্লিউএসএল সাবসিস্টেমটি সম্পূর্ণ ক্র্যাশ করে এই এররগুলো থ্রো করে।

কোনো থার্ড-পার্টি অনিরাপদ সফটওয়্যার বা ড্রাইভার বুস্টার ছাড়াই উইন্ডোজের ইন্টারনাল বুট কনফিগারেশন, টার্মিনাল কমান্ড এবং বায়োস লজিক ব্যবহার করে WSL2 সেটআপ এরর গোঁড়া থেকে ফিক্স করার ৫টি প্রফেশনাল টেকনিক্যাল মেথড নিচে ধাপে ধাপে দেওয়া হলো:

WSL সেটআপ এরর সমাধানের ৫টি প্রফেশনাল মেথড

১. মাদারবোর্ড বায়োস (BIOS) লেভেলে ‘Hardware Virtualization’ এনাবল করা

ডাব্লিউএসএল২ রান করার সময় যদি এরর কোড 0x80370102 বা 0x80070003 আসে, তবে এর প্রধান মেকানিক্যাল কারণ হলো মাদারবোর্ডে ভার্চুয়ালাইজেশন বন্ধ থাকা।

ধাপ ১: আমাদের পূর্ববর্তী বায়োস চ্যাপ্টারের গাইডলাইন অনুযায়ী পিসি রিস্টার্ট দিয়ে মাদারবোর্ডের ডেডিকেটেড কী (যেমন: Del, F2 বা F10) চেপে বায়োস বা ইউইএফআই (UEFI) সেটিংসে প্রবেশ করুন।
ধাপ ২ (চিপসেট টিউনিং): মাদারবোর্ড আর্কিটেকচার অনুযায়ী এই সুনির্দিষ্ট অপশনটি খুঁজে বের করুন:
- Intel প্রসেসরের জন্য: Advanced বা CPU Configuration ট্যাবে গিয়ে Intel Virtualization Technology (VT-x) অথবা Vanderpool অপশনটি Enabled করুন।
- AMD প্রসেসরের জন্য: Advanced বা MIT সেটিংসে গিয়ে SVM Mode (Secure Virtual Machine) অপশনটি Enabled করুন।
ধাপ ৩: একই সাথে বায়োসের ভেতরে VT-d অথবা IOMMU অপশনটি অন করে দিন। এবার সেটিংসটি F10 চেপে সেভ করে উইন্ডোজে বুট করুন; হার্ডওয়্যার লেভেলের ভার্চুয়াল গেটওয়ে সম্পূর্ণ আনলক হয়ে যাবে।

২. উইন্ডোজ অপশনাল ফিচার্স থেকে ‘Virtual Machine Platform’ লাইভ অ্যাক্টিভেশন

উইন্ডোজের ব্যাকএন্ডে লিনাক্স রেন্ডার করার মূল কার্নেল কম্পোনেন্ট এবং হাইপারভাইজার প্ল্যাটফর্মটি ওএস টার্মিনাল বা কমান্ড-লাইন দিয়ে ফোর্স-অন করার প্রফেশনাল পদ্ধতি:

উইন্ডোজ সার্চ বারে cmd লিখে রাইট ক্লিক করে Run as administrator হিসেবে কমান্ড প্রম্পট ওপেন করুন।
উইন্ডোজের রুট ডিরেক্টরি থেকে সরাসরি ভার্চুয়াল মেশিন প্ল্যাটফর্ম এপিআই অ্যাক্টিভেট করতে এই গলোবাল কমান্ডটি টাইপ করে এন্টার চাপুন:dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
এবার উইন্ডোজের ইন্টারনাল সাবসিস্টেম লজিক সচল করতে এই সেকেন্ডারি কমান্ডটি রান করুন:dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
কমান্ড দুটি সফলভাবে এক্সিকিউট হলে পিসিটি একবার ম্যানুয়ালি রিস্টার্ট দিন যেন ওএস কার্নেল মেমোরি অ্যালোকেশন টেবিল রিফ্রেশ করতে পারে।

৩. WSL ডিফল্ট আর্কিটেকচার ভার্সন ‘WSL 2’ এ লক করা

উইন্ডোজ অনেক সময় ওল্ড লিগ্যাসি ‘Version 1’ আর্কিটেকচারে লিনাক্স ডিস্ট্রিবিউশন (যেমন: Ubuntu, Kali Linux) বুট করতে গিয়ে কনফ্লিক্ট তৈরি করে। এটিকে ফিক্স করার নিয়ম:

উইন্ডোজ সার্চ বারে PowerShell লিখে রাইট ক্লিক করে Run as administrator হিসেবে ওপেন করুন।
উইন্ডোজের গ্লোবাল ডাব্লিউএসএল ইঞ্জিনকে ডিফল্ট ২ নম্বর হাইপারভাইজার মোডে লক করতে এই কমান্ডটি রান করুন:wsl --set-default-version 2
কার্নেল কারেন্ট স্ট্যাটাস চেক: আপনার পিসিতে রানিং লিনাক্স ডিস্ট্রিবিউশনটি কোন ভার্সনে চলছে তা অডিট করতে টাইপ করুন: wsl --list --verbose (বা wsl -l -v)। যদি সেখানে ভার্সনের নিচে 1 লেখা থাকে, তবে ওল্ড লুপ ভেঙে ২ নম্বর ভার্সনে রূপান্তর করতে এই কমান্ডটি দিন:wsl --set-version <distro_name> 2 (যেমন: wsl --set-version Ubuntu 2)।

৪. ক্র্যাশড ‘Hyper-V Hypervisor’ বুটশেল লুপ ফিক্স (`0x800703fa`)

উইন্ডোজের মেইন বুট কনফিগারেশন ডাটাবেজে (BCD) যদি হাইপারভাইজার লঞ্চ টাইপটি কোনো ম্যালওয়্যার বা ওল্ড রেজিস্ট্রি জ্যামের কারণে ডিজেবল বা অফ হয়ে থাকে, তবে তা রুট লেভেলে রিসেট করার মেথড:

কমান্ড প্রম্পট বা পাওয়ারশেল অ্যাডমিন মোডে ওপেন করুন।
উইন্ডোজ বুট লোডারকে প্রতি বুটে হাইপারভাইজার কার্নেল অটো-রান করার নির্দেশ দিতে এই সিক্রেট কোডটি টাইপ করে এন্টার চাপুন:bcdedit /set hypervisorlaunchtype auto
প্রসেস শেষ হলে পিসিটি একবার রিস্টার্ট দিন। এটি উইন্ডোজ ওএস বুট হওয়ার সময় ব্যাকগ্রাউন্ডের থান্ডারবোল্ট ও পিসিআইই বাসের সাথে হাইপারভাইজার চিপসেটকে শতভাগ সিঙ্কড করে দেবে, যা WSL২ এর সমস্ত স্টার্টিং এরর চিরতরে রিমুভ করবে।

৫. অফিশিয়াল ‘WSL Linux Kernel Update’ প্যাকেজ ম্যানুয়াল ফ্ল্যাশিং

যদি উইন্ডোজের ইন্টারনাল আপডেট ডিরেক্টরি করাপ্ট থাকার কারণে লিনাক্স কার্নেলের আইসোলেটেড ইমেজ ফাইলটি (bzImage) ড্যামেজড হয়ে থাকে, তবে মাইক্রোসফটের অফিশিয়াল লাইব্রেরি থেকে তা রিলোড করার ইঞ্জিনিয়ারিং পদ্ধতি:

আপনার ব্রাউজার ওপেন করে অফিশিয়াল মাইক্রোসফট ডাব্লিউএসএল কার্নেল আপডেট ডিরেক্টরিতে যান (অথবা টার্মিনালে টাইপ করুন wsl --update)।
যদি অনলাইন আপডেট ফেইল করে, তবে ম্যানুয়ালি “WSL2 Linux kernel update package for x64 machines” (MSI ইনস্টলার) ফাইলটি ডাউনলোড করুন।
ডাউনলোড করা ফাইলটির ওপর রাইট ক্লিক করে Run as administrator হিসেবে ইনস্টল ফিনিশ করুন।
এবার টার্মিনাল ওপেন করে আপনার টার্গেট লিনাক্স ডিস্ট্রিবিউশন ফ্রেশ বুট করতে টাইপ করুন: wsl --shutdown (এটি ওল্ড হ্যাং হওয়া সেশন কিল করবে) এবং এরপর টাইপ করুন: wsl। আপনার লিনাক্স সাবসিস্টেম এরর মুক্ত হয়ে বুলেটের গতিতে লাইভ চালু হয়ে যাবে।

💡 আইটি প্রফেশনাল ও ডেভলপারদের জন্য সিএসই ইঞ্জিনিয়ার্স প্রো-টিপ

আপনি যদি আপনার ওয়ার্ক站েশনে প্রফেশনাল গেমিং, ওবিএস স্টুডিও (OBS Studio) দিয়ে ৪কে গেমপ্লে রেকর্ড, কাস্টম পাইথন স্ক্রিপ্টিং, কিংবা ডকার কন্টেইনার এবং MERN স্ট্যাক ওয়েব ডেভলপমেন্টের প্রোডাকশন এনভায়রনমেন্ট একসাথে সচল রাখেন, তবে ভার্চুয়ালাইজেশন সিকিউরিটি নিয়ে নিচের গোল্ডেন রুলটি সর্বদা মাথায় রাখবেন:

কারিগরি সতর্কতা: ইন্টারনেট থেকে ডাব্লিউএসএল বা উবুন্টুর স্পিড বুস্ট করার জন্য কিংবা গ্রাফিক্যাল ইউজার ইন্টারফেস (GUI) আনলক করার জন্য কোনো আনভেরিফাইড থার্ড-পার্টি কাস্টম “WSL Optimizer” বা পাইরেটেড লিনাক্স স্ক্রিপ্ট সরাসরি ডাউনলোড করে সুডো (sudo) পারমিশন বা উইন্ডোজ অ্যাডমিন মোডে রান করবেন না। সাইবার সিকিউরিটির আধুনিক অডিট এবং কন্টেইনার এস্কেপ (Container Escape) ভালনারেবিলিটি রিপোর্ট অনুযায়ী, হ্যাকাররা অনেক সময় এই ধরনের ওপেন-সোর্স ইউটিলিটি স্ক্রিপ্টের ব্যাকহ্যান্ডে বিপজ্জনক Rootkit / Ransomware ইনজেক্ট করে রাখে।

যেহেতু WSL2 সরাসরি উইন্ডোজের মূল ড্রাইভের (C:\) ফাইল সিস্টেম অ্যাক্সেস করতে পারে (via /mnt/c/), তাই লিনাক্স সাবসিস্টেমে ঢুকে পড়া ম্যালওয়্যার খুব সহজেই লিনাক্সের বাউন্ডারি ভেঙে আপনার মূল উইন্ডোজ ওএসের কার্নেল সিকিউরিটি পলিসি হাইজ্যাক করে নিতে পারে। এটি আপনার ব্রাউজারের সমস্ত সেভ করা মাস্টার পাসওয়ার্ড, এসএসএইচ কী (SSH Keys) এবং ডেভলপমেন্ট ক্রেডেনশিয়াল সম্পূর্ণ স্নাইপ করে ডার্ক ওয়েবে লিক করে দিতে পারে।

সমাধান: ডাব্লিউএসএল টিউনিং বা কাস্টমাইজেশনের জন্য সর্বদা মাইক্রোসফটের অফিশিয়াল উইন্ডোজ লিনাক্স ডকুমেন্টেশন সমর্থিত জেনুইন কমান্ড ব্যবহার করুন। পিসির ওএস কার্নেল ভাইরাসমুক্ত ও ফ্রেশ রাখতে প্রতি সপ্তাহে অন্তত একবার উইন্ডোজের ইন্টারনাল বুটশেল ব্যবহার করে একটি কমপ্লিট Microsoft Defender Offline Scan রান করা গ্লোবাল স্ট্যান্ডার্ড প্রফেশনাল সিকিউরিটি প্রটোকল।

⚠️ হার্ডওয়্যার স্ট্যাবিলিটি ও জিপিইউ পারফরম্যান্স নোট

ডিজিটাল নিরাপত্তা, ম্যালওয়্যার ফ্রি ক্লিন অপারেটিং সিস্টেম এবং নিখুঁত হার্ডওয়্যার অপ্টিমাইজেশন প্রফেশনাল কাজের পারফরম্যান্স সর্বোচ্চ স্তরে ধরে রাখার মূল চাবিকাঠি। আপনার পিসিতে যদি শক্তিশালী NVIDIA GeForce RTX 5060 গ্রাফিক্স کارت এবং উচ্চগতির Samsung 990 Pro NVMe M.2 SSD-এর মতো হাই-এন্ড হার্ডওয়্যার থাকে, তবে ডাব্লিউএসএল২ সেটিংসের ভেতর vGPU (Virtual GPU Passthrough) প্রটোকলটি সক্রিয় থাকলে তা সরাসরি উইন্ডোজের ডেডিকেটেড গ্রাফিক্স মেমোরি (VRAM) লিনাক্স কার্নেলের সাথে শেয়ার করতে পারে।

এর ফলে লিনাক্স এনভায়রনমেন্টের ভেতর ডকার বা কোনো জটিল এআই/মেশিন লার্নিং পাইথন কোড কম্পাইল বা রান করার সময়ও সিস্টেমে হঠাৎ কোনো ফ্রেম ড্রপ, মেমোরি লিক বা থার্মাল থ্রোটলিং (Thermal Throttling) হবে না এবং হার্ডওয়্যারের পারফরম্যান্স সর্বদা স্মুথ ও সর্বোচ্চ স্তরে স্ট্যাবল থাকবে।

আপনার আইটি সেন্টারের যেকোনো জটিল ডাব্লিউএসএল২ কার্নেল ট্রাবলছুটিং, ডকার কন্টেইনার ল্যাব সেটআপ, মাদারবোর্ড বায়োস আপগ্রেডেশন, উইন্ডোজ রেজিস্ট্রি অডিট, ডাটা ব্যাকআপ পলিসি কনফিগারেশন, কিংবা যেকোনো প্রফেশনাল সিস্টেম অ্যাডমিনিস্ট্রেশন ও নেটওয়ার্কিং আইটি সリューションের জন্য আপনারা সরাসরি আমাদের Dinajpur IT Park-এ যোগাযোগ করতে পারেন.