This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
other:win10wsl [2022/08/29 14:36] jypeter [Upgrading WSL 1 to WSL 2] Improved |
other:win10wsl [2022/08/31 09:12] jypeter WSL 1 vs 2, and note about which terminals to use |
||
---|---|---|---|
Line 3: | Line 3: | ||
[[other:index#windows_10_notes|Other Windows 10 related notes]] | [[other:index#windows_10_notes|Other Windows 10 related notes]] | ||
- | <note warning> | + | <WRAP center round important 60%> |
* What is described on this page was tested with [[https://docs.microsoft.com/en-us/windows/wsl/compare-versions#whats-new-in-wsl-2|WSL 2]].\\ **WSL 2** is available in [[https://docs.microsoft.com/en-us/windows/wsl/install-manual#step-2---check-requirements-for-running-wsl-2|Windows 11 or Windows 10, Version 1903, Build 18362 or later]] | * What is described on this page was tested with [[https://docs.microsoft.com/en-us/windows/wsl/compare-versions#whats-new-in-wsl-2|WSL 2]].\\ **WSL 2** is available in [[https://docs.microsoft.com/en-us/windows/wsl/install-manual#step-2---check-requirements-for-running-wsl-2|Windows 11 or Windows 10, Version 1903, Build 18362 or later]] | ||
- | * You can also check JYP's [[other:win10_wsl_1|original WSL 1 instructions]] | + | * You can also check JYP's [[other:win10_wsl_1|original WSL 1 instructions]] |
+ | * ...but even **if you need WSL 1, you should use this page for installing WSL, and then switch to WSL 1** with [[https://docs.microsoft.com/en-us/windows/wsl/basic-commands#set-default-wsl-version|--set-default-version]] or [[https://docs.microsoft.com/en-us/windows/wsl/basic-commands#set-wsl-version-to-1-or-2|--set-version]] | ||
* The user can choose to install Linux using **WSL 1 or WSL 2** | * The user can choose to install Linux using **WSL 1 or WSL 2** | ||
* **WSL 2 should be your default choice** | * **WSL 2 should be your default choice** | ||
* If you have doubts, check the [[https://docs.microsoft.com/en-us/windows/wsl/compare-versions|differences between WSL1 and WSL2]] and read [[https://docs.microsoft.com/en-us/windows/wsl/compare-versions#exceptions-for-using-wsl-1-rather-than-wsl-2|Exceptions for using WSL 1 rather than WSL 2]] before choosing | * If you have doubts, check the [[https://docs.microsoft.com/en-us/windows/wsl/compare-versions|differences between WSL1 and WSL2]] and read [[https://docs.microsoft.com/en-us/windows/wsl/compare-versions#exceptions-for-using-wsl-1-rather-than-wsl-2|Exceptions for using WSL 1 rather than WSL 2]] before choosing | ||
- | </note> | + | </WRAP> |
+ | |||
+ | |||
+ | <WRAP center round tip 60%> | ||
+ | The commands on this page have to be typed: | ||
+ | * either in **Windows PowerShell terminals** | ||
+ | * or in **bash terminals running in WSL** | ||
+ | It should be clear enough which type of terminal you have to use | ||
+ | </WRAP> | ||
Line 35: | Line 45: | ||
Once you have verified that your Windows is recent enough, you should also: | Once you have verified that your Windows is recent enough, you should also: | ||
- | * Install the [[other:win10apps#windows_terminal|Windows terminal]], because it will be one of the ways to open ''Ubuntu'' terminals, once ''Ubuntu'' is installed | + | * Your should really **install the [[other:win10apps#windows_terminal|Windows terminal]]**, because it will be one of useful the ways to open ''Ubuntu'' terminals, once ''Ubuntu'' is installed |
- | * Know how to use copy-paste in a Powershell FIXME | + | * **Know how to use copy-paste** in: |
- | * It will be useful to be able to [[other:win10config#displaying_hidden_folders_and_files_and_the_files_extension|see hidden folders and files]] | + | * a //Windows Terminal//: [[https://docs.microsoft.com/en-us/windows/terminal/selection|Selecting text in Windows Terminal]] |
- | * Have at least some basic knowledge of Linux... | + | * an old ''cmd'' command prompt or a //PowerShell//: FIXME |
+ | * It will be useful to **be able to [[other:win10config#displaying_hidden_folders_and_files_and_the_files_extension|see hidden folders and files]]** | ||
+ | * **Have some basic knowledge of Linux**... | ||
* Get some [[other:newppl:starting#useful_documentation_for_beginners|basic Linux documentation]] if required | * Get some [[other:newppl:starting#useful_documentation_for_beginners|basic Linux documentation]] if required | ||
==== Computer CPU and memory ==== | ==== Computer CPU and memory ==== | ||
Line 127: | Line 139: | ||
* Disk size after upgrading to //Ubuntu 20.04.4 LTS// with ''sudo apt update && sudo apt upgrade''\\ ''-rwxrwxrwx 1 root root 2.6G Aug 24 15:24 /mnt/c/Users/jypeter/AppData/Local/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/ext4.vhdx'' | * Disk size after upgrading to //Ubuntu 20.04.4 LTS// with ''sudo apt update && sudo apt upgrade''\\ ''-rwxrwxrwx 1 root root 2.6G Aug 24 15:24 /mnt/c/Users/jypeter/AppData/Local/Packages/CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc/LocalState/ext4.vhdx'' | ||
+ | * Size of the [[other:win10wsl#creating_a_backup_of_the_linux_running_in_wsl|backup tar file]] of this installation, generated with ''%%wsl --export%%'': ~1.4 Gb | ||
==== Hyper-V requirements ==== | ==== Hyper-V requirements ==== | ||
Line 352: | Line 365: | ||
===== After the base installation ===== | ===== After the base installation ===== | ||
- | Once you have completed the base installation steps, you'll get a Ubuntu machine, with a //root// and user account (pre-configured to use ''sudo'' for commands that need root access) and lots of pre-installed applications (but no graphics). | + | After completing the base installation steps, you get a //Ubuntu// machine with: |
+ | * a //root// and //user// account | ||
+ | * the //user// account is pre-configured to use ''sudo'' for commands that need root access | ||
+ | * pre-installed base Linux applications | ||
+ | * **no** graphics | ||
+ | * enough to play a bit with a Linux computer and test that the installation is working, but not enough to do some real work | ||
==== Opening a terminal ==== | ==== Opening a terminal ==== | ||
Line 482: | Line 500: | ||
==== Ubuntu packages installed ==== | ==== Ubuntu packages installed ==== | ||
- | <code>$ dpkg --list | + | <code>$ dpkg --list | head -n 10 |
Desired=Unknown/Install/Remove/Purge/Hold | Desired=Unknown/Install/Remove/Purge/Hold | ||
| Status=Not/Inst/Conf-files/Unpacked/halF-conf/Half-inst/trig-aWait/Trig-pend | | Status=Not/Inst/Conf-files/Unpacked/halF-conf/Half-inst/trig-aWait/Trig-pend | ||
|/ Err?=(none)/Reinst-required (Status,Err: uppercase=bad) | |/ Err?=(none)/Reinst-required (Status,Err: uppercase=bad) | ||
- | ||/ Name Version Architecture Description | + | ||/ Name Version Architecture Description |
- | +++-=====================-===============-===============-================================================ | + | +++-==============================-=================================-============-=============================================================================== |
- | ii accountsservice 0.6.45-1ubuntu1 amd64 query and manipulate user account information | + | ii accountsservice 0.6.55-0ubuntu12~20.04.5 amd64 query and manipulate user account information |
- | ii acl 2.2.52-3build1 amd64 Access control list utilities | + | ii adduser 3.118ubuntu2 all add and remove users and groups |
- | ii acpid 1:2.0.28-1ubunt amd64 Advanced Configuration and Power Interface event | + | ii alsa-topology-conf 1.2.2-1 all ALSA topology configuration files |
- | ii adduser 3.116ubuntu1 all add and remove users and groups | + | ii alsa-ucm-conf 1.2.2-1ubuntu0.13 all ALSA Use Case Manager configuration files |
- | + | ii apparmor 2.13.3-7ubuntu5.1 amd64 user-space parser utility for AppArmor | |
- | [...] | + | |
- | ii xterm 330-1ubuntu2 amd64 X terminal emulator | + | |
- | ii xxd 2:8.0.1453-1ubu amd64 tool to make (or reverse) a hex dump | + | |
- | ii xz-utils 5.2.2-1.3 amd64 XZ-format compression utilities | + | |
- | ii zerofree 1.0.4-1 amd64 zero free blocks from ext2, ext3 and ext4 file-s | + | |
- | ii zlib1g:amd64 1:1.2.11.dfsg-0 amd64 compression library - runtime | + | |
- | $ dpkg --list > /mnt/c/Scratch/jyp/pkg_initial_201601.txt | + | $ dpkg --list > /mnt/c/Scratch/jypeter/Ubuntu_Installed_List_`date +"%y-%m-%d"`.txt |
- | $ wc -l /mnt/c/Scratch/jyp/pkg_initial_201601.txt | + | $ wc -l /mnt/c/Scratch/jypeter/Ubuntu_Installed_List_*.txt |
- | 628 /mnt/c/Scratch/jypeter/pkg_initial_201601.txt</code> | + | 642 /mnt/c/Scratch/jypeter/Ubuntu_Installed_List_22-08-29.txt</code> |
- | Full (example) list of installed packages: {{:other:pkg_initial_201601.txt|pkg_initial_201601.txt}} | + | Full (example) list of installed packages: {{ :other:ubuntu_installed_list_22-08-29.txt |}} |
==== Update ubuntu ==== | ==== Update ubuntu ==== | ||
Line 995: | Line 1007: | ||
> wsl --list --verbose | > wsl --list --verbose | ||
NAME STATE VERSION | NAME STATE VERSION | ||
- | * Ubuntu Running 1</code> | + | * Ubuntu Running 2</code> |
* [[other:win10wsl#rebooting_wsl|Stop WSL+Linux]] | * [[other:win10wsl#rebooting_wsl|Stop WSL+Linux]] | ||
* <code>> wsl --list --verbose | * <code>> wsl --list --verbose | ||
NAME STATE VERSION | NAME STATE VERSION | ||
- | * Ubuntu Running 1 | + | * Ubuntu Running 2 |
> wsl --shutdown | > wsl --shutdown | ||
- | > wsl --list --verbose | + | > wsl -l -v |
NAME STATE VERSION | NAME STATE VERSION | ||
- | * Ubuntu Stopped 1</code> | + | * Ubuntu Stopped 21</code> |
* Export the current Linux to a //tar// file: | * Export the current Linux to a //tar// file: | ||
+ | * FIXME ''wsl --export Ubuntu C:\Scratch\jypeter\WSL\WSL_Ubuntu_20.04.4_LTS_stdu_22-08-29.tar'' | ||
+ | * 1.4 Gb | ||
* <code> > wsl --export Ubuntu C:\Scratch\<your_login>\<your_login>_ubuntu-<ubuntu_version>-full_<some_date>.tar</code> | * <code> > wsl --export Ubuntu C:\Scratch\<your_login>\<your_login>_ubuntu-<ubuntu_version>-full_<some_date>.tar</code> | ||
* You can optionally open a new terminal (this will start again WSL+Ubuntu) to get some information about the created file (size and number of saved files/directories), and compress it in order to save some disk space | * You can optionally open a new terminal (this will start again WSL+Ubuntu) to get some information about the created file (size and number of saved files/directories), and compress it in order to save some disk space | ||
Line 1044: | Line 1058: | ||
* Can we restore (//clone//) a backed up Linux distribution on another Windows 10 computer for another user? | * Can we restore (//clone//) a backed up Linux distribution on another Windows 10 computer for another user? | ||
* if the default user (and its password) has to be changed, you probably have to follow the steps to [[https://docs.microsoft.com/en-us/windows/wsl/user-support#for-fall-creators-update-and-later|reset the Linux password]] and find a way to create a new account when the ''root'' password is activated | * if the default user (and its password) has to be changed, you probably have to follow the steps to [[https://docs.microsoft.com/en-us/windows/wsl/user-support#for-fall-creators-update-and-later|reset the Linux password]] and find a way to create a new account when the ''root'' password is activated | ||
+ | |||
+ | |||
+ | ===== Advanced usage ===== | ||
+ | |||
+ | ==== Creating a backup of a Linux installation ==== | ||
+ | |||
+ | |||
+ | ==== Restoring or relocating a Linux installation ==== | ||
+ | |||
+ | When we have a backup in a tar file, we can restore it to the default location (Check ?? FIXME), or specify where we want to restore it. This is a way of moving (relocating) an installation to another disk or partition than the default location ''C:\'' | ||
==== Uninstalling WSL ==== | ==== Uninstalling WSL ==== | ||
- | Not too sure about this part... | + | Before starting, you may want to make a backup of whatever you had in your Ubuntu home directory, and all the files and settings that are not in the ''/mnt'' directories |
+ | |||
+ | === Removing a specific Linux installation === | ||
+ | |||
+ | This process is called //unregistering// (based on [[https://docs.microsoft.com/en-us/windows/wsl/basic-commands#unregister-or-uninstall-a-linux-distribution|Unregister or uninstall a Linux distribution]]) | ||
+ | |||
+ | You just need to get the list of the currently installed Linux distributions, stop them and remove/unregister a specific distribution name | ||
+ | |||
+ | <code>> wsl -l -v | ||
+ | NAME STATE VERSION | ||
+ | * Ubuntu Stopped 2 | ||
+ | Ubuntu_custom Running 2 | ||
+ | |||
+ | > wsl --terminate Ubuntu_custom | ||
+ | |||
+ | > wsl -l -v | ||
+ | NAME STATE VERSION | ||
+ | * Ubuntu Stopped 2 | ||
+ | Ubuntu_custom Stopped 2 | ||
+ | |||
+ | > wsl --unregister Ubuntu_custom | ||
+ | Désinscription... | ||
+ | |||
+ | > wsl -l -v | ||
+ | NAME STATE VERSION | ||
+ | * Ubuntu Stopped 2</code> | ||
+ | |||
+ | |||
+ | === Removing WSL === | ||
+ | |||
+ | ''wsl'' is a part of the Windows system and probably can't be removed. | ||
+ | |||
+ | Anyway, when all existing Linux distributions are uninstalled, there should not be any big ''.vhdx'' files remaining (i.e. //no extra disk space used//), and there will not be any Linux processes running (i.e. //no extra CPU used//). | ||
- | * Make a backup of whatever you had in your Ubuntu home directory, and all the files and settings that are not in the ''/mnt'' directories | ||
- | * Find how to unregister Ubuntu on the [[https://docs.microsoft.com/en-us/windows/wsl/wsl-config|Manage and configure Windows Subsystem for Linux]] page | ||
- | * and then disable WSL??? | ||
===== Miscellaneous ===== | ===== Miscellaneous ===== |