Get Started Guide

  • 2022.3
  • 10/23/2022
  • Public Content

Set Up Windows* Subsystem for Linux* (Optional)

You can use the Windows* Subsystem for Linux* (WSL) if you don’t want to install a standalone Ubuntu* machine.
Prerequisites
  • Minimum Windows 10 is required.
    To check your windows version, press the
    Windows logo key + R
    . Type
    winver
    and select
    OK
    .
  • You must have at least 40 GB storage available.

Procedure

  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.
    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.
To delete the distro, use the command:
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

Product and Performance Information

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.