Estensione del driver InfiniBand per Windows

Articolo
06/01/2023

Questa estensione installa i driver ND infiniBand (per i driver non abilitati per SR-IOV) e i driver OFED (per le dimensioni di SR-IOV) (serie H e macchine virtuali serie N che eseguono Windows). A seconda della famiglia di macchine virtuali, l'estensione installa i driver appropriati per la scheda di interfaccia di rete Connect-X.

Un'estensione è disponibile anche per installare i driver InfiniBand per le macchine virtuali Linux.

Prerequisiti

Sistema operativo

Questa estensione supporta le distribuzioni dei sistemi operativi seguenti, in base al supporto dei driver per la versione del sistema operativo specifica. Si noti la scheda di interfaccia di rete InfiniBand appropriata per le dimensioni della macchina virtuale H e serie N di interesse.

Distribuzione	Driver della scheda di interfaccia di rete InfiniBand
Windows 10	CX5, CX6
Windows Server 2019	CX5, CX6
Windows Server 2016	CX5, CX6
R2 per Windows Server 2012	CX5, CX6

Per l'elenco più recente delle versioni del sistema operativo e del driver supportate, vedere resources.json

Connettività Internet

L'estensione di Microsoft Azure per i driver InfiniBand richiede che la macchina virtuale di destinazione sia connessa a e abbia accesso a Internet.

Schema dell'estensione

Il codice JSON riportato di seguito mostra lo schema dell'estensione.

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

Proprietà

Nome	Valore/Esempio	Tipo di dati
apiVersion	2015-06-15	Data
publisher	Microsoft.HpcCompute	string
type	InfiniBandDriverWindows	string
typeHandlerVersion	1.5	INT

Distribuzione

Modello di Azure Resource Manager

Le estensioni macchina virtuale di Azure possono essere distribuite con i modelli di Azure Resource Manager. I modelli rappresentano la scelta migliore quando si distribuiscono una o più macchine virtuali per cui è necessaria una configurazione post-distribuzione.

La configurazione JSON per un'estensione macchina virtuale può essere annidata nella risorsa della macchina virtuale o posizionata nel livello radice o nel livello superiore di un modello JSON di Gestione risorse. Il posizionamento della configurazione JSON influisce sul valore del nome e del tipo di risorsa. Per altre informazioni, vedere Set name and type for child resources (Impostare il nome e il tipo per le risorse figlio).

L'esempio seguente presuppone che l'estensione sia annidata all'interno della risorsa della macchina virtuale. Quando la risorsa di estensione viene nidificata, JSON viene inserito nell'oggetto "resources": [] della macchina virtuale.

{
  "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 '{ `
	}'

Interfaccia della riga di comando di Azure

az vm extension set \
  --resource-group myResourceGroup \
  --vm-name myVM \
  --name InfiniBandDriverWindows \
  --publisher Microsoft.HpcCompute \
  --version 1.5

Aggiungere estensione a un set di scalabilità di macchine virtuali

Nell'esempio seguente viene installata l'estensione InfiniBandDriverWindows più recente versione 1.5 in tutte le macchine virtuali con supporto per RDMA in un set di scalabilità di macchine virtuali esistente denominato myVMSS distribuito nel gruppo di risorse denominato 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 "*"

Risoluzione dei problemi e supporto

Risolvere problemi

I dati sullo stato delle distribuzioni dell'estensione possono essere recuperati nel portale di Azure e tramite il modulo Azure PowerShell e l'interfaccia della riga di comando di Azure. Per visualizzare lo stato di distribuzione delle estensioni per una determinata macchina virtuale, eseguire il comando seguente.

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

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

L'output dell'esecuzione dell'estensione viene registrato nel file seguente. Fare riferimento a questo file per tenere traccia dello stato dell'installazione e per la risoluzione degli errori.

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

Codici di uscita

La tabella seguente descrive il significato e l'azione consigliata in base ai codici di uscita del processo di installazione dell'estensione.

Codice di errore	Significato	Azione possibile
0	Operazione riuscita
3010	Operazione riuscita. Riavvio richiesto.
100	Operazione non supportata o non completata.	Possibili cause: la versione di PowerShell non è supportata, le dimensioni della macchina virtuale non sono una macchina virtuale abilitata per InfiniBand, Errore durante il download dei dati. Controllare i file di log per determinare la causa dell’errore.
240, 840	Timeout dell'operazione.	Ripetere l'operazione.
-1	Si è verificata un'eccezione.	Controllare i file di log per determinare la causa dell'eccezione.

Supporto

Per ricevere assistenza in relazione a qualsiasi punto di questo articolo, contattare gli esperti di Azure nei forum MSDN e Stack Overflow relativi ad Azure. In alternativa, è possibile inviare un evento imprevisto di supporto tramite il sito supporto tecnico di Azure. Per informazioni sull'uso del supporto di Azure, leggere le Domande frequenti sul supporto di Azure.

Passaggi successivi

Per altre informazioni sulle dimensioni di InfiniBand ('r' sizes), vedere Macchine virtuali serie H e serie N .