Documentation

  • 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 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 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 .
  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
  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 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/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, 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:
/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'})
    Change
    amr_ubuntu2004_ros2_foxy_sdk_env/Dockerfile
    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

1

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