• 2021.3
  • 10/21/2021
  • Public Content

Edge Insights for Autonomous Mobile Robots

During the installation, you will be prompted to enter your product key. This key is in the email you received from the Intel® Registration Center. Contact if you do not have this email message.
The steps below explain how to:
  • Prepare your target system.
  • Copy the package.
  • Complete the installation steps.

Step 1: Prepare the
Target System

Make sure your target system has a fresh installation of Ubuntu* Linux* that corresponds to the version of
Edge Insights for Autonomous Mobile Robots
EI for AMR
) that you downloaded. If you need help installing
, follow these steps:
  1. Download to your
    developer workstation
  2. Create a bootable flash drive using an imaging application, such as Startup Disk Creator, available on
  3. After flashing the USB drive, power off your target system, insert the USB drive, and power on the target system.
    If the
    target system
    doesn't boot from the USB drive, change the boot priority in the system BIOS.
  4. Follow the prompts to install
    with the default configurations. For detailed instructions, see the .
  5. Power down your
    target system
    and remove the USB drive.
  6. Power up the
    target system
    . You will see
    Desktop is successfully installed.

Step 2: Update the Kernel to Version 5.10.47

The only supported kernel version for
EI for AMR
is Intel's Linux* LTS Kernel 5.10.47. Depending on your
20.04 version, the default kernels are:
  • 5.4 on
  • 5.8 on
  • 5.11 on
To check your kernel version:
uname -r
Step 2 is only valid for updating from kernel versions 5.4, 5.8, and 5.11. If you have a different kernel, go to the Support Forum.
  1. Clone Intel's Linux* LTS kernel 5.10.47 repository from GitHub*.
    git clone cd linux-intel-lts
  2. Check out to the
    git checkout lts-v5.10.47-yocto-210720T182158Z
  3. Install the necessary packages and
    sudo apt-get -y install build-essential gcc bc bison flex libssl-dev libncurses5-dev libelf-dev
  4. Copy the configuration file to your folder, and rename it
    cp /boot/config-$(uname -r) ./.config
  5. Change this value of the kernel configuration.
    scripts/config --set-str SYSTEM_TRUSTED_KEYS ""
  6. This step is optional; it is only for setups that use Sony's IMX390 MIPI sensor.
    Enable the Sony* IMX390-related and TI* TI960-related modules.
    scripts/config --module CONFIG_VIDEO_IMX390 scripts/config --module CONFIG_VIDEO_TI960 scripts/config --module CONFIG_VIDEO_INTEL_IPU6 scripts/config --module CONFIG_VIDEO_AR0234 scripts/config --module CONFIG_PINCTRL_TIGERLAKE scripts/config --enable CONFIG_INTEL_IPU6_TGLRVP_PDATA
  7. Compile the kernel, and make the Debian* kernel packages.
    make olddefconfig make -j4 deb-pkg
  8. Install the new Debian* kernel packages.
    cd ../ && sudo dpkg -i linux-*.deb
  9. For
    kernel version 5.11 only
    , the newly installed kernel is a lower version than the system kernel, so the system needs to be configured to use it instead of the latest version.
    1. Open the GRUB.
      sudo cp /etc/default/grub /etc/default/grub.bak sudo vi /etc/default/grub
    2. Change the value of
      GRUB_DEFAULT="Advanced options for Ubuntu>Ubuntu, with Linux 5.10.47"
    3. Update the GRUB.
      cd /tmp sudo update-grub
  10. Reboot your system.
    sync sudo reboot -fn
  11. Check your kernel version after reboot:
    uname -r
This process can take from 30 minutes to two hours, depending on your system.

Step 3: Copy the
File to the
Target System

In this step you copy the
Edge Insights for Autonomous Mobile Robots
zip file to your
target system
  1. Copy
    from the
    developer workstation
    to the Home directory on your
    target system
    . You can use a USB flash drive to copy the file.

Step 4: Extract the
Edge Insights for Autonomous Mobile Robots

In this step you extract
. You need to be on the
target system
to complete these steps.
  1. Make sure you have a working Internet connection.
  2. Open a new terminal.
  3. Extract the package:
    If you download the file more than once, each download beyond the first is appended by a number.

Step 5: Install the
Edge Insights for Autonomous Mobile Robots

