Share via


Extensie van AMD GPU-stuurprogramma voor Linux

Deze extensie installeert InfiniBand OFED-stuurprogramma's op InfiniBand- en SR-IOV-enabled ('r'-grootten) HB-serie en VM's uit de N-serie waarop Linux wordt uitgevoerd. Afhankelijk van de VM-familie installeert de extensie de juiste stuurprogramma's voor de Connect-X NIC. De InfiniBand ND-stuurprogramma's worden niet geïnstalleerd op de VM's uit de niet-SR-IOV-serie en N-serie.

Instructies voor handmatige installatie van de OFED-stuurprogramma's zijn beschikbaar in InfiniBand inschakelen op HPC-VM's.

Er is ook een extensie beschikbaar voor het installeren van InfiniBand-stuurprogramma's voor Windows-VM's.

Vereisten

Besturingssysteem

Deze extensie ondersteunt de volgende distributies van het besturingssysteem, afhankelijk van stuurprogrammaondersteuning voor specifieke versie van het besturingssysteem. Raadpleeg resources.json voor de meest recente lijst met ondersteunde besturingssysteem- en stuurprogrammaversies

Distributie Versie InfiniBand NIC-stuurprogramma's
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

Belangrijk

Dit document verwijst naar een releaseversie van Linux die bijna of aan het einde van de levensduur (EOL) nadert. Overweeg om bij te werken naar een recentere versie.

Verbinding met internet

De Microsoft Azure-extensie voor InfiniBand-stuurprogramma's vereist dat de doel-VM is verbonden met en toegang heeft tot internet.

Extensieschema

In de volgende JSON ziet u het schema voor de extensie.

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

Eigenschappen

Naam Waarde/voorbeeld Gegevenstype
apiVersion 2015-06-15 datum
uitgever Microsoft.HpcCompute tekenreeks
type InfiniBandDriverLinux tekenreeks
typeHandlerVersion 1.2 int

Implementatie

Azure Resource Manager-sjabloon

Azure VM-extensies kunnen worden geïmplementeerd met Azure Resource Manager-sjablonen. Sjablonen zijn ideaal bij het implementeren van een of meer virtuele machines waarvoor configuratie na de implementatie is vereist.

De JSON-configuratie voor een virtuele-machineextensie kan worden genest in de virtuele-machineresource of op het hoogste niveau van een Resource Manager JSON-sjabloon worden geplaatst. De plaatsing van de JSON-configuratie is van invloed op de waarde van de resourcenaam en het type. Zie Naam en type instellen voor onderliggende resources voor meer informatie.

In het volgende voorbeeld wordt ervan uitgegaan dat de extensie is genest binnen de resource van de virtuele machine. Bij het nesten van de extensieresource wordt de JSON in het "resources": [] object van de virtuele machine geplaatst.

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

Extensie toevoegen aan een virtuele-machineschaalset

In het volgende voorbeeld wordt de nieuwste versie 1.2 InfiniBandDriverLinux-extensie geïnstalleerd op alle vm's die geschikt zijn voor RDMA in een bestaande virtuele-machineschaalset met de naam myVMSS geïmplementeerd in de resourcegroep met de naam 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 "*"

Problemen met en ondersteuning oplossen

Problemen oplossen

Gegevens over de status van extensie-implementaties kunnen worden opgehaald uit Azure Portal en met behulp van Azure PowerShell en Azure CLI. Voer de volgende opdracht uit om de implementatiestatus van extensies voor een bepaalde VM te zien.

Get-AzVMExtension -ResourceGroupName myResourceGroup -VMName myVM -Name myExtensionName
az vm extension list --resource-group myResourceGroup --vm-name myVM -o table

Uitvoer van extensie-uitvoer wordt vastgelegd in het volgende bestand. Raadpleeg dit bestand om de status van de installatie bij te houden en om eventuele fouten op te lossen.

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

Afsluitcodes

In de volgende tabel worden de betekenis en aanbevolen actie beschreven op basis van de afsluitcodes van het installatieproces van de extensie.

Afsluitcode Betekenis Mogelijke actie
0 De bewerking is voltooid
1 Onjuist gebruik van extensie Uitvoerlogboek voor uitvoering controleren
10 Linux Integration Services voor Hyper-V en Azure is niet beschikbaar of geïnstalleerd Uitvoer van lspci controleren
11 Mellanox InfiniBand is niet gevonden op deze VM-grootte Een ondersteunde VM-grootte en een ondersteund besturingssysteem gebruiken
12 Afbeeldingsaanbieding wordt niet ondersteund
13 VM-grootte wordt niet ondersteund Een vm uit de N-serie met infiniBand-functionaliteit ('r' grootte) en N-seriegebruiken om te implementeren
14 Bewerking mislukt Uitvoerlogboek voor uitvoering controleren

Ondersteuning

Als u op elk gewenst moment in dit artikel meer hulp nodig hebt, kunt u contact opnemen met de Azure-experts op de MSDN Azure- en Stack Overflow-forums. U kunt ook een ondersteuningsincident indienen via de ondersteuning voor Azure-site. Lees de veelgestelde vragen over microsoft ondersteuning voor Azure voor informatie over het gebruik van Azure-ondersteuning.

Volgende stappen

Zie VM's uit de HB-serie en N-serie voor meer informatie over infiniBand-grootten ('r'-grootten).