Sur une VM AHV neuve, l’installeur Windows affiche une liste de disques vide. Rien n’est cassé : il lui manque le pilote du contrôleur de stockage, que Nutanix fournit dans son paquet VirtIO.
Pourquoi le disque est invisible
La Nutanix Bible indique que le contrôleur préféré sur AHV est virtio-scsi, le défaut pour les périphériques SCSI ; l’IDE reste possible mais déconseillé. Les distributions Linux récentes embarquent virtio. Windows non : il faut installer les pilotes virtio, les pilotes de mobilité Nutanix ou Nutanix Guest Tools. Mike Dent le résume en 2025 : « Without those drivers, Windows Setup can’t see your disks. »
Installer avec deux CD-ROM
Méthode décrite par Julien Dumur (2025) :
- télécharger l’ISO « Nutanix VirtIO for Windows » sur le portail de support, en choisissant VirtIO dans la liste des produits, et l’importer comme image ;
- créer la VM avec un disque système, un CD-ROM portant l’ISO Windows et un second portant l’ISO VirtIO ;
- en installation personnalisée, cliquer sur « Charger un pilote », parcourir le CD VirtIO, ouvrir le dossier de la version de Windows et sélectionner les pilotes.
Jonas Högman, en 2021, coche les pilotes Balloon, Ethernet et SCSI pass-through. Le disque apparaît aussitôt.
Une version de Windows plus récente que le paquet complique un peu les choses. En novembre 2024, sur AOS 6.10 avec VirtIO 1.2.3, Högman installe Windows Server 2025 alors que le paquet s’arrête à Windows Server 2022 : il charge le pilote SCSI pass-through de ce dossier, puis rattache à la main, dans le Gestionnaire de périphériques, les périphériques restés inconnus. Il précise que Windows Server 2025 n’était pas encore supporté officiellement à cette date.
Pour Windows 11, l’UEFI et le vTPM, voir ce billet.
Après l’installation
Lancez l’installeur MSI présent sur le CD VirtIO : c’est l’étape post-installation des deux billets de Högman (le second le lance depuis le CD). Pour contrôler la version, un employé Nutanix précise en 2020 que depuis le paquet 1.1.6, la version de chaque pilote est celle du paquet ; il suffit donc de lire la version du pilote dans l’invité. Pour les paquets plus anciens, l’employé renvoie à la KB 5491.
La 1.2.5, présentée par Julien Dumur en juillet 2025, remplace le pilote QEMU « null » par un périphérique FwCfg, ce qui permet de collecter les vidages mémoire Windows depuis l’hôte AHV, et corrige un blocage de VM après le démontage d’un disque.
Intégrer les pilotes à l’image
Pour éviter le second CD-ROM, un employé Nutanix décrit en 2020 l’injection des pilotes dans l’ISO Windows, avec PowerShell, le Windows ADK et des droits administrateur, en renvoyant à la KB 10290 pour le détail. Mike Dent (2025) injecte tous les pilotes, avec -Recurse, dans install.wim et dans l’index 2 de boot.wim, l’environnement d’installation. Le cœur de l’opération, sur une copie modifiable du contenu de l’ISO, avec les cmdlets DISM documentées par Microsoft :
Mount-WindowsImage -ImagePath "<copie_iso>\sources\boot.wim" -Index 2 -Path "C:\mount"
Add-WindowsDriver -Path "C:\mount" -Driver "<lecteur_virtio>\" -Recurse
Dismount-WindowsImage -Path "C:\mount" -Save
Même séquence pour l’index retenu de install.wim, puis reconstruction de l’ISO.
VirtIO et NGT
NGT embarque lui aussi les pilotes VirtIO, comme détaillé dans le billet sur NGT. Les notes de Move 6.0 (septembre 2025) listent parmi les problèmes connus « Some NGT installations may downgrade VirtIO versions », avec un correctif annoncé. En octobre 2026, Move 6.3.3 annonce VirtIO 1.2.5 comme version supportée.
Ce qu’il faut retenir
- Sur AHV, le disque est servi par virtio-scsi : sans pilote VirtIO, l’installeur Windows ne voit rien.
- Montez l’ISO Nutanix VirtIO sur un second CD-ROM et chargez le pilote SCSI pass-through du dossier de votre version de Windows.
- Après l’installation, passez le MSI ; depuis 1.1.6, la version du pilote égale celle du paquet.
- Pour un parc, injectez les pilotes dans
boot.wimetinstall.wim. - Move 6.0 a signalé que certaines installations de NGT pouvaient rétrograder VirtIO : contrôlez la version après un passage de NGT.
In English
Without the VirtIO SCSI driver, the Windows installer sees no disk on AHV. Load the drivers during installation, build them into the image, keep them updated and watch how NGT affects their version. Mount two CD-ROMs, Windows and Nutanix VirtIO, and since VirtIO 1.1.6 each driver carries the package version, which simplifies checks in the guest.
Sources & vérification
Relevé sur : Documentation publique Nutanix (Nutanix Bible, Nutanix Community), Microsoft Learn et blogs techniques, relevé 2026-10
- Nutanix Bible, How AHV Works (Storage I/O Path) nutanixbible.com
- Nutanix Community, Create Windows Installation ISO with Built-In VirtIO Drivers (2020) next.nutanix.com
- Nutanix Community, VirtIO Driver Versions for Windows (2020) next.nutanix.com
- Nutanix Community, Product Updates (Move 6.0, 2025 ; Move 6.3.3, 2026) next.nutanix.com
- Julien Dumur, Nutanix AHV, Deploy a Windows VM using VirtIO (2025) juliendumur.fr
- Julien Dumur, Nutanix AHV, VirtIO v1.2.5 is available (2025) juliendumur.fr
- Jonas Högman, Windows Server 2022 on AHV (2021) jonashogman.com
- Jonas Högman, Windows Server 2025 on AHV (2024) jonashogman.com
- Mike Dent, Creating AHV-Ready Windows ISOs with Embedded VirtIO Drivers (2025) mikedent.io
- Microsoft Learn, Mount-WindowsImage learn.microsoft.com
- Microsoft Learn, Add-WindowsDriver learn.microsoft.com
- Microsoft Learn, Dismount-WindowsImage learn.microsoft.com
