From a9eabd593bca109a4adf06b2c9e077f9acffea7d Mon Sep 17 00:00:00 2001 From: Ruud Schellekens Date: Sun, 21 Feb 2021 21:00:56 +0100 Subject: [PATCH] Added information on installing WSL2 to the Compilation Environments page. --- docs/assets/images/WSL2_Windows_features.png | Bin 0 -> 15051 bytes .../build_system/compilation_environments.md | 50 +++++++++++++++++- 2 files changed, 49 insertions(+), 1 deletion(-) create mode 100644 docs/assets/images/WSL2_Windows_features.png diff --git a/docs/assets/images/WSL2_Windows_features.png b/docs/assets/images/WSL2_Windows_features.png new file mode 100644 index 0000000000000000000000000000000000000000..7c3ebc6f0fd0c87f95c0dd0fde5f3d57bfb9e614 GIT binary patch literal 15051 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 literal 0 HcmV?d00001 diff --git a/docs/developer_guide/tutorials/build_system/compilation_environments.md b/docs/developer_guide/tutorials/build_system/compilation_environments.md index 9b5ab53..2ce89b7 100644 --- a/docs/developer_guide/tutorials/build_system/compilation_environments.md +++ b/docs/developer_guide/tutorials/build_system/compilation_environments.md @@ -97,10 +97,58 @@ installed. ### Prerequisites +First, make sure your version of Windows 10 is new enough. Press **Win** + **R** to open the *Run* window and type in `winver` to check your Windows version and build number. The version should be **1903** or higher, the build number **18362** or higher. + +#### Enabling Windows Features + +![Enable Virtual Machine Platform and Windows Subsystem for Linux.](/assets/images/WSL2_Windows_features.png) + +Some addition Windows features need to be enabled. Open the Windows Features window either by searching for "Windows Features" in the Start Menu, or by opening **Settings** -> **Apps & features** -> **Optional features** -> **More Windows features**. There ensure that both **Virtual Machine Platform** and **Windows Subsystem for Linux** are enabled. After pressing OK to confirm, Windows will ask you to reboot your computer to complete installation. + +#### Download the Linux kernel update package + +An additional update is required to run WSL2. Download and install the following package from Microsoft: + +- [WSL2 Linux kernel update package for x64 machines][4] +#### Set WSL2 as your default version (optional) +You can run the following command in PowerShell to make WSL2 the default version. New installations of Linux distributions on Windows will then automatically use WSL2. Otherwise they will use WSL version 1 by default. + +``` +wsl --set-default-version 2 +``` + +#### Install Ubuntu using the Microsoft Store + +Now that WSL2 is ready to be used you can download a Linux distribution from the Microsoft Store. For this guide, it is recommended to install [Ubuntu 20.04 LTS][5]. After installing, Ubuntu can be started by either selecting it from the Start Menu or typing `ubuntu2004` on the command prompt. The first time you run Ubuntu you will be asked to create a new user account with a username and password. These do not have to be the same as your Windows account. + +If you've enabled WSL2 as the default version in the previous step, Ubuntu will be automatically configured to use that version. If you haven't set WSL2 as default, or if you've installed Ubuntu before setting WSL2 as default, it's possible to manually change the version for this distro. First, open a PowerShell window and type the following command to list all installed Linux distributions: + +``` +wsl --list --verbose +``` + +Check the name of the distribution you want to upgrade and run: + +``` +wsl --set-version +``` + +With `` set to `2` to use WSL2. You can use the same command with version number `1` to return to WSL 1. + +#### WSL2 is now ready to be used + +Your Ubuntu installation is now ready to be used. Starting Ubuntu from the Start Menu will open a terminal with a Bash prompt. Everything you type here will be executed in Ubuntu. You can run and install applications within Ubuntu as you would on a complete installation or virtual machine. + +Follow the instructions in the **Build on a Physical/Virtual Machine** section to install the requirements needed to build FunKey-OS. + +You can access the Windows filesystem via `/mnt`; the C: drive is mounted as `/mnt/c`. From Windows you can access the Linux filesystem via the special path `\\wsl$`. Note that you can only access the files there when Ubuntu is running on WSL2. + [1]: https://www.docker.com/ -[2]:https://www.virtualbox.org/ +[2]: https://www.virtualbox.org/ [3]: https://docs.microsoft.com/en-us/windows/wsl/install-win10 +[4]: https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi +[5]: https://www.microsoft.com/store/productId/9N6SVWS3RX71 --8<-- includes/glossary.md