Procedure

• If your Windows 10 version is older than 2004, you must do the first 5 steps in this Microsoft* guide before continuing:

  https://docs.microsoft.com/en-us/windows/wsl/install-manual

  Then continue with the steps below.

• If your version is 2004 (Build 19041) or higher, perform the steps below.

1. Open Windows PowerShell*.

2. Run the following command to install the Ubuntu 20.04 distribution:

   wsl --install -d Ubuntu-20.04

   As a result, Ubuntu 20.04 will start and in a few minutes a pop-up window will ask you for username and password. After the install ends, the pop-up window is a Ubuntu 20.04 terminal.

   You must follow the instructions in the order shown to complete the installation successfully.

3. If your machine is behind a proxy network, make sure you set proxies for apt and for the system. If your machine is not behind a proxy, you can skip this step.

   NOTE:

   Replace the http/https links and ports in the commands presented below with your proxies links and ports.

   1. Set up apt proxies:

      sudo touch /etc/apt/apt.conf.d/proxy.conf
      sudo echo "Acquire::http::proxy \"http://http_proxy_link:http_proxy_port/\";" | sudo tee -a /etc/apt/apt.conf.d/proxy.conf
      sudo echo "Acquire::https::proxy \"http://https_proxy_link:https_proxy_port/\";" | sudo tee -a /etc/apt/apt.conf.d/proxy.conf

   2. Add your proxy settings to ~/.bashrc and to /etc/environment as well for http, https and no_proxy.

      http_proxy=http://<http_proxy_link>:<http_proxy_port>
      https_proxy=http://<https_proxy_link>:<https_proxy_port>
      no_proxy=localhost,127.0.0.1/8, hostIp

   3. Reboot from the Windows PowerShell by using the following steps:

      1. Open another Windows PowerShell as administrator and run the following command:

         Get-Service LxssManager | Restart-Service

      2. In the user Windows PowerShell, run the following command to relaunch Ubuntu:

         wsl -d Ubuntu-20.04

      3. At this point, Windows PowerShell will give access to Ubuntu and the prompt should look like this:

         user@<hostname>:/mnt/c/Users/User

4. Update your Ubuntu distribution with the command:

   sudo apt-get update && sudo apt-get upgrade -y

5. Install git and apply systemctl required changes:

   sudo apt-get install git
   git clone https://github.com/DamionGans/ubuntu-wsl2-systemd-script
   cd ubuntu-wsl2-systemd-script
   sudo ./ubuntu-wsl2-systemd-script.sh

6. Install terminator to have it as default terminal:

   sudo apt-get install terminator

7. Set up Windows RDP in order to cover the Reference Implementation prerequisites where you need GUI.

   1. Install xfce with the command:

      sudo apt-get install -y xfce4 xfce4-goodies

   2. Install xrdp with the command:

      sudo apt-get install -y xrdp

   3. Configure xrdp with the following commands:

      1. Comment the last two lines, add startxfce4 at the end of the following file, and save:

         sudo nano /etc/xrdp/startwm.sh

      2. Copy the original ini file as bak format:

         sudo cp /etc/xrdp/xrdp.ini /etc/xrdp/xrdp.ini.bak

      3. Change the xrdp port to not have a conflict with Windows OS port and complete configuration by running the following commands:

         sudo sed -i 's/3389/3390/g' /etc/xrdp/xrdp.ini
         sudo sed -i 's/max_bpp=32/#max_bpp=32\nmax_bpp=128/g' /etc/xrdp/xrdp.ini
         sudo sed -i 's/xserverbpp=24/#xserverbpp=24\nxserverbpp=128/g' /etc/xrdp/xrdp.ini
         echo xfce4-session > ~/.xsession

      4. Enable xrdp

         sudo systemctl start xrdp
         sudo /etc/init.d/dbus start
         sudo /etc/init.d/xrdp start

8. Install missing component with the command:

   sudo apt-get install -y zenity

9. Open Remote Desktop Connection Windows application and type localhost:3390 for “Computer” and connect. Login with the username and password from step 1.

10. After login, click on Use Default Config.

11. Set up for Reference Implementations.

    1. Run source /etc/environment if you are behind a proxy.

    2. Install your preferred browser. This example uses Firefox*.

       sudo apt-get install -y firefox

    3. Create a Docker group and add your user to the group with the commands:

       sudo groupadd docker
       sudo usermod -aG docker $USER

    4. Log out and reconnect via the Remote Desktop Connection Windows application.

12. Open a terminal and start a web browser in the background. This example uses Firefox.

    1. Enter the command:

       firefox &

    2. Open the <RI link>.

    3. Download the recommended archive.

    4. In the terminal, run the command:

       cp <archive> ~/

    5. Unzip the archive and install.

wsl --unregister Ubuntu-20.04

Known Limitations

1. If you receive the Docker error toomanyrequests, you may need to create an account for Docker Hub. After that, login using your credentials:

   sudo docker login

2. GPU and VPU are not available in WSL. The RI can be launched only on CPU.

3. Disable screen lock on WSL to avoid lockup:

   gsettings set org.gnome.desktop.screensaver lock-enabled false