Prise en charge de l'ajout et de la suppression à chaud des périphériques VMDirectPath I/O

Les périphériques de relais fournissent les moyens nécessaires pour utiliser les ressources de manière efficace et améliorer les performances de votre environnement.

Dans vSphere 8.0 et versions antérieures, les périphériques de relais étaient ajoutés ou supprimés uniquement lorsque la machine virtuelle était hors tension. La version actuelle de vSphere offre la prise en charge de l'ajout et de la suppression à chaud des périphériques VMDirectPathI/O. L'ajout à chaud fait référence à la procédure d'ajout d'un périphérique de relais lorsque la machine virtuelle est sous tension.

Les fonctionnalités suivantes sont disponibles pour la prise en charge de l'ajout et de la suppression à chaud des périphériques VMDirectPathI/O.

Ajout à chaud d'un périphérique activé pour le relais à une machine virtuelle par vSphere API. Vous pouvez effectuer l'opération de l'une des manières suivantes :
1. Vous activez le relais pour un périphérique existant qui est détecté au moment du démarrage d'ESXi et ajoutez à chaud le périphérique à la machine virtuelle.
2. Vous pouvez également ajouter à chaud physiquement un nouveau périphérique à un emplacement d'enfichage à chaud PCIe vide de l'hôte, activer le relais du périphérique que vous venez d'ajouter, puis ajouter à chaud le périphérique à la machine virtuelle.
  Note : Cette fonctionnalité nécessite la certification de connexion à chaud native PCIe pour le serveur.
Suppression à chaud d'un périphérique de relais d'une machine virtuelle par vSphere API.
La suppression à chaud surprise d'un périphérique de relais utilisé par une machine virtuelle peut être réalisée en retirant physiquement le périphérique de l'hôte.
Note : Cette fonctionnalité nécessite la certification de connexion à chaud native PCIe surprise pour le serveur.

Note : L'ajout et la suppression à chaud de VMDirectPath I/O ne sont pris en charge que pour les périphériques NVMe. La prise en charge de l'ajout et de la suppression à chaud de VMdirectPathI/O n'est pas disponible dans vSphere Client.

Les fonctionnalités suivantes ne sont pas prises en charge pour les machines virtuelles sur lesquelles la connexion de relais à chaud est activée.

IOMMU (Input–output Memory Management Unit) exposée au système d'exploitation invité.
Connexion CPU à chaud.
Connexion mémoire à chaud.
E/S de chemin direct dynamique.
Prise en charge des machines virtuelles avec un nombre de vCPU > 128.
Les interruptions virtuelles, également appelées publication d'interruption, peuvent être désactivées pour les machines virtuelles sur lesquelles la connexion à chaud du relais est activée.
Le retrait à chaud physique normal du périphérique de relais de l'hôte n'est pas pris en charge.
Prise en charge de l'interface utilisateur pour l'ajout et la suppression à chaud.
Toutes les fonctionnalités qui ne sont pas disponibles avec Direct Path I/O de VM.

Configuration requise pour les plates-formes, les périphériques et les systèmes d'exploitation invités

Configuration requise pour les serveurs et les périphériques

Assurez-vous que la fonctionnalité d'ajout et de suppression à chaud des périphériques VMDirectPath I/O est prise en charge par le fabricant OEM de votre serveur.
Le microprogramme de la plate-forme du serveur doit être UEFI (Unified Extensible Firmware Interface).
Assurez-vous que la plate-forme du serveur et le périphérique sont conformes aux exigences mentionnées dans l'article 2142307 de la base de connaissances.
Le serveur doit être certifié pour Direct Path I/O de la VM.
Pour la suppression à chaud surprise d'un périphérique de relais d'une machine virtuelle, le modèle de serveur doit être certifié pour la connexion à chaud native PCIe surprise.

Note : Pour plus d'informations sur la certification des serveurs, reportez-vous au Guide de compatibilité de VMware.

Configuration requise pour les systèmes d'exploitation invités

Assurez-vous que le système d'exploitation invité prend en charge la connexion à chaud NVMe et la suppression à chaud surprise NVMe.
Utilisez la distribution GOS la plus récente et stable qui contient tous les correctifs de la pile d'E/S du pilote NVMe.

Configuration requise pour vCenter et ESXi

Les versions ESXi et vCenter doivent être 8.0 Update 1 ou version ultérieure.

Limites

Le nombre maximal de périphériques de relais pouvant être ajoutés à chaud dans un seul appel d'API ReconfigureVM est de 1.
Le nombre maximal de périphériques de relais pouvant être supprimés à chaud dans un seul appel d'API ReconfigureVM est de 1.
Les modifications de reconfiguration de machine virtuelle ne peuvent pas être demandées dans le même appel d'API ReconfigureVM lorsque l'ajout ou la suppression à chaud d'un périphérique de relais est demandé.
Le nombre maximal de périphériques de relais NVMe qu'une machine virtuelle peut prendre en charge est de 32.

Activer l'ajout et le retrait à chaud des périphériques VMDirectPath I/O

Vous pouvez activer l'ajout et le retrait à chaud de périphériques VMDirectPath I/O en préparant votre système vCenter et l'hôte ESXi.

Conditions préalables

Préparez l'instance de vCenter et l'hôte ESXi.

Déployez l'instance de vCenter et l'installation avec état de ESXi avec la combinaison de build.
Définissez le paramètre de démarrage VMKernel.
```
set -s maxIntrCookies -v 4096
```
Redémarrer l'hôte ESXi.
Déployez le centre de données et ajoutez l'hôte.

