Extensie van AMD GPU-stuurprogramma voor Windows

Artikel
06/01/2023

Deze extensie installeert InfiniBand ND-stuurprogramma's (voor niet-SR-IOV ingeschakeld) en OFED-stuurprogramma's (voor SR-IOV-ingeschakeld) ('r'-grootten) H-serie en N-serie VM's met Windows. Afhankelijk van de VM-familie installeert de extensie de juiste stuurprogramma's voor de Connect-X NIC.

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

Vereisten

Besturingssysteem

Deze extensie ondersteunt de volgende distributies van het besturingssysteem, afhankelijk van stuurprogramma-ondersteuning voor specifieke versie van het besturingssysteem. Noteer de juiste InfiniBand-NIC voor de VM-grootten uit de H- en N-serie.

Distributie	InfiniBand NIC-stuurprogramma's
Windows 10	CX5, CX6
Windows Server 2019	CX5, CX6
Windows Server 2016	CX5, CX6
Windows Server 2012 R2	CX5, CX6

Raadpleeg resources.json voor de meest recente lijst met ondersteunde versies van besturingssystemen en stuurprogramma's

Internetconnectiviteit

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

Eigenschappen

Naam	Waarde/voorbeeld	Gegevenstype
apiVersion	2015-06-15	datum
publisher	Microsoft.HpcCompute	tekenreeks
type	InfiniBandDriverWindows	tekenreeks
typeHandlerVersion	1,5	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-machine-extensie kan worden genest in de resource van de virtuele machine of op het hoofd- of 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 in 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": "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

Extensie toevoegen aan een virtuele-machineschaalset

In het volgende voorbeeld wordt de meest recente versie 1.5 InfiniBandDriverWindows-extensie geïnstalleerd op alle VM's met RDMA-functionaliteit in een bestaande virtuele-machineschaalset met de naam myVMSS die is geïmplementeerd in de resourcegroep met de naam 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 "*"

Problemen oplossen en ondersteuning

Problemen oplossen

Gegevens over de status van extensie-implementaties kunnen worden opgehaald uit de 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 bekijken.

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

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

Uitvoer van extensieuitvoering wordt geregistreerd in het volgende bestand. Raadpleeg dit bestand om de status van de installatie bij te houden en om eventuele fouten op te lossen.

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

Afsluitcodes

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

Foutcode	Betekenis	Mogelijke actie
0	De bewerking is voltooid
3010	De bewerking is voltooid. Opnieuw opstarten vereist.
100	De bewerking wordt niet ondersteund of kan niet worden voltooid.	Mogelijke oorzaken: PowerShell-versie wordt niet ondersteund, VM-grootte is geen vm met InfiniBand, fout bij het downloaden van gegevens. Controleer de logboekbestanden om de oorzaak van de fout vast te stellen.
240, 840	Time-out van bewerking.	Bewerking opnieuw proberen.
-1	Er is een uitzondering opgetreden.	Controleer de logboekbestanden om de oorzaak van de uitzondering vast te stellen.

Ondersteuning

Als u op enig punt 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 H-serie en N-serie voor meer informatie over InfiniBand-enabled ('r'-grootten).