NVP-vProxy : la restauration en mode fichier échoue avec l’erreur « Impossible de contacter l’agent des opérations invitées »

L’intégration NetWorker VMware Protection (NVP) utilise une appliance vProxy pour effectuer des sauvegardes et des restaurations de machines virtuelles. Une restauration en mode fichier (FLR) d’une machine virtuelle échoue pendant la phase de validation des informations d’identification et de montage. Le vProxy ne peut pas contacter l’agent des opérations invitées sur la machine virtuelle cible. La sortie des résultats de montage de NetWorker Management Console (NMC) et le journal de restauration FLR affichent des erreurs VIX API répétées suivies d’un échec de connexion : 

1593xx:nsrvproxy_flr: vProxy Log: YYYY/MM/DD HH:MM:SS TRACE:  [85] Validating credentials with AuthManager ...
1593xx:nsrvproxy_flr: vProxy Log: YYYY/MM/DD HH:MM:SS WARN:   [85] AuthManager.ValidateCredentials: VIX API error (will retry): ServerFaultCode: The guest operations agent could not be contacted.
1593xx:nsrvproxy_flr: vProxy Log: YYYY/MM/DD HH:MM:SS WARN:   [85] AuthManager.ValidateCredentials: VIX API error (will retry): ServerFaultCode: The guest operations agent could not be contacted.
1593xx:nsrvproxy_flr: vProxy Log: YYYY/MM/DD HH:MM:SS WARN:   [85] AuthManager.ValidateCredentials: VIX API error (will retry): ServerFaultCode: The guest operations agent could not be contacted.
1593xx:nsrvproxy_flr: vProxy Log: YYYY/MM/DD HH:MM:SS INFO:   [85] Disconnected from session on vCenter '[MY_VCENTER_NAME]'.
1593xx:nsrvproxy_flr: vProxy Log: YYYY/MM/DD HH:MM:SS ERROR:  [85] Cannot access VM '[MY_VM_NAME]' (vm-3432): ServerFaultCode: The guest operations agent could not be contacted.

Le vProxy tente de valider les informations d’identification trois fois (il réessaiera), puis se déconnecte de la session vCenter et signale qu’il ne peut pas accéder à la machine virtuelle, ce qui confirme que l’agent des opérations invitées est inaccessible. 

La FLR ne parvient pas à monter les systèmes de fichiers sur la machine virtuelle cible. Ce problème peut affecter les machines virtuelles exécutant n’importe quel système d’exploitation invité (Linux ou Windows) et s’applique à toutes les versions de NetWorker et vProxy.

VMware Tools n’est pas installé sur la machine virtuelle cible, ou VMware Tools ne fonctionne pas correctement. Le processus FLR vProxy nécessite que VMware Tools communique avec le système d’exploitation invité via l’API VMware VIX. Sans une installation VMware Tools fonctionnelle, le vProxy ne peut pas valider les informations d’identification par rapport à l’AuthManager invité, ne peut pas accéder au système d’exploitation invité et ne peut pas monter les systèmes de fichiers pour la restauration en mode fichier.

Le Guide d’intégration VMware de Dell NetWorker documente cette exigence dans la section « Limitations de la restauration en mode fichier » :

You must install VMware Tools to use file-level restore. For best results, ensure that all virtual machines run the latest available version of VMware Tools. Older versions are known to cause failures when you perform browse actions during the file-level restore operation.

Cette erreur se produit lorsque l’une des conditions suivantes existe sur la machine virtuelle cible :

• VMware Tools n’est pas installé : l’agent des opérations invitées n’existe pas sur la machine virtuelle.
• VMware Tools est installé mais n’est pas en cours d’exécution : le service VMware Tools s’est arrêté ou n’a pas pu démarrer sur le système d’exploitation invité.
• La version de VMware Tools est obsolète : les versions antérieures peuvent ne pas prendre en charge les opérations d’invité requises par le processus FLR vProxy, ce qui entraîne des échecs de navigation ou de montage.

1. Vérifiez l’état de VMware Tools sur la machine virtuelle cible :
   • Ouvrez vSphere Client et accédez à la machine virtuelle cible.
   • Vérifiez l’état de VMware Tools dans le récapitulatif de la machine virtuelle. Évaluer le résultat :
     • Non installé : passez à l’étape 2 pour installer VMware Tools.
     • Not running : démarrez le service VMware Tools sur le système d’exploitation invité, puis passez à l’étape 3 pour réessayer la FLR.
     • Obsolète : passez à l’étape 2 pour mettre à jour VMware Tools vers la dernière version.
     • En cours d’exécution (Actuel) : VMware Tools fonctionne correctement. Si la FLR échoue toujours, contactez le support Dell (étape 4).
2. Installez ou mettez à jour VMware Tools :
   • Installez ou mettez à jour vers la dernière version disponible de VMware Tools sur la machine virtuelle cible. Suivez la documentation VMware du système d’exploitation invité spécifique qui s’exécute sur la machine virtuelle cible.
   • Après l’installation ou la mise à jour, vérifiez que VMware Tools s’affiche comme En cours d’exécution (Actuel) dans le récapitulatif de la machine virtuelle vSphere Client.
3. Relancez la restauration en mode fichier :
   • Relancez l’opération FLR à partir de NetWorker Management Console pour la machine virtuelle cible.
   • Vérifiez que la FLR s’est terminée avec succès.
4. Faites remonter le problème si nécessaire :
   • Si la FLR continue d’échouer après l’installation de la dernière version de VMware Tools et la confirmation que les outils sont en cours d’exécution, contactez le support Dell pour une procédure d’enquête plus approfondie et consultez cet article de la base de connaissances.