InfiniBand-drivrutinstillägg för Windows

Artikel
08/25/2024

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) virtuella datorer i H-serien och 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 datorerna 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

Internet-anslutning

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
förläggare	Microsoft.HpcCompute	sträng
type	InfiniBandDriverWindows	sträng
typeHandlerVersion	1.5	heltal

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 en virtuell dator kan kapslas i den virtuella datorresursen eller placeras på rot- eller toppnivå 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ätts att tillägget är kapslat i resursen för den virtuella datorn. När du kapslade tilläggsresursen placeras JSON i objektet för den "resources": [] virtuella datorn.

{
  "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 till 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 som distribuerats 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-portalen 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 till följande fil. Se den här filen för att spåra status för installationen samt för att felsöka 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 undantag inträffade.	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-supportwebbplatsen. 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 Virtuella datorer i H-serien och N-serien .

Dela via