Extension du pilote InfiniBand pour Windows

Article
08/26/2024

Cette extension permet d’installer les pilotes InfiniBand ND (pour les machines non compatibles SR-IOV) et les pilotes OFED (pour les machines compatibles SR-IOV) [tailles « r »] de la série H et de la série N sous Windows. En fonction de la famille de machines virtuelles, l’extension installe les pilotes appropriés pour la carte réseau Connect-X.

Une extension est également disponible pour installer les pilotes InfiniBand pour les machines virtuelles Linux.

Prérequis

Système d’exploitation

Cette extension prend en charge les distributions suivantes de système d’exploitation, en fonction de la prise en charge par le pilote de la version spécifique du système d’exploitation. Notez la carte réseau InfiniBand appropriée pour les tailles de machines virtuelles des séries H et N.

Distribution	Pilotes de carte réseau InfiniBand
Windows 10	CX5, CX6
Windows Server 2019	CX5, CX6
Windows Server 2016	CX5, CX6
Windows Server 2012 R2	CX5, CX6

Pour obtenir la dernière liste des versions de pilote et de système d’exploitation prises en charge, consultez ressources.json

Connectivité Internet

L’extension Microsoft Azure pour les pilotes InfiniBand nécessite que la machine virtuelle cible soit connectée à Internet et dispose d’un accès.

Schéma d’extensions

Le JSON suivant illustre le schéma pour l’extension.

{
  "name": "<myExtensionName>",
  "type": "extensions",
  "apiVersion": "2015-06-15",
  "location": "<location>",
  "dependsOn": [
    "[concat('Microsoft.Compute/virtualMachines/', <myVM>)]"
  ],
  "properties": {
    "publisher": "Microsoft.HpcCompute",
    "type": "InfiniBandDriverWindows",
    "typeHandlerVersion": "1.5",
    "autoUpgradeMinorVersion": true,
    "settings": {
    }
  }
}

Propriétés

Nom	Valeur/Exemple	Type de données
apiVersion	2015-06-15	Date
publisher	Microsoft.HpcCompute	string
type	InfiniBandDriverWindows	string
typeHandlerVersion	1.5	int

Déploiement

Modèle Azure Resource Manager

Les extensions de machines virtuelles Azure peuvent être déployées avec des modèles Azure Resource Manager. Les modèles sont idéaux lorsque vous déployez une ou plusieurs machines virtuelles nécessitant une configuration post-déploiement.

La configuration JSON pour une extension de machine virtuelle peut être imbriquée à l’intérieur de la ressource de machine virtuelle ou placée à la racine ou au niveau supérieur d’un modèle de Resource Manager JSON. Le positionnement de la configuration JSON affecte la valeur du nom de la ressource et son type. Pour plus d’informations, consultez Définition du nom et du type des ressources enfants.

L’exemple suivant suppose que l’extension est imbriquée dans la ressource de machine virtuelle. Lors de l’imbrication de la ressource d’extension, le JSON est placé dans l’objet "resources": [] de la machine virtuelle.

{
  "name": "myExtensionName",
  "type": "extensions",
  "location": "[resourceGroup().location]",
  "apiVersion": "2015-06-15",
  "dependsOn": [
    "[concat('Microsoft.Compute/virtualMachines/', myVM)]"
  ],
  "properties": {
    "publisher": "Microsoft.HpcCompute",
    "type": "InfiniBandDriverWindows",
    "typeHandlerVersion": "1.5",
    "autoUpgradeMinorVersion": true,
    "settings": {
    }
  }
}

PowerShell

Set-AzVMExtension
    -ResourceGroupName "myResourceGroup" `
    -VMName "myVM" `
    -Location "southcentralus" `
    -Publisher "Microsoft.HpcCompute" `
    -ExtensionName "InfiniBandDriverWindows" `
    -ExtensionType "InfiniBandDriverWindows" `
    -TypeHandlerVersion 1.5 `
    -SettingString '{ `
	}'

Azure CLI

az vm extension set \
  --resource-group myResourceGroup \
  --vm-name myVM \
  --name InfiniBandDriverWindows \
  --publisher Microsoft.HpcCompute \
  --version 1.5

Ajouter une extension à un groupe de machines virtuelles identiques

L’exemple suivant installe la dernière version 1.5 de l’extension InfiniBandDriverWindows sur toutes les machines virtuelles prenant en charge RDMA dans un groupe de machines virtuelles identiques existant, nommé myVMSS et déployé dans le groupe de ressources nommé myResourceGroup :

$VMSS = Get-AzVmss -ResourceGroupName "myResourceGroup" -VMScaleSetName "myVMSS"
Add-AzVmssExtension -VirtualMachineScaleSet $VMSS -Name "InfiniBandDriverWindows" -Publisher "Microsoft.HpcCompute" -Type "InfiniBandDriverWindows" -TypeHandlerVersion "1.5"
Update-AzVmss -ResourceGroupName "myResourceGroup" -VMScaleSetName "MyVMSS" -VirtualMachineScaleSet $VMSS
Update-AzVmssInstance -ResourceGroupName "myResourceGroup" -VMScaleSetName "myVMSS" -InstanceId "*"

Dépannage et support technique

Dépanner

Vous pouvez récupérer les données sur l’état des déploiements d’extension à partir du portail Azure, ainsi qu’à l’aide d’Azure PowerShell et de l’interface de ligne de commande Azure. Pour afficher l’état du déploiement des extensions pour une machine virtuelle donnée, exécutez la commande suivante.

Get-AzVMExtension -ResourceGroupName myResourceGroup -VMName myVM -Name myExtensionName

az vm extension list --resource-group myResourceGroup --vm-name myVM -o table

La sortie de l’exécution de l’extension est enregistrée dans le fichier suivant. Consultez ce fichier pour suivre l’état de l’installation, ainsi que pour résoudre les éventuels échecs.

C:\WindowsAzure\Logs\Plugins\Microsoft.HpcCompute.InfiniBandDriverWindows\

Codes de sortie

Le tableau suivant explique la signification et décrit l’action recommandée en fonction des codes de sortie du processus d’installation de l’extension.

Code d'erreur	Signification	Action possible
0	L’opération a réussi
3010	L’opération a réussi. Redémarrage requis.
100	L’opération n’est pas prise en charge ou n’a pas pu être effectuée.	Causes possibles : La version de PowerShell n’est pas prise en charge, la taille de machine virtuelle indique qu’il ne s’agit pas d’une machine virtuelle compatible avec InfiniBand, le téléchargement des données a échoué. Vérifiez les fichiers journaux pour déterminer la cause de l’erreur.
240, 840	Délai d’expiration de l’opération.	Réessayez l’opération.
-1	Une exception s’est produite.	Vérifiez les fichiers journaux pour déterminer la cause de l’exception.

Support

Si vous avez besoin d’une aide supplémentaire à quelque étape que ce soit dans cet article, vous pouvez contacter les experts Azure sur les forums MSDN Azure et Stack Overflow. Vous pouvez également déposer une demande d’assistance via le site du support Azure. Pour plus d’informations sur l’utilisation du support Azure, lisez le FAQ du support Microsoft Azure.

Étapes suivantes

Pour plus d’informations sur les tailles compatibles avec InfiniBand (tailles « r »), consultez les machines virtuelles de série H et de série N.

Partage via