Documentation

  • 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
      br_kvm.xml
      :
      <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='192.168.122.1' netmask='255.255.255.0'> <dhcp> <range start='192.168.122.50' end='192.168.122.200'/> </dhcp> </ip> </network>
    3. Define and start
      br_kvm
      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 192.168.122.1/24 brd 192.168.122.255 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:
      wget http://releases.ubuntu.com/20.04/ubuntu-20.04.2.0-desktop-amd64.iso
    2. Open virt-manager. Click on
      File
      >
      New VM >
      Select
      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
      Finish
      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

1

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