Install

https://github.com/microsoft/WSL/releases

Export / Import

PS>wsl -l  #list images
PS>wsl --export <image> <file.tar> <<-- use Ubuntu as template image
PS>wsl --import <new-image> <target directory> <file-name.tar>

Folder Structure : <WSL-path>/<project-name>/<image-name> ex. E:/VMs/WSL/EDUDATE.ACADEMY/edudate-ops

ON LEOPARD:

Images archived on: D:\VMs\WSL\backup <- synced on GoogleDrive

WSL disks stored locally on: D:\WSLs\<project-name>

Add user

Note , WSL command is adduser not useradd (typical ubuntu)

# adduser <new-user-name>
#addgroup <new-group-name>

Change default uid

Login as root

PS> wsl -d <image> -u root

((If taken from starfish-snapshot backups))

#./change-wsl-owner <new-user>

change-wsl-owner is script that automate below manual ops

Manual

#vi /etc/wsl.conf
[user]
default=<new-user>
#groupmod -n <new-group> <old-group>
#usermod -l <new-user> -d /home/<new-user> <old-user>
ex. usermod -l edudateops -d /home/edudateops ubuntu
#mv /home/<old-user> /home/<new-user>
#exit
PS>wsl --shutdown
PS>wsl -d <new-wsl-distribution>
$echo "cd ~" >> .bashrc
$sudo apt update
$sudo apt upgrade -y
$git config --global user.name "Edudater"
$git config --global user.email "[email protected]"

Upgrade 20.04 to 22.04

#apt -y update 
# apt full-upgrade
# restart Ubuntu
# do-release-upgrade
$cat /etc/os-release

Advanced Settings

wsl.conf & .wslconfig
https://docs.microsoft.com/en-us/windows/wsl/wsl-config

IP Address

#ip addr  | grep 'global eth0'
# chmod +x /usr/bin/get-ip-addr

Automatic WSL services startup

https://www.how2shout.com/linux/how-to-start-wsl-services-automatically-on-ubuntu-with-windows-10-startup/

Packages

#dpkg -l|grep php |teepackages.txt
#dpkg --remove --force-remove-reinstreq awsvpnclient

Enable/Disable service

# systemctl disable nginx

WSL2 Problems

1. Download latest WSL from Install section above
2. Networking through NAT is unreliable, Issues still reported from Microsoft
3. Can’t install php8.2 from binaries, need to compile
4. use dockers ok

Available Disk space

https://learn.microsoft.com/en-us/windows/wsl/disk-space

PS>wsl --system -d <distribution-name> 
#df -h /mnt/wslg/distro

Compact vdisk:

PS>diskpart
DISKPART>select vdisk file="path\to\ext4.vhdx"
DISKPART>compact vdisk
DISKPART>detail vdisk
DISKPART>expand vdisk maximum=<sizeInMegaBytes>
DISKPART>exit

Expanding

# mount -t devtmpfs none /dev
# mount | grep ext4
# apt install resize2fs
# resize2fs /dev/sdX <sizeInMegabytes>M
# resize2fs 1.44.1 (24-Mar-2021)

Filesystem at /dev/sdb is mounted on /; on-line resizing required
old_desc_blocks = 32, new_desc_blocks = 38

The filesystem on /dev/sdb is now 78643200 (4k) blocks long.

Set-ExecutionPolicy -ExecutionPolicy ByPass  -Scope CurrentUser

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

PS>VMs\WSL\scripts\network.ps1
If (-NOT ([Security.Principal.WindowsPrincipal][Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole] "Administrator")) {
$arguments = "& '" + $myinvocation.mycommand.definition + "'"
Start-Process powershell -Verb runAs -ArgumentList $arguments
Break
}

$remoteport = wsl get-ip-addr
$found = $remoteport -match '\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}';

if ($found) {
$remoteport = $matches[0];
}
else {
Write-Output "IP address could not be found";
exit;
}

$ports = @(5001, 19000, 19001);

for ($i = 0; $i -lt $ports.length; $i++) {
$port = $ports[$i];
Invoke-Expression "netsh interface portproxy delete v4tov4 listenport=$port";
Invoke-Expression "netsh advfirewall firewall delete rule name=$port";

Invoke-Expression "netsh interface portproxy add v4tov4 listenport=$port connectport=$port connectaddress=$remoteport";
Invoke-Expression "netsh advfirewall firewall add rule name=$port dir=in action=allow protocol=TCP localport=$port";
}

PS>Invoke-Expression "netsh interface portproxy show v4tov4";