InfiniBand-drivrutinstillägg för Windows

Artikel
08/03/2023

Det här tillägget installerar InfiniBand ND-drivrutiner (för icke-SR-IOV-aktiverade) och OFED-drivrutiner (för SR-IOV-aktiverade) (r-storlekar) H-serien och virtuella datorer i N-serien som kör Windows. Beroende på VM-familjen installerar tillägget lämpliga drivrutiner för Connect-X-nätverkskortet.

Det finns också ett tillägg för att installera InfiniBand-drivrutiner för virtuella Linux-datorer.

Förutsättningar

Operativsystem

Det här tillägget stöder följande OS-distributioner, beroende på drivrutinsstöd för specifika operativsystemversioner. Observera lämpligt InfiniBand-nätverkskort för de virtuella datorstorlekarna i H- och N-serien av intresse.

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

Den senaste listan över operativsystems- och drivrutinsversioner som stöds finns i resources.json

Internetanslutning

Microsoft Azure-tillägget för InfiniBand-drivrutiner kräver att den virtuella måldatorn är ansluten till och har åtkomst till Internet.

Tilläggsschema

Följande JSON visar schemat för tillägget.

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

Egenskaper

Name	Värde/exempel	Datatyp
apiVersion	2015-06-15	datum
utgivare	Microsoft.HpcCompute	sträng
typ	InfiniBandDriverWindows	sträng
typeHandlerVersion	1.5	int

Distribution

Azure Resource Manager-mall

Azure VM-tillägg kan distribueras med Azure Resource Manager-mallar. Mallar är idealiska när du distribuerar en eller flera virtuella datorer som kräver konfiguration efter distributionen.

JSON-konfigurationen för ett tillägg för virtuella datorer kan kapslas i den virtuella datorresursen eller placeras på rot- eller översta nivån i en Resource Manager JSON-mall. Placeringen av JSON-konfigurationen påverkar värdet för resursnamnet och typen. Mer information finns i Ange namn och typ för underordnade resurser.

I följande exempel förutsätter vi att tillägget är kapslat i den virtuella datorresursen. När tilläggsresursen kapslas placeras JSON i den "resources": [] virtuella datorns objekt.

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

Lägga till tillägg i en VM-skalningsuppsättning

I följande exempel installeras det senaste version 1.5 InfiniBandDriverWindows-tillägget på alla RDMA-kompatibla virtuella datorer i en befintlig VM-skalningsuppsättning med namnet myVMSS distribuerad i resursgruppen med namnet 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 "*"

Felsökning och support

Felsöka

Data om tillståndet för tilläggsdistributioner kan hämtas från Azure Portal och med hjälp av Azure PowerShell och Azure CLI. Om du vill se distributionstillståndet för tillägg för en viss virtuell dator kör du följande kommando.

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

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

Utdata för tilläggskörning loggas i följande fil. Referera till den här filen för att spåra status för installationen samt för felsökning av eventuella fel.

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

Slutkoder

I följande tabell beskrivs innebörden och den rekommenderade åtgärden baserat på slutkoderna för tilläggsinstallationsprocessen.

Felkod	Innebörd	Möjlig åtgärd
0	Åtgärden lyckades
3010	Åtgärden lyckades. Omstart krävs.
100	Åtgärden stöds inte eller kunde inte slutföras.	Möjliga orsaker: PowerShell-versionen stöds inte, VM-storleken är inte en InfiniBand-aktiverad virtuell dator, det gick inte att ladda ned data. Kontrollera loggfilerna för att fastställa orsaken till felet.
240, 840	Tidsgräns för åtgärd.	Försök igen.
-1	Ett undantagsfel uppstod.	Kontrollera loggfilerna för att fastställa orsaken till undantaget.

Support

Om du behöver mer hjälp när som helst i den här artikeln kan du kontakta Azure-experterna på MSDN Azure- och Stack Overflow-forumen. Du kan också skicka in en supportincident via Azure Support-webbplatsen. Information om hur du använder Azure Support finns i Vanliga frågor och svar om Microsoft Azure Support.

Nästa steg

Mer information om InfiniBand-aktiverade (r-storlekar) finns i H-serien och virtuella datorer i N-serien .

Dela via