Nutanix Guest Tools : ce que l’agent apporte et comment vérifier qu’il parle au cluster

Une VM tourne sur AHV sans Nutanix Guest Tools (NGT), mais plusieurs fonctions de la plateforme passent par cet agent. Et un agent installé qui ne communique plus avec le cluster n’en fournit aucune.

Ce que contient NGT

La Nutanix Bible définit NGT comme un framework d’agent installé dans l’invité. Le paquet comprend :

• le Guest Agent Service ;
• l’outil en ligne de commande de Self-Service Restore (SSR), aussi appelé File-Level Restore ;
• les pilotes de mobilité, c’est-à-dire les pilotes VirtIO pour AHV ;
• l’agent VSS et le hardware provider pour les VM Windows ;
• la prise en charge des snapshots cohérents applicatifs sous Linux, par des scripts qui mettent la VM au repos.

Le blog Nutanix (Bob Ball, 2023) ajoute la restauration de fichiers par l’utilisateur depuis les snapshots de Prism Central et la reconfiguration réseau de l’invité lors d’une bascule DR.

Snapshots cohérents applicatifs

Sous Windows, la solution s’intègre au framework VSS. Linux n’a pas d’équivalent : la Bible décrit des scripts de pré-gel et de post-dégel placés dans /sbin. Côté protection, on coche « Use application consistent snapshots » dans le workflow habituel.

Les prérequis listés par la Bible, page Backup et DR :

• une VIP de cluster configurée ;
• NGT installé dans la VM ;
• la VIP joignable sur le port 2074 depuis la VM ;
• la VM dans un Protection Domain où l’option cohérence applicative est activée.

Quand NGT est activé sur une VM, la capacité VSS l’est par défaut.

Le chemin entre l’agent et le cluster

Un NGT Proxy tourne sur chaque CVM et écoute en externe sur le port 2074. La page Services de la Bible demande, au choix, une communication routée entre les réseaux des VM et la VIP, ou une règle de pare-feu (avec NAT) vers la VIP sur le port 2074, qu’elle préfère. Le proxy relaie vers un NGT Leader unique, hébergé par le Prism Leader, celui qui porte la VIP. Pour savoir quelle CVM l’héberge, depuis n’importe quelle CVM :

nutanix_guest_tools_cli get_leader_location

Côté invité, la Bible décrit une liaison par port série entre la VM et la CVM, avec repli sur une connexion réseau SSL vers la VIP. Le billet de 2023 date cette voie : depuis AOS 6.6, sur AHV uniquement, NGT peut passer par des services de l’hôte, sans réseau direct entre la VM et Prism Element. Il faut pour cela un port série présenté à la VM. Les VM créées sous AOS 6.6 l’ont par défaut ; une VM existante peut demander un redémarrage pour le recevoir.

Installer, y compris à grande échelle

Trois voies selon la Bible : Prism, les paquets (.exe Windows, .rpm et .deb Linux), ou les scripts (nCLI, REST, PowerShell). L’installation par lot depuis Prism Central exige WinRM ou SSH et des identifiants ; l’installeur externe d’AOS 6.7 s’en passe et se pousse par un outil de gestion de parc, l’activation des fonctions restant à faire dans Prism Central (blog de 2023).

Pour une image de base, la Bible donne la séquence :

1. installer NGT sur la VM modèle et vérifier qu’elle joint la CVM ;
2. cloner les VM depuis ce modèle ;
3. monter l’ISO NGT sur chaque clone : le service NGT des CVM fait office d’autorité de certification et y place une paire de certificats propre à la VM ;
4. démarrer les clones.

ncli ngt mount vm-id=<vm_id>

Vérifier le lien

Depuis une CVM :

ncli ngt list

Le champ à lire est Communication Link Active. Un salarié Nutanix l’explique sur le forum : false signifie que le Guest Agent est arrêté dans la VM, ou qu’il ne joint pas Prism. Journaux : C:\Program Files\Nutanix\Logs\ sous Windows, /usr/local/nutanix/ngt/logs sous Linux. Son remède : vider le CD-ROM, Manage Guest Tools dans Prism (activer puis monter), relancer l’installeur depuis le lecteur.

Migration Move entre clusters AHV sans NGT : voir ce billet.

Ce qu’il faut retenir

• NGT porte VSS, la restauration en libre-service, les pilotes VirtIO et la mise au repos Linux : sans agent fonctionnel, pas de snapshot cohérent applicatif.
• Prérequis réseau : la VIP de cluster joignable depuis la VM sur le port 2074 ; depuis AOS 6.6 sur AHV, un port série peut remplacer le réseau.
• Une VM clonée doit recevoir l’ISO NGT pour obtenir ses propres certificats.
• ncli ngt list et le champ Communication Link Active disent si l’agent dialogue vraiment avec le cluster.

In English

Application-consistent snapshots, self-service file restore and VirtIO drivers rely on NGT. Components, network path, deployment through a base image and link check: the cluster VIP must be reachable on port 2074 from the VM, a VM cloned from an image with NGT preinstalled needs the NGT ISO to get its own certificates, and ncli ngt list shows the link state.

Sources & vérification

Relevé sur : Documentation publique Nutanix (Nutanix Bible, blog Nutanix, forum next.nutanix.com), relevé 2026-10

• Nutanix Bible, AOS Services (Nutanix Guest Tools) nutanixbible.com
• Nutanix Bible, AOS Backup and Disaster Recovery (Application Consistent Snapshots) nutanixbible.com
• Bob Ball, More Options and Less Complexity with Nutanix Guest Tools' Newest Features (2023) nutanix.com
• Nutanix Community, NGT Upgrade messages – what do they mean next.nutanix.com

Comment les billets sont vérifiés et corrigés