Avamar: Hyper-V backup failing with hypervvss_assist DEBUG-INTERNAL ERROR

Résumé: Knowledge base (KB) article that provides steps for addressing Hyper-V backups failing due to custom checkpoints on a virtual machine (VM).

Cet article concerne Cet article ne concerne pas Cet article n’est associé à aucun produit spécifique. Toutes les versions du produit ne sont pas identifiées dans cet article.

Symptômes

Hyper-V backup fails with the following error reported in the log:

[hypervvss_assist] INTERNAL ERROR: <0001> assert error (this_disk.virtual_disk_snapshot_id.isempty()), hypervvss_targets.cpp

This error occurs right after Avamar is fetching the virtual hard disk (VHD) list of one or several VMs:

avhypervvss Info <41738>: Fetching VHD chain list for 'VM_NAME<VM_ID>

Even if the avtar flag shown below is used, the backup ends with a "Failed" status instead of "Completed With Exceptions."

 --save-partial-backup

Cause

This issue is seen in a Full backup with a virtual machine (VM) creating on a differencing disk or checkpoint.

Note: The differencing disk or checkpoint must be created using Hyper-V Manager.

In such a case, this disk does not have a snapshot id associated with it. 

Here are the steps to reproduce the problem:

  1. Perform first backup of a VM with a differencing disk or checkpoint.
  2. The backup job succeeds
  3. Add one more differencing disk with Hyper-V Manager.
  4. Run backup.

Observed behavior: Backup fails.
Expected behavior: Backup should succeed.

Résolution

Exclude the VM(s with the custom or user-created checkpoints. This can be done either using the dataset or using the "--excludelist" flag in the avhypervvss.cmd file (in the Avamar var folder).
Alternatively, remove the checkpoint from the VM. This can be done either using Hyper-V Manager or from the following PowerShell command:

Get-VMSnapshot -ComputerName "MyHyperVHost" -VMName "VM with Checkpoint” | Remove-VMSnapshot

If neither of the above workarounds is feasible, then contact DELL support and reference this KB article.

    Informations supplémentaires

    The "--save-partial-backup" flag was introduced to have an available Hyper-V backup to restore from, even if some VMs failed to backup.

    This backup with some missing VMs ends as "Completed With Exceptions." The Avamar backup administrator should always review these exception errors.

     

    Produits concernés

    Avamar, Avamar Plug-in for Hyper-V VSS
    Propriétés de l’article
    Numéro d’article: 000056344
    Type d’article: Solution
    Dernière modification: 14 Nov 2025
    Version:  6
    Trouvez des réponses à vos questions auprès d’autres utilisateurs Dell
    Services de support
    Vérifiez si votre appareil est couvert par les services de support.