From 050808c3207a9f6429a8bccf151916e42c3e31e6 Mon Sep 17 00:00:00 2001 From: Matt Wojciakowski Date: Tue, 12 May 2020 15:35:47 -0700 Subject: [PATCH] Update Build #, add Insider note (#674) --- WSL/compare-versions.md | 4 +++- WSL/install-on-server.md | 3 ++- WSL/install-win10.md | 35 +++++++++++++++++++---------------- WSL/reference.md | 2 +- WSL/wsl2-index.md | 2 +- 5 files changed, 26 insertions(+), 20 deletions(-) diff --git a/WSL/compare-versions.md b/WSL/compare-versions.md index e06b2648..2efbff17 100644 --- a/WSL/compare-versions.md +++ b/WSL/compare-versions.md @@ -26,7 +26,9 @@ Feature | WSL 1 | WSL 2 Runs with VM Ware and VirtualBox| ✅ |❌ Performance across OS file systems| ✅ | ❌ -Already using WSL 1 and want to upgrade to WSL 2? Follow the instructions to [update to WSL 2](./install-win10.md#update-to-wsl-2)! WSL 2 is only available in Windows 10 builds 18917 or higher, so you may need to [update to the latest Windows version](ms-settings:windowsupdate). +Already using WSL 1 and want to upgrade to WSL 2? Follow the instructions to [update to WSL 2](./install-win10.md#update-to-wsl-2)! + +WSL 2 is only available in Windows 10, Version 2004, Build 19041 or higher. You will need to [update your Windows version](ms-settings:windowsupdate) and [join the Windows Insider program](https://insider.windows.com/insidersigninboth/) on the "Release Preview" ring until the public release in late May. ## Use the Linux file system for faster performance diff --git a/WSL/install-on-server.md b/WSL/install-on-server.md index 45bbf45b..0ee3e95e 100644 --- a/WSL/install-on-server.md +++ b/WSL/install-on-server.md @@ -23,7 +23,8 @@ Open PowerShell as Administrator and run: ``` **If you're looking for 100% system call compatibility and faster IO performance, read below to install WSL 2!** -> WSL 2 is only available in Windows 10 builds 18917 or higher + +WSL 2 is only available in Windows 10, Version 2004, Build 19041 or higher. You will need to [update your Windows version](ms-settings:windowsupdate) and [join the Windows Insider program](https://insider.windows.com/insidersigninboth/) on the "Release Preview" ring until the public release in late May. **If continuing with WSL 1, restart your machine when prompted and continue with installation [here](./install-on-server.md#download-a-linux-distribution)** diff --git a/WSL/install-win10.md b/WSL/install-win10.md index 66cc3b3e..4afa59b9 100644 --- a/WSL/install-win10.md +++ b/WSL/install-win10.md @@ -27,6 +27,9 @@ To update to WSL 2, you must meet the follow criteria: - Running Windows 10, [updated to version 2004](ms-settings:windowsupdate), **Build 19041** or higher. +> [!IMPORTANT] +> Currently to update to Windows 10, version 2004 (Build 19041), you will need to [join the Windows Insider program](https://insider.windows.com/insidersigninboth/) and select the "Release Preview" ring. The public release should arrive by late May. + - Check your Windows version by selecting the **Windows logo key + R**, type **winver**, select **OK**. (Or enter the `ver` command in Windows Command Prompt). Please [update to the latest Windows version](ms-settings:windowsupdate) if your build is lower than 19041. [Get Windows Update Assistant](https://www.microsoft.com/software-download/windows10). ### Enable the 'Virtual Machine Platform' optional component @@ -57,20 +60,20 @@ wsl --set-default-version 2 The following links will open the Microsoft store page for each distribution: - * [Ubuntu](https://www.microsoft.com/store/apps/9NBLGGH4MSV6) - * [Ubuntu 16.04 LTS](https://www.microsoft.com/store/apps/9pjn388hp8c9) - * [Ubuntu 18.04 LTS](https://www.microsoft.com/store/apps/9N9TNGVNDL3Q) - * [Ubuntu 20.04 LTS](https://www.microsoft.com/store/apps/9N6SVWS3RX71) - * [OpenSUSE Leap 15](https://www.microsoft.com/store/apps/9n1tb6fpvj8c) - * [OpenSUSE Leap 42](https://www.microsoft.com/store/apps/9njvjts82tjx) - * [SUSE Linux Enterprise Server 12](https://www.microsoft.com/store/apps/9p32mwbh6cns) - * [SUSE Linux Enterprise Server 15](https://www.microsoft.com/store/apps/9pmw35d7fnlx) - * [Kali Linux](https://www.microsoft.com/store/apps/9PKR34TNCV07) - * [Debian GNU/Linux](https://www.microsoft.com/store/apps/9MSVKQC78PK6) - * [Fedora Remix for WSL](https://www.microsoft.com/store/apps/9n6gdm4k2hnc) - * [Pengwin](https://www.microsoft.com/store/apps/9NV1GV1PXZ6P) - * [Pengwin Enterprise](https://www.microsoft.com/store/apps/9N8LP0X93VCP) - * [Alpine WSL](https://www.microsoft.com/store/apps/9p804crf0395) + - [Ubuntu](https://www.microsoft.com/store/apps/9NBLGGH4MSV6) + - [Ubuntu 16.04 LTS](https://www.microsoft.com/store/apps/9pjn388hp8c9) + - [Ubuntu 18.04 LTS](https://www.microsoft.com/store/apps/9N9TNGVNDL3Q) + - [Ubuntu 20.04 LTS](https://www.microsoft.com/store/apps/9N6SVWS3RX71) + - [OpenSUSE Leap 15](https://www.microsoft.com/store/apps/9n1tb6fpvj8c) + - [OpenSUSE Leap 42](https://www.microsoft.com/store/apps/9njvjts82tjx) + - [SUSE Linux Enterprise Server 12](https://www.microsoft.com/store/apps/9p32mwbh6cns) + - [SUSE Linux Enterprise Server 15](https://www.microsoft.com/store/apps/9pmw35d7fnlx) + - [Kali Linux](https://www.microsoft.com/store/apps/9PKR34TNCV07) + - [Debian GNU/Linux](https://www.microsoft.com/store/apps/9MSVKQC78PK6) + - [Fedora Remix for WSL](https://www.microsoft.com/store/apps/9n6gdm4k2hnc) + - [Pengwin](https://www.microsoft.com/store/apps/9NV1GV1PXZ6P) + - [Pengwin Enterprise](https://www.microsoft.com/store/apps/9N8LP0X93VCP) + - [Alpine WSL](https://www.microsoft.com/store/apps/9p804crf0395) 2. From the distribution's page, select "Get". @@ -86,7 +89,7 @@ You will then need to [create a user account and password for your new Linux dis ## Set your distribution version to WSL 1 or WSL 2 -You can check the WSL version assigned to each of the Linux distributions you have installed by opening the PowerShell command line and entering the command (only available in Windows Build 18917 or higher): `wsl -l -v` +You can check the WSL version assigned to each of the Linux distributions you have installed by opening the PowerShell command line and entering the command (only available in [Windows Build 19041 or higher](ms-settings:windowsupdate)): `wsl -l -v` ```bash wsl --list --verbose @@ -125,7 +128,7 @@ Below are related errors and suggested fixes. Refer to the [WSL troubleshooting - Please make sure that virtualization is enabled inside of your computer's BIOS. The instructions on how to do this will vary from computer to computer, and will most likely be under CPU related options. - **Error when trying to upgrade: `Invalid command line option: wsl --set-version Ubuntu 2`** - - Please make sure that you have the Windows Subsystem for Linux enabled, and that you're using Windows Build version 18917 or higher. To enable WSL run this command in a Powershell prompt with admin privileges: `Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux`. You can find the full WSL install instructions [here](./install-win10.md). + - Please make sure that you have the Windows Subsystem for Linux enabled, and that you're using Windows Build version 19041 or higher. To enable WSL run this command in a Powershell prompt with admin privileges: `Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux`. You can find the full WSL install instructions [here](./install-win10.md). - **The requested operation could not be completed due to a virtual disk system limitation. Virtual hard disk files must be uncompressed and unencrypted and must not be sparse.** - Please check [WSL Github thread #4103](https://github.com/microsoft/WSL/issues/4103) where this issue is being tracked for updated information. diff --git a/WSL/reference.md b/WSL/reference.md index 1facd116..5b5308a2 100644 --- a/WSL/reference.md +++ b/WSL/reference.md @@ -22,7 +22,7 @@ wsl --set-default-version 2 ## Set your distribution version to WSL 1 or WSL 2 -You can check the WSL version assigned to each of the Linux distributions you have installed by opening the PowerShell command line and entering the command (only available in Windows Build 18917 or higher): `wsl -l -v` +You can check the WSL version assigned to each of the Linux distributions you have installed by opening the PowerShell command line and entering the command (only available in [Windows Build 19041 or higher](ms-settings:windowsupdate)): `wsl -l -v` ```bash wsl --list --verbose diff --git a/WSL/wsl2-index.md b/WSL/wsl2-index.md index b438c12f..590837b2 100644 --- a/WSL/wsl2-index.md +++ b/WSL/wsl2-index.md @@ -11,7 +11,7 @@ ms.localizationpriority: high WSL 2 is a new version of the architecture in WSL that changes how Linux distributions interact with Windows. WSL 2 has the primary goals of increasing file system performance and adding full system call compatibility. Each Linux distribution can run as WSL 1 or a WSL 2 and can be switched between at any time. WSL 2 is a major overhaul of the underlying architecture and uses virtualization technology and a Linux kernel to enable its new features. -> WSL 2 is only available in Windows 10 builds 18917 or higher. +WSL 2 is only available in Windows 10, Version 2004, Build 19041 or higher. You will need to [update your Windows version](ms-settings:windowsupdate) and [join the Windows Insider program](https://insider.windows.com/insidersigninboth/) on the "Release Preview" ring until the public release in late May. [Update from WSL 1 to WSL 2](./install-win10.md#update-to-wsl-2)