Main Content

Troubleshoot Linux Platform Support

When installing or running the Simulink® Desktop Real-Time™ kernel, messages appear that indicate incompatibility.

What This Issue Means

Simulink Desktop Real-Time supports a limited set of Linux® platform distributions. For supported platforms, see Linux platform for development computer. If Simulink Desktop Real-Time detects a platform compatibility issue, a message is displayed.




Simulink Desktop Real-Time requires Secure Boot to be disabled. Please disable Secure Boot through the firmware (BIOS) menus.

The Simulink Desktop Real-Time kernel is not compatible with UEFI Secure Boot feature when running on Linux system.

UEFI Secure Boot must be turned off in the firmware (BIOS) menus.

Unsupported Linux kernel build: {build-identifier}

The Simulink Desktop Real-Time kernel is not compatible with the Linux kernel build shown in the error message.

No direct solution is available because a Linux system with compatible kernel build is required.

The Linux kernel version of your system ({system-version}) is newer than the highest version supported by Simulink Desktop Real-Time ({max-version}). This might cause instability or other problems.

The Linux kernel version on the system is too new. Simulink Desktop Real-Time might still run with a risk of instability.

Upon encountering this error, users are prompted if they want to continue. If the user chooses not to continue with installation, the error above is shown.

The Linux kernel version of your system is not compatible with Simulink Desktop Real-Time. Please update your operating system.

The operating system does not match the minimal version requirement of Simulink Desktop Real-Time.

The system must be updated to the latest version.

Simulink Desktop Real-Time requires package {package-name}" to run correctly on your system. Please install the package and try again.

A package required by Simulink Desktop Real-Time kernel is missing in the system. For example, this could be the case of installations of Ubuntu without Linux headers package installed.

Missing package must be installed using the system package manager. For example, to install Linux headers package on Ubuntu, command sudo apt install linux-headers-$(uname -r) can be used.

Unable to prepare Simulink Desktop Real-Time kernel for installation.

Linux requires additional steps to be taken before installation itself. If those reparation steps fail, Simulink Desktop Real-Time cannot be installed.

No direct solution is available without further diagnostics.

Insufficient user privileges. Sudo privileges are required to install Simulink Desktop Real-Time kernel.

Linux requires superuser (sudo) privileges for Simulink Desktop Real-Time kernel installation. If the privileges cannot be granted, the installation fails.

Users installing SLDRT kernel must have sudo privileges and must provide the sudo password when prompted.

Installer error: "{error-message}"

If any other failure occurs during the installation, error message is shown.

No direct solution is available without further diagnostics.

Try This Workaround

For some of the messages and cases listed in What This Issue Means, you could need to collect diagnostic information for troubleshooting. This data gathering can include finding the exact distribution version, Linux kernel version, and the system status. Use these Linux commands for obtaining diagnostic data.

  • uname -r

    Displays the Linux kernel version.

  • uname -a

    Displays the Linux kernel version details.

  • cat /etc/os-release

    Shows information about current distribution version.

  • sudo mokutil --sb-state

    Displays status of UEFI Secure Boot feature. This requires the mokutil package to be installed on the system. If the package is missing, alternative command below can be used.

  • od --address-radix=n --format=u1 –skip-bytes=4 /sys/firmware/efi/efivars/SecureBoot-*

    Alternative command to display UEFI Secure Boot feature status.

  • sudo dmesg | grep sldrt

    Shows SLDRT kernel logs.

  • sudo -v

    Tests if user has sudo privileges. If user has privileges, they’re prompted for them. Otherwise, error message is shown.

  • sudo systemctl | grep sldrt

    Shows brief status of SLDRT kernel service. If SLDRT kernel is not installed, output of this command is empty.

  • sudo systemctl status sldrtkrn.service

    Shows status of the SLDRT kernel service. The output of this command contains additional diagnostic information.

Related Topics