Skip to content

Commit ba52d67

Browse files
Added new troubleshooting steps (#786)
* Added new troubleshooting steps
1 parent f1b049a commit ba52d67

2 files changed

Lines changed: 56 additions & 0 deletions

File tree

WSL/troubleshooting.md

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -36,6 +36,41 @@ Lastly, if your issue is related to the Windows Terminal, Windows Console, or th
3636

3737
## Common issues
3838

39+
### Cannot access WSL files from Windows
40+
A 9p protocol file server provides the service on the Linux side to allow Windows to access the Linux file system. If you cannot access WSL using `\\wsl$` on Windows, it could be because 9P did not start correctly.
41+
42+
To check this, you can check the start up logs using: `dmesg |grep 9p`, and this will show you any errors. A successfull output looks like the following:
43+
44+
```
45+
[ 0.363323] 9p: Installing v9fs 9p2000 file system support
46+
[ 0.363336] FS-Cache: Netfs '9p' registered for caching
47+
[ 0.398989] 9pnet: Installing 9P2000 support
48+
```
49+
50+
Please see [this Github thread](https://github.com/microsoft/wsl/issues/5307) for further discussion on this issue.
51+
52+
### Can't start WSL 2 distro and only see 'WSL 2' in output
53+
If your display language is not English, then it is possible you are seeing a truncated version of an error text.
54+
55+
```powershell
56+
C:\Users\me>wsl
57+
WSL 2
58+
```
59+
60+
To resolve this issue, please visit `https://aka.ms/wsl2kernel` and install the kernel manually by following the directions on that doc page.
61+
62+
### Please enable the Virtual Machine Platform Windows feature and ensure virtualization is enabled in the BIOS.
63+
64+
1. Check the [Hyper-V system requirements](https://docs.microsoft.com/windows-server/virtualization/hyper-v/system-requirements-for-hyper-v-on-windows#:~:text=on%20Windows%20Server.-,General%20requirements,the%20processor%20must%20have%20SLAT.)
65+
2. If your machine is a VM, please enable [nested virtualization](https://docs.microsoft.com/windows/wsl/wsl2-faq#can-i-run-wsl-2-in-a-virtual-machine) manually. Launch powershell with admin, and run:
66+
67+
```powershell
68+
Set-VMProcessor -VMName <VMName> -ExposeVirtualizationExtensions $true
69+
```
70+
71+
3. Please follow guidelines from your PC's manufacturer on how to enable virtualization. In general, this can involve using the system BIOS to ensure that these features are enabled on your CPU.
72+
4. Restart your machine after enabling the `Virtual Machine Platform` optional component.
73+
3974
### Bash loses network connectivity once connected to a VPN
4075

4176
If after connecting to a VPN on Windows, bash loses network connectivity, try this workaround from within bash. This workaround will allow you to manually override the DNS resolution through `/etc/resolv.conf`.

WSL/wsl2-kernel.md

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -34,3 +34,24 @@ To install the Linux kernel update package:
3434
## Future plans for updating the WSL2 Linux kernel
3535

3636
For more information, read the article [changes to updating the WSL2 Linux kernel](https://devblogs.microsoft.com/commandline/wsl2-will-be-generally-available-in-windows-10-version-2004), available on the [Windows Command Line Blog](https://aka.ms/cliblog).
37+
38+
## Troubleshooting
39+
40+
### This update only applies to machines with the Windows Subsystem for Linux
41+
To install MSI kernel, WSL is required and should be enabled first. If it fails, it you will see the message:
42+
`This update only applies to machines with the Windows Subsytem for Linux`.
43+
44+
There are three possible reason you see this message:
45+
46+
1. You are still in old version of Windows which doesn't support WSL 2. Please check the [WSL 2 requirements](https://docs.microsoft.com/windows/wsl/install-win10#update-to-wsl-2) and upgrade to use WSL 2.
47+
2. `Windows Subsystem for Linux` is not enabled. Please follow the [Windows Subsystem for Linux Installation Guide](https://docs.microsoft.com/windows/wsl/install-win10).
48+
3. After you enabled `Windows Subsystem for Linux`, a reboot is required to take into effect, please reboot your machine and try again.
49+
50+
### `WSL 2 requires an update to its kernel component. For information please visit https://aka.ms/wsl2kernel`
51+
52+
Each time kernel is missing in %SystemRoot%\system32\lxss\tools\, you may run into the above error.
53+
54+
Here are some possible ways to resolve it:
55+
56+
1. Please install the Linux kernel manually by following the instructions at: https://aka.ms/wsl2kernel
57+
2. Uninstall the MSI from 'Add or Remove Programs', and install it again

0 commit comments

Comments
 (0)