Skip to content

Commit

Permalink
Update Build #, add Insider note (#674)
Browse files Browse the repository at this point in the history
  • Loading branch information
mattwojo authored May 12, 2020
1 parent eaeb3de commit 050808c
Show file tree
Hide file tree
Showing 5 changed files with 26 additions and 20 deletions.
4 changes: 3 additions & 1 deletion WSL/compare-versions.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
3 changes: 2 additions & 1 deletion WSL/install-on-server.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)**

Expand Down
35 changes: 19 additions & 16 deletions WSL/install-win10.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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".

Expand All @@ -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
Expand Down Expand Up @@ -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.
Expand Down
2 changes: 1 addition & 1 deletion WSL/reference.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
2 changes: 1 addition & 1 deletion WSL/wsl2-index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)

Expand Down

0 comments on commit 050808c

Please sign in to comment.