The balenaEngine is a specialized container engine and a critical element in balenaOS, the lightweight, robust and reliable Linux-based embedded operating system running on over 100 different boards and designed specifically to run containers.
aufs storage engine deprecation
With that in mind, it will come as no surprise that balenaOS would also look to deprecate the use of aufs. However, existing applications in the field on the aufs storage driver would need to be re-downloaded by the engine to run on the new storage driver, and this might incur costs and become an expensive process for fleets on costly bandwidth, such as cellular networks.
To facilitate this update, the balenaEngine now implements a migration step that will convert the existing applications from aufs to overlay2 avoiding application re-downloads.
The migration should be transparent to users in most cases, although the first boot after a hostOS update will take longer to complete as the migration occurs.
In the unlikely case that the migration fails, the system will still fall back to a re-download.
Affected device types
The following devices will be affected by this migration when updating to a BalenaOS version >= 2.85.0, including ESR (Extended Support Release)
- BeagleBone Black
- Intel Edison
- Intel NUC
- Raspberry Pi (v1 / Zero / Zero W)
- Raspberry Pi 2
- Raspberry Pi 3
- Raspberry Pi 3 (using 64bit OS)
- Balena Fin (CM3)
- Revolution Pi Core 3
- NPE X500 M3
- UP Board
If your fleet is running a private device type, please contact us through our support channels and we can check whether your device type is affected.
Experience from the field
Feedback from our support channels has resulted in some bug fixing, for example, extending timeouts for big application migrations, so as always updating to the most recent balenaOS release either in the rolling or ESR (Extended Support Release)
versions is recommended.