• 2021.2
  • 06/30/2021
  • Public Content

Run the
Edge Insights for Autonomous Mobile Robots
Container in KVM VM Guest

Run the Sample Application

  1. This tutorial uses spice-0.14.2 and spice-protocol-0.14.0 for QEMU emulator version 4.2.1.
    Install spice-server and spice-protocol using the steps here: Install Spice-server
  2. Check if 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, then reboot your server. Modify BIOS Settings > Security features > Enable Virtualization Technology
  3. Check if 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
  4. Install KVM in Ubuntu* 20.04 using the following commands:
    sudo apt update sudo apt install -y qemu qemu-kvm libvirt-daemon libvirt-daemon-system libvirt-clients bridge-utils virt-manager virtinst 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
  5. Create 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 br_kvm 19: br_kvm: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc noqueue state UP group default qlen 1000 link/ether 52:54:00:30:ce:04 brd ff:ff:ff:ff:ff:ff inet brd scope global br_kvm valid_lft forever preferred_lft forever
  6. Create KVM VM with Ubuntu 20.04.
    1. Download the Ubuntu 20.04 image using:
    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 that will 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 Install Edge Insights for Autonomous Mobile Robots.
    If your system is behind a proxy, you must configure the proxy settings.
  9. Run the Intel® RealSense™ ROS sample application inside the Docker container using the steps from Run an Intel® RealSense™ ROS2 Sample Application in Docker* Container.

Summary and Next Steps

In this tutorial, you learned how to run the AMR SDK in KVM VM guest.

Product and Performance Information


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