Cutover Cookbook

Cutover Cookbook

End-to-end recipe before you hand a disk to hyper2kvm / HyperSDK. Deep docs: migration-assurance · fix-plans.

1. Know the image

guestkit detect vm.vmdk
guestkit inspect vm.vmdk -o json > inventory.json

Windows-heavy guests: add --profile windows-migration.

2. Score boot readiness

guestkit doctor vm.vmdk --target proxmox --explain
guestkit doctor vm.vmdk --target proxmox -o json --fail-below 80

Targets: kvm · proxmox · qemu · aws · azure · gcp · cloud · hyperv

3. Generate a fix plan

guestkit migrate-plan vm.vmdk --target proxmox --export plan.yaml
guestkit plan preview plan.yaml

Day-0 shortcuts (no full inspect): see Day-Zero and Rescue.

4. Apply offline (with backups)

guestkit plan apply plan.yaml --vm vm.qcow2 --yes
# or transactional boot repair:
guestkit repair vm.qcow2 --fix boot --dry-run
guestkit repair vm.qcow2 --fix boot
guestkit doctor vm.qcow2 --target proxmox   # re-score

Roll back with guestkit plan rollback if needed. Low-risk day-0 registry/file plans may use --skip-backup.

5. Certify cutover

guestkit passport emit vm.qcow2 --target kvm -o passport.json --bundle
guestkit passport verify passport.json --fail-below 80

Details: Passport.

6. Convert / deploy

GuestKit certifies; hyper2kvm converts. Keep the Passport with the change ticket.

Host checklist

• Linux host with qemu-img, losetup, qemu-nbd
• Mount / repair often need root
• No libguestfs appliance required