Procédure

Accédez à un hôte dans vSphere Client.
Dans l'onglet Configurer, développez la section Matériel et sélectionnez Périphériques PCI.
Sélectionnez le périphérique NVMe PCI et appuyez sur Basculer le relais.

Que faire ensuite

Préparez et configurez la machine virtuelle.

Préparer et configurer la VM

Les périphériques de relais fournissent les moyens nécessaires pour utiliser les ressources de manière efficace et améliorer les performances de votre environnement. Vous pouvez préparer et configurer votre machine virtuelle.

Déployer et configurer la machine virtuelle (démarrage UEFI)

Procédure

Accédez à la machine virtuelle dans vSphere Client.
1. Pour trouver une machine virtuelle, sélectionnez un centre de données, un dossier, un cluster, un pool de ressources ou un hôte.
2. Cliquez sur l'onglet VM.
Cliquez avec le bouton droit sur la machine virtuelle et sélectionnez Modifier les paramètres.
Développez la section Mémoire et cochez la case Réserver toute la mémoire d'invité (entièrement verrouillée).
Cliquez sur Enregistrer.
Définissez fixedPassthruHotPlugEnabled sur TRUE pour la machine virtuelle à l'aide de vSphere API ReconfigVM_Task() Pour plus d'informations, reportez-vous à la section https://developer.broadcom.com.

Note : Recherchez le terme Hotplug à l'aide de la barre de recherche de https://developer.broadcom.com.
1. Dans vCenter, cliquez avec le bouton droit sur VM → Compatibilité → Mettre à niveau la compatibilité VM sur vmx-20 puis cliquez sur Enregistrer.
2. Définissez motherboardLayout sur ACPI à l'aide de vSphere API. Pour plus d'informations, consultez https://developer.broadcom.com.
  
  Note : Recherchez le terme Hotplug à l'aide de la barre de recherche de https://developer.broadcom.com.
(Facultatif) Ajoutez les périphériques PCI avec relais à la machine virtuelle.
Mettez sous-tension la machine virtuelle.

Note : Vérifiez si l'opération d'opération à chaud en cours a réussi avant de passer à l'opération à chaud suivante.
Effectuez l'ajout et le retrait à chaud de périphériques de relais à l'aide de vSphere API. Pour plus d'informations, consultez https://developer.broadcom.com.

Note : Recherchez le terme Hotplug à l'aide de la barre de recherche de https://developer.vmware.com/samples.

Que faire ensuite

Vérifiez si l'opération d'opération à chaud a réussi.

Vérifier si l'opération d'enfichage à chaud a réussi à l'aide de vSphere Client

Pour vérifier si votre opération d'ajout à chaud, de suppression à chaud ou de suppression à chaud surprise a réussi, vous pouvez utiliser vSphere Client.

Procédure

Localisez la machine virtuelle dans vSphere Client.
Sélectionnez un centre de données, un dossier, un cluster, un pool de ressources ou un hôte, puis cliquez sur l'onglet VM.
Cliquez sur Machines virtuelles, puis cliquez sur la machine virtuelle dans la liste.

Dans le tableau Périphériques PCI, vérifiez les éléments suivants :

Option	Description
Vérifiez si l'ajout à chaud d'un périphérique activé pour le relais à une machine virtuelle à l'aide de vSphere API a réussi.	Le périphérique de relais ajouté à chaud s'affiche.
Vérifiez si la suppression à chaud d'un périphérique de relais d'une machine virtuelle à l'aide de vSphere API a réussi.	Le périphérique de relais supprimé à chaud ne s'affiche pas.
Vérifiez si le retrait à chaud surprise (retrait physique à chaud) d'un périphérique de relais d'une machine virtuelle de l'hôte ESXi a réussi.	Le périphérique supprimé à chaud par surprise ne s'affiche pas. Dans la vue Hôte, Accédez à un hôte dans vSphere Client. Dans l'onglet Configurer, développez la section Matériel, puis cliquez sur Périphériques PCI. Vérifiez que le périphérique supprimé à chaud par surprise ne s'affiche pas.

Vérifier si l'opération d'enfichage à chaud a réussi à l'aide de la VM

Pour vérifier si votre opération d'ajout à chaud, de suppression à chaud ou de suppression à chaud surprise a réussi, vous pouvez utiliser la machine virtuelle.

Procédure

Dans la machine virtuelle, ouvrez une connexion SSH au système d'exploitation invité.
Connectez-vous en tant qu'utilisateur racine.
Exécutez la commande lspci.

Vérifiez les résultats.

Option	Description
Vérifiez si l'ajout à chaud d'un périphérique activé pour le relais à une machine virtuelle à l'aide de vSphere API a réussi.	Le périphérique de relais ajouté à chaud s'affiche. Note : Le périphérique de relais peut avoir une adresse SBDF (Spotfire Binary Data File) différente de celle de l'hôte.
Vérifiez si la suppression à chaud d'un périphérique de relais d'une machine virtuelle à l'aide de vSphere API a réussi.	Le périphérique de relais supprimé à chaud ne s'affiche pas.
Vérifiez si la suppression à chaud surprise (retrait physique à chaud) d'un périphérique de relais d'une machine virtuelle de l'hôte ESXi a réussi.	Le périphérique supprimé à chaud par surprise ne s'affiche pas.