Newer
Older
openstack-caracal-dc-dc / docs / changelog-20260712-opnsense-prep-bz2-fallback.md

Changelog 2026-07-12 -- DOCFIX-184: opnsense-prep-image.sh bz2 python fallback

Context. First real run of scripts/opnsense-prep-image.sh (preparing the OPNsense 26.1 nano image for the Office1 edge) failed exit 2 -- bunzip2 absent (the nano image is .img.bz2). bzip2 is not installed and would need sudo.

Fix

  • scripts/opnsense-prep-image.sh: the bz2 decompress now prefers bunzip2 but falls back to python3's stdlib bz2 module (python3 is a base prereq on this platform), so a missing bzip2 package is no longer a blocker. The required-tools check requires qemu-img + (bunzip2 OR python3).

Verification

  • Re-ran the prep: downloaded/decompressed/converted/grew the 26.1 nano image to opnsense-26.1-nano.qcow2 (qcow2, 11 GiB virtual) via the python path.
  • bash tests/opnsense-prep-image/run-tests.sh -> ALL PASS (3/3). repo-lint 0 fail.

Revert

  • git checkout scripts/opnsense-prep-image.sh; git rm this changelog.