NVP-vProxy : La sauvegarde de la machine virtuelle échoue pour certaines machines virtuelles avec une erreur d’exécution « index hors plage »

Résumé: Les sauvegardes NetWorker VMware Protection (NVP) échouent pour certaines machines virtuelles (VM). L’erreur signalée est « index hors plage », ce qui indique un problème de traitement interne ou de gestion des métadonnées qui affecte uniquement des machines virtuelles spécifiques. ...

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

L’intégration de NetWorker VMware Protection (NVP) est configurée avec l’appliance vProxy.
Les sauvegardes échouent pour certaines machines virtuelles (VM) avec un message d’index d’erreur d’exécution hors plage.  
Le journal de session de sauvegarde affiche les éléments suivants :

YYYY/MM/DD HH:MM:SS PANIC:  [145] Internal error occured, see log file: runtime error: index out of range.
YYYY/MM/DD HH:MM:SS PANIC:  [145] goroutine 13 [running]:
...
YYYY/MM/DD HH:MM:SS PANIC:  [145] vim.(*VimVirtualMachine).readCustomField(0xc8202f2800, 0x570500, 0x12, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, 0x0, ...)
...
YYYY/MM/DD HH:MM:SS ERROR:  [145] Backup has FAILED.

Les logs de la session de sauvegarde de machine virtuelle sont disponibles sur le NetWorker Server à l’emplacement suivant :

  • Linux : /nsr/logs/polic/POLICY_NAME/WORKFLOW_NAME
  • Windows (par défaut) : C:\Program Files\EMC NetWorker\nsr\logs\POLICY_NAME\WORKFLOW_NAME

Les journaux de politique de NetWorker Server suivent le jobsdb Rétention (72 heures par défaut). Une fois cette durée écoulée, les logs de la session de sauvegarde de la machine virtuelle sont purgés ; Toutefois, elles sont disponibles sur l’appliance vProxy : /opt/emc/vproxy/runtime/logs/recycle/vbackupd/DATE

Cause

Ce problème se produit au niveau VMware. Il existe plusieurs causes possibles :
 

  1. Valeurs d’attribut personnalisées non valides ou non prises en charge
  • Caractères non-UTF-8
  • Caractères de contrôle
  • Séquences d’échappement mal formées
  • Chaînes excessivement volumineuses (provenant d’outils d’automatisation ou de scripts)
  1. Définitions d’attributs personnalisés orphelines ou incohérentes. Cela se produit lorsqu’une machine virtuelle référence une clé d’attribut personnalisée, mais que la définition d’attribut personnalisée correspondante a été supprimée ou est inaccessible dans vCenter. Cette condition peut s’afficher lors de la suppression d’attributs personnalisés au niveau de vCenter sans les supprimer au préalable de toutes les machines virtuelles. Cela peut se produire dans les environnements de longue durée mis à niveau vers plusieurs versions de vCenter.
  2. Autorisations vCenter insuffisantes pour gérer les attributs personnalisés.
  3. Attributs résiduels laissés par les opérations vProxy interrompues.

Résolution

Pour chacune des causes décrites :

  1. Passez en revue les attributs personnalisés de la machine virtuelle à partir de VMware vSphere. Déterminez si l’un des conflits d’attributs personnalisés soulevés dans la section Cause . Consultez l’administrateur VMware pour savoir si les attributs personnalisés peuvent être supprimés (même s’il s’agit d’un test de sauvegarde temporaire). Si les sauvegardes réussissent sans les attributs personnalisés, tenez compte de leur impact sur la fonctionnalité de sauvegarde et déterminez s’ils sont nécessaires ou s’ils peuvent être désactivés. 
    Remarque : Tout attribut personnalisé associé à vProxy peut être supprimé en toute sécurité. Il s’agit d’attributs d’espace réservé qui sont automatiquement créés lors de l’opération NetWorker VMware Protection (NVP) suivante. Reportez-vous au point quatre pour plus d’informations.
  2. L’administrateur VMware doit rechercher des définitions d’attributs personnalisés orphelines ou incohérentes dans l’environnement vSphere.
  3. Le compte d’utilisateur VMware utilisé pour les opérations NetWorker VMware Protection doit disposer des autorisations Global ->Manage custom attributes dans vSphere. La section Intégration NetWorker VMware - Privilèges minimaux requis pour le compte d’utilisateur vCenter détaille toutes les autorisations nécessaires requises pour les opérations de sauvegarde et de restauration. La documentation NetWorker est disponible ici : Prise en charge de NetWorker | Manuels et documents (vous devez vous connecter avec votre compte de support Dell).
  4. Si les attributs personnalisés vProxy résiduels n’ont pas été mis à jour correctement, ils peuvent être supprimés manuellement conformément au point 1. Vous pouvez également utiliser la commande ProxyHC cleanup peut être utilisée pour nettoyer les informations obsolètes, voir : NVP-vProxy : Utilisation de l’outil de bilan de santé ProxyHC sur l’appliance vProxy

Informations supplémentaires

Le bundle de support du serveur vCenter peut fournir un contexte supplémentaire sur cette défaillance. Passez en revue les logs du serveur vCenter (/var/log/vmware/vpxd/vpxd.log) peut fournir des messages supplémentaires concernant CustomFieldsManager ou vim.fault observés pendant la sauvegarde.

Produits concernés

NetWorker
Propriétés de l’article
Numéro d’article: 000031248
Type d’article: Solution
Dernière modification: 07 Apr 2026
Version:  5
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.