Documentation

  • 2022.1
  • 03/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 18.04 distribution:
    wsl --install -d Ubuntu-18.04
    As a result, Ubuntu 18.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 Ubuntu18.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
      as well for http, https and no_proxy.
      export http_proxy=http://<http_proxy_link>:<http_proxy_port> export https_proxy=http://<https_proxy_link>:<https_proxy_port> export 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-18.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. 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
        dbus
        and start both
        dbus
        and
        xrdp
        services with the commands:
        sudo systemctl enable dbus sudo /etc/init.d/dbus start sudo /etc/init.d/xrdp start
  6. Install missing component with the command:
    sudo apt-get install –y zenity
  7. Bypass timedatectl to allow EII core Docker images to be deployed:
    sudo rm /usr/bin/timedatectl sudo nano /usr/bin/timedatectl
    Add the content:
    #!/bin/bash exit 0
  8. Enter the command:
    sudo chmod 777 /usr/bin/timedatectl
  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. 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-18.04

Known Limitations

  1. WSL distros are based on init.d not systemd, so the Docker daemon is not started after installation. The first installation will fail. The workaround is to start the Docker daemon first, before retrying the installation:
    sudo /etc/init.d/docker start
  2. After restarting the WSL distro, you have to manually start
    dbus
    ,
    xrdp
    , and Docker using the commands:
    sudo /etc/init.d/dbus start sudo /etc/init.d/xrdp start sudo /etc/init.d/docker start
  3. 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
  4. If Visualizer does not start, try to restart the
    dbus
    and reconnect via
    rdp
    with WSL Ubuntu virtual machine:
    sudo /etc/init.d/dbus restart
  5. GPU and VPU are not available in WSL. The RI can be launched only on CPU.

Product and Performance Information

1

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