This test case imports a WSL image from a rootfs and runs it.
It requires a working Microsoft Windows 10 or higher installation with WSL2 enabled. Installing Windows and enabling WSL 2 is outside of the scope of this test case.
To run this test you must download the image from http://cloud-images.ubuntu.com/
For example for latest focal image download: http://cloud-images.ubuntu.com/focal/current/focal-server-cloudimg-amd64-wsl.rootfs.tar.gz
Make sure to download the image from the download link associated to this test case.
Open Windows Terminal or PowerShell and execute the test case below:
- Import the image in WSL
> wsl.exe --import <name of the distro> <location to unpack rootfs> <rootfs> [--version <version of WSL>]
For example:
> wsl.exe --import Ubuntu20.04.3 .\wsl\ .\Downloads\focal-server-cloudimg-amd64-wsl.rootfs.tar.gz --version 2
- Verify that the image has been imported by running the following command:
> wsl.exe --list --all --verbose
NAME STATE VERSION
*Ubuntu Running 2
Ubuntu20.04.3 Stopped 2
Ubuntu-Preview Stopped 2
Ubuntu-20.04 Stopped 2
TestUbuntuWSL Stopped 2
- Check the the name used in previous command appears in the list.
- Launch the newly installed application
> wsl -d Ubuntu20.04.3
- Verify that you're inside the WSL instance and running the right distribution. For example run:
$ lsb_release -a
No LSB modules are available.
Distributor ID: Ubuntu
Description: Ubuntu 20.04.3 LTS
Release: 20.04
Codename: focal
- Wait for cloud-init to finish its job, if it's present in the system (cloud-init is only present in recent releases):
$ which cloud-init && cloud-init status --wait
/usr/bin/cloud-init
status: disabled
- Since the image has been installed directly and not with the distro launcher, you're logged in a root by default and have to create a first user manually. But first, verify that there is no other user already created by default:
$ id 1000
id: '1000': no such user: No such file or directory
$ id ubuntu
id: 'ubuntu': no such user
$ egrep ':100[0-9]:' /etc/passwd # should output nothing.
- Create a new user named 'ubuntu':
$ adduser ubuntu
Adding user `ubuntu' ...
Adding new group `ubuntu' (1000) ...
Adding new user `ubuntu' (1000) with group `ubuntu' ...
Creating home directory `/home/ubuntu' ...
Copying files from `/etc/skel' ...
New password:
Retype new password:
passwd: password updated successfully
Changing the user information for ubuntu
Enter the new value, or press ENTER for the default
Full Name []:
Room Number []:
Work Phone []:
Home Phone []:
Other []:
Is the information correct? [Y/n]
- Add the newly created user to the sudo group:
$ usermod -aG sudo ubuntu
- Verify that you can switch to the new user
$ su ubuntu
To run a command as administrator (user "root"), use "sudo <command>".
See "man sudo_root" for details.
$ whoami
ubuntu
- Exit WSL. Type CTRL+D twice until you're back to the PowerShell prompt.
- Start a WSL session directly with the newly created user.
> wsl -d Ubuntu20.04.3 -u ubuntu
To run a command as administrator (user "root"), use "sudo <command>".
See "man sudo_root" for details.
Welcome to Ubuntu 20.04.3 LTS (GNU/Linux 5.10.43.3-microsoft-standard-WSL2 x86_64)
* Documentation: https://help.ubuntu.com
* Management: https://landscape.canonical.com
* Support: https://ubuntu.com/advantage
System information as of Mon Aug 23 03:31:35 PDT 2021
System load: 0.16 Processes: 8
Usage of /: 0.5% of 250.98GB Users logged in: 0
Memory usage: 6% IPv4 address for eth0: 172.30.131.4
Swap usage: 0%
1 update can be applied immediately.
To see these additional updates run: apt list --upgradable
This message is shown once a day. To disable it please create the
/home/ubuntu/.hushlogin file.
ubuntu@WSL:/mnt/c/Users/ubuntu$
- Run a command as root with sudo, for instance
$ sudo apt update
- Verify that the command ends successfully
- Apply any update
$ sudo apt full-upgrade
- Verify that the command ends successfully and that any packge that must be upgraded has been upgraded
- Install a package
$ sudo apt install hello
- Verify that the package has been successfully installed and the application can run
-
$ hello
Hello, world!
- Install and run graphical applications
$ sudo apt install x11-apps gtk-4-examples # gtk-3-examples for focal
[...]
- Start one of the graphical application from the x11-apps package, like xcalc for example:
$ xcalc
(Wait a moment until the application starts and is displayed)
- Start the GTK demo application with the default backend:
$ gtk4-demo
(Wait a moment until the application starts and is displayed)
- Start the GTK demo application with the Wayland backend:
$ GDK_BACKEND=wayland gtk4-demo
(Wait a moment until the application starts and is displayed)
- Exit WSL
logout
- Check that your back to the PowerShell prompt
- Unregister the distro instance
> wsl.exe --unregister Ubuntu20.04.3
- The application is no longer listed
> wsl --list
Windows Subsystem for Linux Distributions:
Ubuntu (Default)
Ubuntu-Preview
Ubuntu-20.04
TestUbuntuWSL
- And the directory is empty
> ls .\wsl
>
If all actions produce the expected results listed, please submit a 'passed' result.
If an action fails, or produces an unexpected result, please submit a 'failed' result and file a bug. Please be sure to include the bug number when you submit your result.
