Image Builder blueprints are no longer present following an update to Red Hat Enterprise Linux 8.3

Solution Verified - Updated

Environment

  • Red Hat Enterprise Linux 8
    • lorax-composer
    • osbuild-composer

Issue

  • After we updated our Image Builder system to Red Hat Enterprise Linux 8.3, we no longer have any blueprints present. How do we recover them?

Resolution

The following command can be used to load the previous lorax-composer based blueprints into the new osbuild-composer backend.

for blueprint in $(find /var/lib/lorax/composer/blueprints/git/workspace/master -name '*.toml'); do composer-cli blueprints push "${blueprint}"; done

Note: The above command requires that the composer-cli CLI utility be available. In the event that it is not installed prior to the above command being issued, it can be installed via the following, and the above command issued again:

yum install composer-cli

It is notable that any blueprint options that are no longer used will not be converted in the process. In the event that a particular configuration option is necessary, please open a case with Red Hat Support and provide this article as well as a description of the particular configuration option that is necessary.

Root Cause

With the release of Red Hat Enterprise Linux 8.3, the previously used lorax-composer backend (used by Image Builder) has been replaced with osbuild-composer. During the upgrade, the previous blueprints are not converted, leaving them unavailable without user intervention.

SBR
Product(s)
Category

This solution is part of Red Hat’s fast-track publication program, providing a huge library of solutions that Red Hat engineers have created while supporting our customers. To give you the knowledge you need the instant it becomes available, these articles may be presented in a raw and unedited form.