Extension du pilote InfiniBand pour Linux
Cette extension permet d’installer les pilotes OFED InfiniBand sur des machines virtuelles de la série HB et de la série N compatibles SR-IOV et InfiniBand [tailles « r »] sous Linux. En fonction de la famille de machines virtuelles, l’extension installe les pilotes appropriés pour la carte réseau Connect-X. Elle n’installe pas les pilotes InfiniBand ND sur les machines virtuelles non-SR-IOV des séries HB et N.
Des instructions sur l’installation manuelle des pilotes OFED sont disponibles dans Activer InfiniBand sur des machines virtuelles HPC.
Une extension est également disponible pour installer les pilotes InfiniBand pour les machines virtuelles Windows.
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. Pour obtenir la dernière liste des versions de pilote et de système d’exploitation prises en charge, consultez ressources.json
| Distribution | Version | Pilotes de carte réseau InfiniBand |
|---|---|---|
| Ubuntu | 18.04 LTS, 20.04 LTS, 22.04 LTS | CX3-Pro, CX5, CX6 |
| Red Hat Enterprise Linux | 7.4, 7.5, 7.6, 7.7, 7.8, 7.9, 8.1, 8.2 | CX3-Pro, CX5, CX6 |
Important
Ce document fait référence à une version de Linux qui approche ou est en fin de vie (EOL). Envisagez une mise à jour vers une version plus récente.
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": "InfiniBandDriverLinux",
"typeHandlerVersion": "1.2",
"autoUpgradeMinorVersion": true,
"settings": {
}
}
}
Propriétés
| Nom | Valeur/Exemple | Type de données |
|---|---|---|
| apiVersion | 2015-06-15 | Date |
| publisher | Microsoft.HpcCompute | string |
| type | InfiniBandDriverLinux | string |
| typeHandlerVersion | 1.2 | 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": "InfiniBandDriverLinux",
"typeHandlerVersion": "1.2",
"autoUpgradeMinorVersion": true,
"settings": {
}
}
}
PowerShell
Set-AzVMExtension
-ResourceGroupName "myResourceGroup" `
-VMName "myVM" `
-Location "southcentralus" `
-Publisher "Microsoft.HpcCompute" `
-ExtensionName "InfiniBandDriverLinux" `
-ExtensionType "InfiniBandDriverLinux" `
-TypeHandlerVersion 1.2 `
-SettingString '{ `
}'
Azure CLI
az vm extension set \
--resource-group myResourceGroup \
--vm-name myVM \
--name InfiniBandDriverLinux \
--publisher Microsoft.HpcCompute \
--version 1.2
Ajouter une extension à un groupe de machines virtuelles identiques
L’exemple suivant installe la version 1.2 de l’extension InfiniBandDriverLinux sur toutes les machines virtuelles RDMA d’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 "InfiniBandDriverLinux" -Publisher "Microsoft.HpcCompute" -Type "InfiniBandDriverLinux" -TypeHandlerVersion "1.2"
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.
/var/log/azure/ib-vmext-status
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 de sortie | Signification | Action possible |
|---|---|---|
| 0 | L’opération a réussi | |
| 1 | Utilisation incorrecte de l’extension | Vérifiez le journal de sortie de l’exécution |
| 10 | Les services d’intégration Linux pour Hyper-V et Azure ne sont pas disponibles ou installés | Vérifiez la sortie de lspci |
| 11 | Mellanox InfiniBand introuvable sur cette taille de machine virtuelle | Utilisez une taille de machine virtuelle et un système d’exploitation pris en charge |
| 12 | Offre d’image non prise en charge | |
| 13 | Taille de machine virtuelle non prise en charge | Utilisez une machine virtuelle de série H et de série N compatible InfiniBand (taille « r ») à déployer |
| 14 | Échec de l’opération | Vérifiez le journal de sortie de l’exécution |
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 HB et de série N.