Install ECI Packages

This section will help you set up an ECI repository and install ECI packages.

You should have already downloaded and setup the public ECI repository or hosted a private ECI repository at this point. Now you’re ready to install ECI packages.

Setup Extra repositories

logo_debian logo_ubuntu

The section is applicable to:

../_images/target6.png

Some of the ECI packages depend on additional APT repositories, specifically Intel® oneAPI, Intel® OpenVINO, and ROS2. Follow the steps below to configure the APT package manager with these additional APT repositories:

  1. Setup the ROS 2 Humble Hawksbill or ROS 2 Jazzy Jalisco APT repositories.

    # download the key to system keyring
$ sudo -E wget -O- https://raw.githubusercontent.com/ros/rosdistro/master/ros.key | sudo tee /usr/share/keyrings/ros-archive-keyring.gpg > /dev/null

# add signed entry to APT sources and configure the APT client to use ROS repository:
$ echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/ros-archive-keyring.gpg] http://packages.ros.org/ros2/ubuntu $(source /etc/os-release && echo $VERSION_CODENAME) main" | sudo tee /etc/apt/sources.list.d/ros2.list

    Attention

    If you are located in the People’s Republic of China, modify the /etc/hosts file to directly connect to the raw.githubusercontent server:

    $ sudo bash -c "echo '185.199.108.133 raw.githubusercontent.com' >> /etc/hosts"

  2. Setup the Intel® oneAPI APT repository and preference to install Intel® oneAPI runtime libraries version 2025.1.*:

    # download the key to system keyring
$ sudo -E wget -O- https://apt.repos.intel.com/intel-gpg-keys/GPG-PUB-KEY-INTEL-SW-PRODUCTS.PUB | gpg --dearmor | sudo tee /usr/share/keyrings/oneapi-archive-keyring.gpg > /dev/null

# add signed entry to APT sources and configure the APT client to use oneAPI repository:
$ echo "deb [signed-by=/usr/share/keyrings/oneapi-archive-keyring.gpg] https://apt.repos.intel.com/oneapi all main" | sudo tee /etc/apt/sources.list.d/oneAPI.list
$ sudo bash -c 'echo -e "Package: intel-oneapi-runtime-*\nPin: version 2025.1.*\nPin-Priority: 1001" > /etc/apt/preferences.d/oneapi'

  3. Setup the Intel® OpenVINO APT repository:

    # add signed entry to APT sources and configure the APT client to use OpenVINO repository:
$ sudo bash -c 'echo "deb [signed-by=/usr/share/keyrings/oneapi-archive-keyring.gpg] https://apt.repos.intel.com/openvino/2023 ubuntu22 main" > /etc/apt/sources.list.d/intel-openvino-2023.list'
$ sudo bash -c 'echo "deb [signed-by=/usr/share/keyrings/oneapi-archive-keyring.gpg] https://apt.repos.intel.com/openvino/2024 ubuntu22 main" > /etc/apt/sources.list.d/intel-openvino-2024.list'

  4. Update the APT sources lists:

    $ sudo apt update

Install Real-time Linux Kernel

logo_debian logo_ubuntu

The section is applicable to:

../_images/target6.png

Make sure that you have setup the ECI repository.

  1. Before using the ECI repository, update the APT packages list:

    $ sudo apt update
    ../_images/064.png

    The APT package manager will download the latest list of packages available for all configured repositories.

    ../_images/074.png

    Tip

    If the APT package manager is unable to connect to the repositories, follow these APT troubleshooting tips:

    • Make sure that the system has network connectivity.

    • Make sure that the ports 80 and 8080 are not blocked by a firewall.

    • Configure an APT proxy (if network traffic routes through a proxy server). To configure an APT proxy, add the following lines to a file at /etc/apt/apt.conf.d/proxy.conf (replace the placeholders as per your specific user and proxy server):

      Acquire::http::Proxy "http://user:password@proxy.server:port/";
Acquire::https::Proxy "http://user:password@proxy.server:port/";

  2. ECI provides Deb packages named customizations-* which add a GRUB menu entry for ECI and prepares the system to be deterministic. Install these packages using the eci-customizations meta-package:

    $ sudo apt install -y eci-customizations

  3. ECI provides a firmware package which backports updates from upstream to bring better hardware support to the current distribution. Install this package:

    $ sudo apt-get reinstall '(firmware-linux-nonfree|linux-firmware$)'

  4. Next, install the ECI real-time Linux kernel. There are two options available: Linux Intel LTS PREEMPT_RT kernel and Linux Intel LTS Xenomai Dovetail kernel. It is recommended that you start with Linux Intel LTS PREEMPT_RT kernel, if you do not know which option to choose.

    Click the corresponding tab to know more.

    Linux Intel LTS PREEMPT_RT kernel is Intel’s Long-Term-Support kernel with PREEMPT_RT patches.

    $ sudo apt install -y linux-intel-rt

    Attention

    Please review Canonical Intellectual property rights policy regarding Canonical® Ubuntu®. Note that any redistribution of modified versions of Canonical® Ubuntu® must be approved, certified or provided by Canonical if you are going to associate it with the Trademarks. Otherwise you must remove and replace the Trademarks and will need to recompile the source code to create your own binaries.

  5. Reboot the target system.

    $ sudo reboot

What Next after Installing Real-time Linux Kernel

After installing the real-time Linux kernel, proceed to Complete and Verify Deployment.

web counter