Error - Backup failed as VM with Checkpoint is not supported

KB ID: 221018

Cause:

This error occurs when a backup process fails because the virtual machine (VM) being backed up has an active checkpoint associated with it. Backing up VMs with active checkpoints is not supported and can lead to failure. To ensure successful backups, these checkpoints must be removed.

Solution:

Follow these steps to resolve this error and remove checkpoints associated with the VM:
Step 1: List All VMs
List all VMs on your system. Use the following command to obtain a list of all VMs, including their names and status:
virsh list --all
Step 2: List VM Checkpoints
Identify the VM for which you encountered this error and retrieve a list of its associated checkpoints. Replace `<DOMAIN_ID/VM_NAME>` with the actual domain ID or VM name:
virsh checkpoint-list <DOMAIN_ID/VM_NAME>
This command will display a list of checkpoints associated with the specified VM.
Step 3: Delete Checkpoints
To Proceed to delete the identified checkpoints. Use the following command, replacing `<DOMAIN_ID/VM_NAME>` and `<CHECKPOINT_NAME>` with the appropriate values:
virsh checkpoint-delete <DOMAIN_ID/VM_NAME> <CHECKPOINT_NAME>
This command will attempt to delete the specified checkpoint. If the deletion fails for any reason, you can use the following command with the `--metadata` flag to remove the checkpoint metadata:
virsh checkpoint-delete <DOMAIN_ID/VM_NAME> <CHECKPOINT_NAME> --metadata

Note: Exercise caution when deleting checkpoints, as this action can impact the VM's state. Ensure that you have backups or snapshots of your VM in case any issues arise during this process.

By following these steps, you can resolve this error and ensure that your VM no longer has any associated checkpoints. This will allow for successful backups without compatibility issues related to checkpoints.