This update only applies to machines with the windows subsystem for linux

«Download Linux kernel update package» error

What to do if you get the following error in step 4 of What to do if you try what is written in the formula but it does not solve the problem.

This update only applies to machines with the Windows Subsystem for Linux

Resolution

1. Download and unzip wsl_update_x64.msi
2. Unzip further «lxss_kernel» in the unzipped folder
3. Place «FID_LXSS_KERNEL» in the unzipped folder «lxss_kernel» in the following directory
4. Renamed to FID_LXSS_KERNEL → kernel

C:\\Windows\\System32\\lxss\\tools

That’s it.

First, install WSL2.0

WSL2.0 has a complete Linux kernel compared to WSL1.0, managed VM, and complete system call compatibility, so we use WSL2.0 here.

1. Enable Windows Subsystem for Linux: Open PowerShell and enter:

   dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
   

   

2. Check if WSL2 requirements:win+ROpen the run, then enterwinverCheck the Windows version
   

3. This version needs to be greater than 1903
   

4. Enable virtualization: Open PowerShell Enter the following command with administrators

   dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
   

   

5. downloadX64 WSL2 Linux kernel upgrade packageAnd install

6. Set WSL default version

   wsl --set-default-version 2
   

Second, install Ubuntu20.04LTS

1. Open Microsoft Store
   

2. General Windows add Ubuntu toMy software libraryIn, if you don’t search Ubuntu yourself and then install it, you can’t install it.

   

3. Find ubuntu 20.04lts Click to install, here I have installed it directly click to start
   

4. Set the initial username and password after opening, if the reference object type does not support attempt, reset the networknet winsock reset
   

5. Set the root password

   sudo passwd
   

Third, configure SSH

1. Modify the configuration file/etc/ssh/sshd_configOpen the following options

   PermitRootLogin YES # Allow root authentication login
    PasswordAuthentication YES # allows password authentication
    Rsaauthentication YES # Secret Key Certification
   PubkeyAuthentication yes
   

2. Since the OpenSSH-Server that comes has not generated a key, the key file is required, otherwise it will appear.sshd: no hostkeys available -- exiting.

   #ssh-keygen -t dsa -f /etc/ssh/ssh_host_dsa_key
   #ssh-keygen -t rsa -f /etc/ssh/ssh_host_rsa_key
   

3. Start SSH

   service ssh start
   

4. Boot start SSH:win+ROpen operation, entershell::startupEnter the boot start item, create WSL_SSH_START.BAT, its content is

   C: \ user name \ appdata \ local \ microsoft \ windowsapps \ ubuntu2004.exe run "sudo service ssh restart"
   

5. Default root login, open POWSHELL with administrators, enter the following command,
   Note: The username needs to replace it, the version page needs to be replaced, if the path of WSL is not hereC: \ Program Files \ WindowsApps \ xxx.ubuntuxxx \ ubuntu version .exe

   C: \ users \ User Name \ Appdata \ Local \ Microsoft \ WindowsApps \ Ubuntu Version.exe config --default-user root
   

Fourth, set the distribution version

Check the WSL version assigned to the installed Linuxwsl -l -v

wsl --list --verbose

Set the distribution version for a WSL version

wsl --set-version <distribution name> <versionNumber>

V. Common problems solve

5.1 Installation failed and error 0x80070003

Windows subsystem suitable for Linux can only be in the system drive (usuallyC: The drive is running in the drive. Make sure the distributed version is stored on the system drive: Open «Settings» -> System -> «Storage» ->«More Storage Settings»: Change the storage location of new content «

5.2 WSLREGISTERDISTRIBUTION failed and error 0x8007019E

Optional components that do not enable «Windows Subsystem for Linux»:

Open «Control Panel» -> Programs and Features «->» Windows Subsystem «-> Select» Windows Subsystem for Linux «or use the PowerShell cmdlet described in this article.

5.3 Installation failed, error 0x80070003 or error 0x80370102

Make sure that virtualization is enabled in your computer’s BIOS. Description of how to do this is different from the computer, and it is likely to under the CPU-related option. WSL2 requires the CPU to support the secondary address conversion (SLAT) function, which is incorporated in the Intel NehalerEm processor (Intel Core first generation) and AMD Opteron. Even if the virtual machine platform is successfully installed, the old CPU (such as Intel Core 2 Duo) cannot run WSL2.

5.4 Try to upgrade an error: Invalid Command Line Option: WSL —SET-VERSION Ubuntu 2

Make sure that Windows subsystems for Linux are enabled, and you are using Windows internal version 18362 or higher. To enable WSL, run this command as the PowerShell prompt with administrator privilege:Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux。

5.5 Due to a limit on the virtual disk system, the requested operation cannot be completed. The virtual hard disk file must be unpredied and unencrypted and cannot be sparse

• Uncheck «Compressed Content» (if «encrypted content» is selected, please uncheck it), the method is to open the Configuration file folder for the Linux release. It should be located in a folder on the Windows file system, similar to:USERPROFILE%\AppData\Local\Packages\CanonicalGroupLimited...
• In this Linux distribution configuration file, there should be a localState folder. Right-click this folder to display the menu of the option. Select Properties> Advanced, then make sure that the «Compressed content is not selected» and «Encrypt the content to protect the data» check box. If the system query is to apply this to the current folder or apply to all subfolders and files, select «Only this folder» because you just want to clear the compression flag. After completing this,wsl --set-version The command should work normally.

5.6 Unable to identify the word «WSL» as cmdlets, functions, scripting files, or running programs

please ensureAn optional component that is «Windows Subsystem for Linux» installed. Also, if you use the ARM64 device, you will receive this error from PowerShell. Please change it fromPowerShell Core Or run from the command promptwsl.exe。

5.7 Error: This update applies only to computers with Windows subsystems suitable for Linux

• To install the Linux kernel update MSI package, you need WSL, you should enable it first. If you fail, you will see the following message:This update only applies to machines with the Windows Subsystem for Linux。
• There are three possible reasons why this news appears:

1. You still use old version of Windows, WSL 2 is not supported. See step # 2 of the link request and updated update.
2. WSL is not enabled. Needable to return to step # 1 and make sure that an optional WSL function is enabled on your computer.
3. After enabling WSL, you need to restart to take effect, restart your computer and try again.

5.8 Error: WSL 2 requires updating its kernel components

If the Linux kernel package is missing in the% SystemRoot% \ System32 \ Lxss \ Tools folder, this error will be encountered. To resolve this issue, install the Linux kernel update MSI package in step # 4 of the installation instructions. May needAdd or delete programsUninstall the MSI and reinstall it.

Six, forget WSL password

If you forget the Linux distribution password:

1. Open PowerShell and use the following command to enter the default WSL distribution version of the root directory:wsl -u root

   If you need to update your forgotten password in a non-default distribution, use the command:wsl -d Debian -u rootAnd willDebian Replace the name of the target distribution.

2. After opening the WSL release root at the root level within PowerShell, you can use this command to update your password:passwd <WSLUsername>,among them <WSLUsername> Is the username of the account in Distro, and you forgot its password.

3. The system will prompt you to enter the new UNIX password and confirm this password. After being told that the password has been updated successfully, use the following command to close the WSL within PowerShell:exit

Reference documentation

Microsoft WSL documentation