Yocto Project runtime

reference

Upgrading from thud to newer versions fails with "Dual rootfs configuration not found"

When upgrading from thud to new meta-mender versions, the update may result in failure with a log similar to this:

2019-10-09 10:43:52 +0000 UTC error: Dual rootfs configuration not found when resuming update. Recovery may fail.
2019-10-09 10:43:52 +0000 UTC info: State transition: init [none] -> after-reboot [ArtifactReboot_Leave]
2019-10-09 10:43:52 +0000 UTC error: transient error: Stub module: Cannot execute ArtifactVerifyReboot
2019-10-09 10:43:53 +0000 UTC info: State transition: after-reboot [ArtifactReboot_Leave] -> rollback [ArtifactRollback]
2019-10-09 10:43:53 +0000 UTC debug: transitioning to error state
2019-10-09 10:43:53 +0000 UTC debug: statescript: timeout for executing scripts is not defined; using default of 1h0m0s seconds
2019-10-09 10:43:53 +0000 UTC debug: statescript: timeout for executing scripts is not defined; using default of 1h0m0s seconds
2019-10-09 10:43:53 +0000 UTC info: performing rollback
2019-10-09 10:43:53 +0000 UTC error: Unable to roll back with a stub module, but will try to reboot to restore state

The meta-mender warrior branch introduced a change for the configuration of Mender. Now the configuration is split between a transient configuration file in /etc/mender/mender.conf and a persistent configuration file in /data/mender/mender.conf, see MEN-2757.

A device running on a single configuration file cannot upgrade to an image built with two configuration files feature.

To enable migration please add the following to your local.conf or similar:

IMAGE_INSTALL:append = " mender-client-migrate-configuration"
PACKAGECONFIG:remove = "split-mender-config"
MENDER_PERSISTENT_CONFIGURATION_VARS = "RootfsPartA RootfsPartB"
MENDER_ARTIFACT_EXTRA_ARGS:append = " -v 2"

Note that if you are using the meta-mender zeus branch or newer you need to reflect the new name for mender-client:

IMAGE_INSTALL:append = " mender-client-migrate-configuration"

Build an image with above configuration and deploy it your device fleet. Once all devices in the fleet have been updated with the migration script enabled you can remove these changes and return to the normal workflow of generating update Artifacts.

Note that mender-client-migrate-configuration recipe uses a state script, and it might be needed to clean the yocto build after removing it.

Upgrading from mender-client 2.1 and earlier to newer versions fails "type_info provides values not yet supported"

If you generate an artifact with mender-artifact version 3.3 or newer and try to upgrade an older mender-client (2.1 or earlier), you may get a log line similar to this:

Mar 04 10:21:09 ifu-25 mender[14270]: time="2021-03-04T10:21:09Z" level=error msg="Fetching Artifact headers failed: installer: failed to read Artifact: type_info provides values not yet supported" module=state

It is because mender-client 2.1.0 does not support the newer rootfs-image.checksum feature. See MEN-2956

To solve it, use the --no-checksum-provide flag when creating the artifact. In Yocto you can add this argument to the MENDER_ARTIFACT_EXTRA_ARGS variable.

MENDER_ARTIFACT_EXTRA_ARGS = "--no-checksum-provide"

You will likely then run into another error described above. If so, you can just chose to generate a v2 artifact and that solves the --no-checksum-provide problem as well.

See here and here for more discussion on Mender Hub.

Boot sequence fails with "Failed to mount /uboot" and "codepage cp437 not found"

This sometimes happens when using one of the minimal images from the Yocto Project, such as core-image-minimal or core-image-full-cmdline. These images do not include the kernel-modules package, which contains the kernel module with codepage 437. There are two ways this can be resolved:

  • If you're compiling a custom kernel, it is recommended to set the kernel configuration option:

    CONFIG_NLS_CODEPAGE_437=y

    Please refer to the Yocto Project Manual for how to use menuconfig to generate and save defconfig files for the kernel.

  • If you're not building a custom kernel, you can add this line to your local.conf in order to include all the kernel modules in the image:

    IMAGE_INSTALL:append = " kernel-modules"

    This is an easier fix, but also requires more space in the image than the previous solution, since all modules will be included, not just the missing one.

System stops at U-Boot prompt

There are reports of some systems having trouble running the U-Boot boot commands and getting stuck at the U-Boot prompt. This has, notably, been reported to happen on the Raspberry Pi family of boards with certain serial port adapters. In the failing scenario, it is believed that the serial port adapter is electrically noisy resulting in spurious data on the console that is interpreted by U-Boot as the user intentionally interrupting the boot process. It is unclear which brands of serial port adapters cause this issue or if certain boards are more susceptible than others.

