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" మరియు "వర్చువల్ మెషిన్ ప్లాట్ఫారమ్" ఫీచర్లను ఎనేబుల్ చేయాలి.

మెథడ్ A: GUI ద్వారా (సిఫార్సు చేయబడింది)

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 1 ఇన్స్టాన్స్‌ను WSL 2 కి అప్‌గ్రేడ్ చేయడానికి మీరు wsl --set-version <分发版名称> 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 వర్చువల్ డిస్క్ స్టాక్ సరిగ్గా పని చేయకపోవడం; డిస్ట్రిబ్యూషన్‌ను రిజిస్టర్ చేసేటప్పుడు, ext4.vhdx ను క్రియేట్ చేయడం/మౌంట్ చేయడంలో WSL 2 విఫలమవుతుంది.

ముందుగా కనీస వెరిఫికేషన్ చేయండి: 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 Loopback Controller), మరియు 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) వర్చువల్ డిస్క్ ఆపరేషన్‌లకు అంతరాయం కలిగించవచ్చు; ట్రబుల్షూట్ చేసేటప్పుడు వాటిని తాత్కాలికంగా ఆఫ్ చేసి ప్రయత్నించవచ్చు.