Extensie van AMD GPU-stuurprogramma voor Linux
Let op
In dit artikel wordt verwezen naar CentOS, een Linux-distributie die de status End Of Life (EOL) nadert. Houd rekening met uw gebruik en plan dienovereenkomstig. Zie de Richtlijnen voor het einde van de levensduur van CentOS voor meer informatie.
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 Verbinding maken-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 | CX3-Pro, CX5, CX6 |
| CentOS | 7.4, 7.5, 7.6, 7.7, 7.8, 7.9, 8.1, 8,2 | 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 |
| Publisher | 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).