InfiniBand-Treibererweiterung für Windows

Artikel
08/03/2023

Diese Erweiterung installiert InfiniBand ND-Treiber (für nicht SR-IOV-fähige) und OFED-Treiber (für SR-IOV-fähige) („r“-Größen) für virtuelle Computer der H-Serie und N-Serie unter Windows. Je nach VM-Familie installiert die Erweiterung die entsprechenden Treiber für die Connect-X-NIC.

Außerdem ist eine Erweiterung zur Installation der InfiniBand-Treiber für Linux-VMs verfügbar.

Voraussetzungen

Betriebssystem

Diese Erweiterung unterstützt die folgenden Betriebssystem-Distributionen, abhängig von der Treiberunterstützung für bestimmte BS-Versionen. Notieren Sie sich die jeweilige InfiniBand-NIC für die relevanten VM-Größen der H- und N-Serie.

Distribution	InfiniBand-NIC-Treiber
Windows 10	CX5, CX6
Windows Server 2019	CX5, CX6
Windows Server 2016	CX5, CX6
Windows Server 2012 R2	CX5, CX6

Die aktuelle Liste der unterstützten Betriebssysteme und Treiberversionen finden Sie unter resources.json.

Internetkonnektivität

Die Microsoft Azure-Erweiterung für InfiniBand-Treiber erfordert, dass der virtuelle Zielcomputer mit dem Internet verbunden ist und Zugriff hat.

Erweiterungsschema

Der folgende JSON-Code zeigt das Schema für die Erweiterung.

{
  "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": {
    }
  }
}

Eigenschaften

Name	Wert/Beispiel	Datentyp
apiVersion	2015-06-15	date
publisher	Microsoft.HpcCompute	Zeichenfolge
type	InfiniBandDriverWindows	Zeichenfolge
typeHandlerVersion	1.5	INT

Bereitstellung

Azure Resource Manager-Vorlage

Azure-VM-Erweiterungen können mithilfe von Azure Resource Manager-Vorlagen bereitgestellt werden. Vorlagen sind ideal, wenn Sie virtuelle Computer bereitstellen, die nach der Bereitstellung konfiguriert werden müssen.

Die JSON-Konfiguration für eine VM-Erweiterung kann innerhalb der VM-Ressource geschachtelt oder im Stamm bzw. auf der obersten Ebene einer Resource Manager-JSON-Vorlage platziert werden. Die Platzierung der JSON-Konfiguration wirkt sich auf den Wert von Name und Typ der Ressource aus. Weitere Informationen finden Sie unter Set name and type for child resources (Festlegen von Name und Typ für untergeordnete Ressourcen).

Im folgenden Beispiel wird davon ausgegangen, dass die Erweiterung in der VM-Ressource geschachtelt ist. Beim Schachteln der Ressource für die Erweiterung wird der JSON-Code im "resources": []-Objekt des virtuellen Computers platziert.

{
  "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-Befehlszeilenschnittstelle

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

Hinzufügen einer Erweiterung zu einer VM-Skalierungsgruppe

Durch folgendes Beispiel wird die neueste Version (1.5) der Erweiterung „InfiniBandDriverWindows“ auf allen RDMA-fähigen VMs in einer vorhandenen VM-Skalierungsgruppe mit dem Namen myVMSS installiert, die in der Ressourcengruppe mit dem Namen myResourceGroup bereitgestellt wurde:

$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 "*"

Problembehandlung und Support

Problembehandlung

Daten zum Status von Erweiterungsbereitstellungen können über das Azure-Portal und mithilfe von Azure PowerShell und der Azure-Befehlszeilenschnittstelle abgerufen werden. Führen Sie den folgenden Befehl aus, um den Bereitstellungsstatus von Erweiterungen für einen bestimmten virtuellen Computer anzuzeigen.

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

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

Die Ausgabe der Erweiterungsausführung wird in der folgenden Datei protokolliert. In dieser Datei finden Sie Informationen zum Nachverfolgen des Status von Installationen sowie zur Problembehandlung.

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

Exitcodes

Die folgende Tabelle beschreibt die Bedeutung und empfohlene Aktionen basierend auf Exitcodes des Installationsprozesses für die Erweiterung.

Fehlercode	Bedeutung	Mögliche Aktion
0	Vorgang erfolgreich
3010	Vorgang erfolgreich. Es ist ein Neustart erforderlich.
100	Der Vorgang wird nicht unterstützt oder konnte nicht abgeschlossen werden.	Mögliche Ursachen: PowerShell-Version nicht unterstützt, VM-Größe ist keine InfiniBand-fähige VM, Fehler beim Herunterladen von Daten. Überprüfen Sie die Protokolldateien, um die Ursache des Fehlers zu ermitteln.
240, 840	Timeout bei Vorgang.	Wiederholen Sie den Vorgang.
-1	Ausnahme.	Überprüfen Sie die Protokolldateien, um die Ursache der Ausnahme zu ermitteln.

Support

Sollten Sie beim Lesen dieses Artikels feststellen, dass Sie weitere Hilfe benötigen, können Sie sich über das MSDN Azure-Forum oder über das Stack Overflow-Forum mit Azure-Experten in Verbindung setzen. Alternativ können Sie auf der Website des Azure-Supports einen Supportfall erstellen. Informationen zur Nutzung von Azure-Support finden Sie unter Microsoft Azure-Support-FAQ.

Nächste Schritte

Weitere Informationen zu VMs mit InfiniBand-Aktivierung (r-Größen) finden Sie unter H-Serie und N-Serie.

Share via