If you are running behind a proxy server, please be sure that the proxy settings are configured correctly. The edgesoftware tool uses these proxy settings to download and install the modules.
You will now run a script that will download components and install
Edge Insights for Autonomous Mobile Robots
on your
target system
The software installation will take about 10 minutes. The completion time depends on your
target system
and Internet connection.
  1. Run the following commands to go to the directory, change permission of the executable edgesoftware file, and install the package:
    cd edge_insights_for_amr chmod 775 edgesoftware sudo ./edgesoftware install sudo groupadd docker sudo usermod -aG docker $USER newgrp docker
    If the installer is blocked at checking the internet connection, refer to the Troubleshooting section.
    If you encounter any Docker* pull-related issues during the installation process, refer to the Troubleshooting section.
  2. Type the product key at the prompt:
    The Product Key is displayed in the download page.
  3. Based on components selected and system configuration, you might be prompted for additional actions. For example, if your system is behind a proxy, you are asked to enter proxy settings.
    When the installation is complete, you see the message
    Installation of package complete
    and the installation status for each module.
  4. Copy the source code for Wandering, FastMapping, and gazebo_world in the AMR containers folder, and prepare the setup for the Docker* images build:
    cd Edge_Insights_for_Autonomous_Mobile_Robots<version>/ sudo cp -rf FastMapping/ AMR_Simulations/gazebo_world/ AMR_containers/amr_ubuntu2004_ros2_foxy_sdk_env/ sudo cp -rf Wandering/ AMR_containers/amr_ubuntu2004_openvino_sdk_env/ cd AMR_containers/ sudo chmod +x amr_ubuntu2004_ros2_foxy_sdk_env/ sudo chmod +x amr_ubuntu2004_openvino_sdk_env/ sudo chmod +x amr_ubuntu2004_full_flavour_sdk_env/
  5. Build the Docker* images by running a Docker* build for each container (update the proxies according to your network requirements; if no proxies are needed, remove them from the command):
    docker build --tag amr-ubuntu2004-ros2-foxy-sdk:2021.3 --build-arg http_proxy=<http_proxy> --build-arg https_proxy=<https_proxy> --no-cache --file amr_ubuntu2004_ros2_foxy_sdk_env/Dockerfile amr_ubuntu2004_ros2_foxy_sdk_env docker build --build-arg base_image=amr-ubuntu2004-ros2-foxy-sdk:2021.3 --tag amr-ubuntu2004-openvino-sdk:2021.3 --build-arg http_proxy=<http_proxy> --build-arg https_proxy=<https_proxy> --file amr_ubuntu2004_openvino_sdk_env/Dockerfile amr_ubuntu2004_openvino_sdk_env docker build --build-arg base_image=amr-ubuntu2004-openvino-sdk:2021.3 --build-arg http_proxy=<http_proxy> --build-arg https_proxy=<https_proxy> --tag amr-ubuntu2004-full-flavour-sdk:2021.3 --file amr_ubuntu2004_full_flavour_sdk_env/Dockerfile amr_ubuntu2004_full_flavour_sdk_env
    If the
    image fails to compile with the following error, go to the Troubleshooting section:
    pkg_resources.ContextualVersionConflict: (pyparsing 3.0.4 (/home/eiforamr/ros2_ws/.venv/lib/python3.8/site-packages), Requirement.parse('pyparsing<3,>=2.0.2'), {'packaging'})
    The total build time is approximately 60 minutes. The time varies depending on the testing system's capabilities.
  6. Verify that all Docker* images were created:
    docker image list
To confirm your installation was successful and for a quick look at how it works, you can perform the first two steps in the Run an ROS2 Sample Application in Docker* Container tutorial.
Installation failure logs will be available at:


  • If you set up proxies using export, sudo does not know about them. You must use
    sudo -E ./edgesoftware
    to install the package:
    sudo -E ./edgesoftware
  • Make sure you have an active internet connection during the full installation. If you lose Internet connectivity at any time, the installation might fail.
  • Make sure you are using a fresh
    installation. Earlier software, especially Docker* and Docker Compose*, can cause issues.
  • For the following error message, go to Docker* hub download rate limit
    docker: Error response from daemon: toomanyrequests: You have reached your pull rate limit.
  • If the
    build command fails with the following error:
    pkg_resources.ContextualVersionConflict: (pyparsing 3.0.4 (/home/eiforamr/ros2_ws/.venv/lib/python3.8/site-packages), Requirement.parse('pyparsing<3,>=2.0.2'), {'packaging'})
    by adding
    && pip3 install pytest-rerunfailures \
    at line 275.
    \ && pip3 install numpy \ + && pip3 install pytest-rerunfailures \ && cd src \
If you're unable to resolve your issues, go to the .

Product and Performance Information


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