Get Started Guide

  • 2021.3
  • 10/21/2021
  • Public Content

Install 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 Support Forum 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 Ubuntu*, follow these steps:
  1. Download Ubuntu* Linux* Desktop ISO file to your developer workstation.
  2. Create a bootable flash drive using an imaging application, such as Startup Disk Creator, available on Ubuntu*.
  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 Ubuntu* with the default configurations. For detailed instructions, see the Ubuntu* guide.
  5. Power down your target system and remove the USB drive.
  6. Power up the target system. You will see Ubuntu* 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 Ubuntu* 20.04 version, the default kernels are:
  • 5.4 on Ubuntu* 20.04.1
  • 5.8 on Ubuntu* 20.04.2
  • 5.11 on Ubuntu* 20.04.3
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 https://github.com/intel/linux-intel-lts.git cd linux-intel-lts
  2. Check out to the
    lts-v5.10.47-yocto-210720T182158Z
    branch.
    git checkout lts-v5.10.47-yocto-210720T182158Z
  3. Install the necessary packages and
    gcc
    dependencies.
    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
    .config
    .
    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
    If this steps fails look for solution in the Troubleshooting area at the bottom of the page.
  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
      from
      GRUB_DEFAULT=0
      to
      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
edge_insights_for_amr.zip
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
    edge_insights_for_amr.zip
    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 Software

In this step you extract
edge_insights_for_amr.zip
. 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:
    unzip edge_insights_for_amr.zip
    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 Software

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 Troubleshooting.
    If you encounter any Docker* pull-related issues during the installation process, refer to Troubleshooting.
  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/docker_entrypoint.sh sudo chmod +x amr_ubuntu2004_openvino_sdk_env/docker_entrypoint.sh sudo chmod +x amr_ubuntu2004_full_flavour_sdk_env/docker_entrypoint.sh
  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
    amr-ubuntu2004-ros2-foxy-sdk
    image fails to compile with the following error, refer to Troubleshooting:
    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 a ROS 2 Sample Application in the Docker* Container tutorial.
Installation failure logs will be available at:
/var/log/esb-cli/Edge_Insights_for_Autonomous_Mobile_Robots_<version>/<Component_name>/install.log

Troubleshooting

  • 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 Ubuntu* 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
    amr-ubuntu2004-ros2-foxy-sdk:2021.3
    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'})
    At
    amr_ubuntu2004_ros2_foxy_sdk_env/Dockerfile
    line 275, add
    && pip3 install pytest-rerunfailures \
    .
    \ && pip3 install numpy \ + && pip3 install pytest-rerunfailures \ && cd src \
  • If the Kernel compilation from Step 2 failed, here are some possible known issues and their fixes:
    • For the following error:
      EXTRACT_CERTS certs/signing_key.pem AS certs/system_certificates.o CC certs/common.o CC certs/blacklist.o make[4]: *** No rule to make target 'debian/canonical-revoked-certs.pem', needed by 'certs/x509_revocation_list'. Stop. make[3]: *** [Makefile:1821: certs] Error 2 make[2]: *** [debian/rules:7: build-arch] Error 2 dpkg-buildpackage: error: debian/rules binary subprocess returned exit status 2 make[1]: *** [scripts/Makefile.package:77: deb-pkg] Error 2 make: *** [Makefile:1549: deb-pkg] Error 2
      Re-do all commands from step “4. Copy the configuration file to your folder, and rename it
      .config
      ,” and add one command to step 5:
      scripts/config --set-str CONFIG_SYSTEM_REVOCATION_KEYS ""
    • For the following error:
      Failed to generate BTF for vmlinux Try to disable CONFIG_DEBUG_INFO_BTF
      Re-do all commands from step “4. Copy the configuration file to your folder, and rename it
      .config
      ,” and install one additional package:
      sudo apt install dwarves
  • If the
    amr-ubuntu2004-ros2-foxy-sdk:2021.3
    build command fails with the following error:
    The following packages have unmet dependencies: software-properties-common : Depends: python3-software-properties (= 0.98.9.2) but 0.99.9.8 is to be installed E: Unable to correct problems, you have held broken packages.
    1. Install the package manually:
      # List available package version sudo apt list | grep python3-software-properties # pick right package version to install from the provided list. For example: sudo apt-get install --no-install-recommends -q -y 'software-properties-common=0.99.9.8'
    2. Start the
      amr-ubuntu2004-ros2-foxy-sdk:2021.3
      build process again.
If you’re unable to resolve your issues, go to the Support Forum.

Product and Performance Information

1

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