Developer Guide

  • 2022.3
  • 10/25/2022
  • Public Content

EI for AMR Container on a Virtual Machine

Run the Edge Insights for Autonomous Mobile Robots container on a KVM guest.

Run the Sample Application

  1. Verify that your CPU supports hardware virtualization using the following command. Output greater than zero indicates support is present:
    egrep -c '(vmx|svm)' /proc/cpuinfo
    If the output is not greater than zero, reboot your server. Modify BIOS Settings > Security features > Enable Virtualization Technology.
  2. Verify that Kernel-based Virtual Machine (KVM) acceleration can be used with the commands:
    sudo apt install -y cpu-checker kvm-ok INFO: /dev/kvm exists KVM acceleration can be used
  3. Install KVM in Ubuntu* 20.04 using the following commands:
    1. If the PAM configuration page is displayed when installing the following packages, click
    2. If
      Configuring openssh-server
      page is displayed when installing the following packages, select
      keep the local version currently installed
    sudo apt update sudo apt install -y qemu qemu-kvm libvirt-daemon libvirt-daemon-system libvirt-clients bridge-utils virt-manager virtinst openssh-server net-tools sudo adduser $USER libvirt sudo adduser $USER kvm # Check if libvirtd is active sudo systemctl status libvirtd # If libvirtd is not active use sudo systemctl enable --now libvirtd
  4. Reboot the host:
    sudo reboot -fn
    After the reboot, verify that libvirtd is active.
    sudo systemctl status libvirtd # If libvirtd is not active use sudo systemctl enable --now libvirtd
  5. Create the KVM bridge:
    1. Create a new bridge XML file:
      vim br_kvm.xml
    2. Add bridge details to
      <network> <name>br_kvm</name> <forward mode='nat'> <nat> <port start='1024' end='65535'/> </nat> </forward> <bridge name='br10' stp='on' delay='0'/> <ip address='' netmask=''> <dhcp> <range start='' end=''/> </dhcp> </ip> </network>
    3. Define and start
      network using the following commands:
      sudo virsh net-define br_kvm.xml sudo virsh net-start br_kvm sudo virsh net-autostart br_kvm # Check if autostart is enabled for br_kvm sudo virsh net-list --all Name State Autostart Persistent br_kvm active yes yes default active yes yes # Confirm bridge creation and IP address ip addr show dev br10 13: br10: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc noqueue state UP group default qlen 1000 link/ether 52:54:00:21:ff:4f brd ff:ff:ff:ff:ff:ff inet brd scope global br10 valid_lft forever preferred_lft forever
  6. Create KVM with Ubuntu 20.04.
    1. Download the Ubuntu 20.04 desktop .iso image from
    2. Open virt-manager. Click on
      New VM >
      Local install media (ISO image or CDROM)
      . Choose the .iso file downloaded and choose the operating system to be installed.
    3. Select the CPUs and Memory. For example: Memory: 4096, CPUs: 2
    4. Add minimum 100 GB for the virtual machine storage.
    5. Select the Virtual Network created above for Network Preferences.
    6. Click
      and start the Ubuntu 20.04 installation.
  7. After Ubuntu Installation, add the Intel® RealSense™ camera to the VM by clicking on
    Show virtual hardware details
    in Virt Manager >
    Add Hardware
    Select USB Host Device
    and Select the RealSense Camera.
  8. Install Edge Insights for Autonomous Mobile Robots using the steps in Get Started Guide for Robots.
    If your system is behind a proxy, you must configure the proxy settings.
  9. Run the Intel® RealSense™ ROS 2 sample application inside the Docker* container using the steps from Intel® RealSense™ ROS 2 Sample Application.


If the following error is encountered:
Error connecting to graphical console: Error opening Spice console, SpiceClientGtk missing
with the command:
sudo apt-get install -y gir1.2-spiceclientgtk-3.0
For general robot issues, go to: Troubleshooting for Robot Tutorials.

Product and Performance Information


Performance varies by use, configuration and other factors. Learn more at