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 యొక్క "లినక్స్ కోసం Windows సబ్‌సిస్టమ్" మరియు "వర్చువల్ మెషిన్ ప్లాట్‌ఫారమ్" ఫీచర్‌లను ప్రారంభించాలి.

పద్ధతి A: గ్రాఫికల్ ఇంటర్ఫేస్ ద్వారా (సిఫార్సు చేయబడింది)

1. Win + S నొక్కి, "Windows ఫీచర్‌లను ప్రారంభించండి లేదా నిలిపివేయండి" అని సెర్చ్ చేసి తెరవండి.
2. కింది రెండు ఎంపికలను గుర్తించండి:
   • లినక్స్ కోసం 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. ఇన్‌స్టాలేషన్ వైఫల్యాన్ని పరిష్కరించడం

అధ్యాయం 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

ఏ కమాండ్ కూడా wsl --install 100% విజయవంతం అవుతుందని హామీ ఇవ్వదు, కానీ పై డిటెక్షన్ ఇన్స్టాలేషన్ పరిస్థితులు తీరాయో లేదో నిర్ధారించవచ్చు.

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 వంటివి) వర్చువల్ డిస్క్ కార్యకలాపాలకు అంతరాయం కలిగించవచ్చు, పరిశోధన సమయంలో వాటిని తాత్కాలికంగా ఆఫ్ చేసి ప్రయత్నించండి.