InfiniBand-drivrutinstillägg för Linux

Artikel
08/25/2024

Det här tillägget installerar InfiniBand OFED-drivrutiner på InfiniBand- och SR-IOV-aktiverade HB-serier och virtuella datorer i N-serien som kör Linux. Beroende på vm-familjen installerar tillägget lämpliga drivrutiner för Connect-X-nätverkskortet. Den installerar inte InfiniBand ND-drivrutinerna på de icke-SR-IOV-aktiverade virtuella datorerna i HB-serien och N-serien .

Instruktioner för manuell installation av OFED-drivrutiner finns i Aktivera InfiniBand på virtuella HPC-datorer.

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

Förutsättningar

Operativsystem

Det här tillägget stöder följande os-distributioner, beroende på drivrutinsstöd för specifika operativsystemversioner. Den senaste listan över operativsystems- och drivrutinsversioner som stöds finns i resources.json

Distribution	Version	InfiniBand NIC-drivrutiner
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

Viktigt!

Det här dokumentet refererar till en versionsversion av Linux som närmar sig eller vid End of Life (EOL). Överväg att uppdatera till en mer aktuell version.

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": "InfiniBandDriverLinux",
    "typeHandlerVersion": "1.2",
    "autoUpgradeMinorVersion": true,
    "settings": {
    }
  }
}

Egenskaper

Name	Värde/exempel	Datatyp
apiVersion	2015-06-15	datum
förläggare	Microsoft.HpcCompute	sträng
type	InfiniBandDriverLinux	sträng
typeHandlerVersion	1.2	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": "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

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

I följande exempel installeras det senaste version 1.2 InfiniBandDriverLinux-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 "InfiniBandDriverLinux" -Publisher "Microsoft.HpcCompute" -Type "InfiniBandDriverLinux" -TypeHandlerVersion "1.2"
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.

/var/log/azure/ib-vmext-status

Slutkoder

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

Avsluta kod	Innebörd	Möjlig åtgärd
0	Åtgärden lyckades
1	Felaktig användning av tillägget	Kontrollera körningsutdataloggen
10	Linux Integration Services för Hyper-V och Azure är inte tillgängliga eller installerade	Kontrollera utdata från lspci
11	Mellanox InfiniBand hittades inte i den här VM-storleken	Använda en vm-storlek och ett operativsystem som stöds
12	Bilderbjudandet stöds inte
13	Vm-storlek stöds inte	Använd en InfiniBand-aktiverad (r-storlek) H-serie och N-seriens virtuella dator i N-serienför att distribuera
14	Åtgärden misslyckades	Kontrollera körningsutdataloggen

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 HB-serien och virtuella datorer i N-serien .

Läs mer om tillägg och funktioner för virtuella Linux-datorer

Dela via