WSL संरचना

WSL Dashboard वापरण्यापूर्वी, तुमच्या Windows सिस्टमवर WSL 2 वातावरण योग्यरित्या सक्षम आणि कॉन्फिगर केलेले असणे आवश्यक आहे. हा दस्तऐवज तीन मुख्य भागांमध्ये विभागलेला आहे:

1. WSL सक्षम आणि कॉन्फिगर करणे: WSL 2 ची मूलभूत स्थापना आणि संरचना पूर्ण करा.
2. आज्ञा उपलब्ध असणे म्हणजे स्थापना यशस्वी नव्हे: wsl आज्ञा चालवता येणे म्हणजे Linux यशस्वीरित्या स्थापित करता येते असा अर्थ नाही हे स्पष्ट करते.
3. स्थापना अपयश निवारण: संरचना पूर्ण केल्यानंतरही स्थापना अपयशी ठरल्यास तपासणी आणि दुरुस्ती पद्धती.

1. WSL सक्षम आणि कॉन्फिगर करणे

हा अध्याय आवश्यक मूलभूत सेटिंग्ज पूर्ण करण्यासाठी मार्गदर्शन करेल. हा अध्याय पूर्ण केल्यानंतर, आज्ञा उपलब्धता आणि स्थापना यश यातील फरक समजून घेण्यासाठी दुसरा अध्याय वाचा; स्थापनेत अजूनही समस्या असल्यास, तिसरा अध्याय पहा.

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".
• स्थिती पहा: खालील उजव्या कोपऱ्यातील "व्हर्च्युअलायझेशन" स्थिती "Enabled" दाखवते याची खात्री करा.
• सक्षम करण्याची पद्धत: सक्षम नसल्यास, तुम्हाला संगणक रीस्टार्ट करून BIOS/UEFI सेटिंग्जमध्ये जावे लागेल, Intel VT-x किंवा AMD-V सारखा पर्याय शोधून तो Enabled करावा लागेल.

1.3 Windows संबंधित वैशिष्ट्ये सक्षम करा

तुम्हाला "Windows Subsystem for Linux" आणि "Virtual Machine Platform" वैशिष्ट्ये सक्षम करावी लागतील.

पद्धत 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 आवृत्ती/बिल्ड खूप जुनी: WSL 2 ला कर्नल आणि आवृत्तीची आवश्यकता आहे, होम आवृत्ती, खूप जुन्या एंटरप्राइझ इमेजमध्ये अपूर्ण वैशिष्ट्ये असू शकतात (तपासणी पद्धत 1.1 सिस्टम आवश्यकता तपासा पहा).
3. Linux वितरण अद्याप स्थापित केलेले नाही: wsl -l -v फक्त स्थापित वितरणांची यादी करते, काहीही स्थापित नसल्यास यादी रिकामी असते, याचा अर्थ Ubuntu थेट चालवता येते असा नाही.
4. नेटवर्क / Microsoft Store समस्या: wsl --install -d <वितरण> स्टोअर किंवा नेटवर्कवरून इमेज खेचणे आवश्यक आहे, कंपनी नेटवर्क, प्रॉक्सी, फायरवॉल अडथळा आणू शकतात.
5. अपुरी परवानगी: वितरण स्थापित करण्यासाठी किंवा WSL सेटिंग्ज बदलण्यासाठी प्रशासक परवानगी आवश्यक.

TIP

थोडक्यात: WSL आज्ञा चालते ≠ Linux सज्ज आहे, फक्त "तिकीट" मिळाले आहे, प्रत्यक्षात सिस्टम अजून स्थापित झालेली नाही.

3. स्थापना अपयश निवारण

पहिला अध्याय प्रमाणे संरचना पूर्ण केल्यानंतर (किंवा तुम्ही संरचना पूर्ण केली आहे असे वाटत असल्यास), 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 घटक स्थापित नाही, पहिला अध्याय वर परत जा.
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, लाइव्ह 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, ह्युरॉन्ग इत्यादी) व्हर्च्युअल डिस्क ऑपरेशन्समध्ये व्यत्यय आणू शकतात, तपासताना तात्पुरते बंद करून पहा.