bhatti admin migrate-images
bhatti admin migrate-images server only
Convert old tier images and their dependent disk references to immutable bases.
Synopsis
sudo bhatti admin migrate-images
Description
Tier names under <data_dir>/images/rootfs-<tier>-<arch>.ext4 become symlinks to immutable, content-addressed files in <data_dir>/images/bases/. The command repoints sandbox, snapshot and saved-image disks that still reference a tier symlink to the actual base; an updated tier can then select a new base without rewriting disks already in use.
Migration is idempotent. The daemon runs it at startup, and the installer runs it before switching tier images. The command exits non-zero if any disk cannot be migrated; don't switch tier images while that condition remains. It operates on the local data directory, not on the authenticated HTTP API.
Examples
sudo bhatti admin migrate-images
sudo bhatti --data-dir /srv/bhatti admin migrate-images
With no work remaining, it prints images already migrated. Otherwise it reports moved tiers, repointed disks and any unmigrated paths.
Options
There are no command-specific flags. Global --data-dir chooses the data directory instead of the configured data_dir; --json prints the migration report. See Global flags.
See also
admin gc-images— remove unused bases after migration- Images & tiers — immutable base image lifecycle
- Updating — upgrade caveats