If you are experiencing this issue, there are several proposed workarounds that you should try:

  • Disable the serial console by editing config.txt. With Yocto builds you can set the following in your local.conf to disable this:

    ENABLE_UART = "0"
  • Change the U-Boot configuration to disable the UART for console input. Adding the following to the U-Boot environment has been reported to address this in some situations:

    setenv stdout lcd
    setenv stderr lcd
    setenv stdin usbkbd
  • Modify the U-Boot code to require a different key sequence to interrupt the boot. Some tweaking of the following settings in the U-Boot code may help here:

    #define CONFIG_AUTOBOOT_KEYED
    #define CONFIG_AUTOBOOT_PROMPT \
      "\nRPi - booting... stop with ENTER\n"
    #define CONFIG_AUTOBOOT_DELAY_STR "\r"
    #define CONFIG_AUTOBOOT_DELAY_STR2 "\n"

I moved from an older meta-mender branch to the thud branch and suddenly my image is just a few MiB too small

This is a typical symptom:

error: update (952107008 bytes) is larger than the size of device /dev/mmcblk0p3 (947912704 bytes)

This is because of an optimization to the thud branch which uses more of the available space in the sdimg and uefiimg images. However, it also means that if the device was provisioned with an older image, the new update will be just slightly too big for the old partition to hold it.

To revert to the old size calculation, add this to your build configuration (machine.conf or local.conf are good places):

MENDER_PARTITIONING_OVERHEAD_KB = "${@eval('(int((${MENDER_PARTITION_ALIGNMENT} - 1) / 1024) + 1) * 4')}"

Poor performance when loading images from U-boot

On certain devices you might get poor performance when trying to load the Linux kernel image from the root filesystem, and it can look like this:

u-boot=> ext4load ${mender_uboot_root} /boot/${image}
23065088 bytes read in 79537 ms (282.2 KiB/s)

This seems to be more common on aarch64 devices, that is 64-bit ARM.

The root cause of this issue is that U-Boot's ext4 support does not handle extents very well. When a file gets large enough, extent index blocks will get created for it, and that leads to exercising a very slow code path. This has been fixed in upstream U-boot with this patch, but at the time of writing, this is not included in any released U-boot versions and the first version to contain this fix will be 2019.07.

There are a couple of workarounds,

  1. Backport the upstream patch to the U-boot version you are using or update U-boot to to a version that includes the mentioned patch.
  2. Use a different filesystem, e.g ext3 which does not support extents and does not suffer from this limitation.
    • In Yocto you can change filesystem type by setting ARTIFACTIMG_FSTYPE = "ext3" in your local.conf or other appropriate location
  3. Disable extents feature on ext4 filesystem
    • In Yocto you can add EXTRA_IMAGECMD:ext4 = "-O ^extent" in your local.conf or other appropriate location.
    • Above is equivalent to running mkfs.ext4 -O ^extent if you are using something other then Yocto to generate your filesystem images

Additional background information can be found in these threads:

Deploying an update from dunfell to kirkstone on Raspberry Pi blocks forever with Waiting for root device /dev/mmcblk0p3...

Raspberry Pi boards have a set of boot firmware files (including Device Tree Blob files) that are located on the boot partition, and these files are not updated when you perform an update of the root filesystem where the kernel lives.

Occasionally, changes to the Raspberry Pi software stack require that these files are updated. Between the Linux kernel and the boot firmware, version interdependencies exist which need to be taken care of. Therefore, to update the Linux kernel, you must also update the boot firmware files.

This is what has happened between dunfell and kirkstone yocto releases for Raspberry Pi 3B (other boards might have been affected too).

Mender provides a recipe to include a state script in the Artifact that will copy the firmware files into the boot during the Artifact install. Enable it by adding the following to e.g local.conf:

INHERIT += "rpi-update-firmware"

You can override the script customizing what files to update, e.g only DTB files. See mendersoftware/meta-mender@5abe2e7 for more details.

Updating the boot firmware files can not be done atomically and the files cannot be rolled back even though a rootfs rollback is performed. In conclusion, this is a risky operation which could brick your device. We recommend using this workaround only once when upgrading between Yocto releases, and not for every update henceforth.

When removing INHERIT += "rpi-update-firmware" from your local.conf, you need to to clear the tmp directory of the Yocto build or call bitbake -c clean update-firmware-state-script <your-image-name> before building a new image to successfully remove the state script from the next Artifact.

We welcome contributions to improve this documentation. To submit a change, use the Edit link at the top of the page or email us at .