Rozszerzenie sterownika InfiniBand dla systemu Windows

To rozszerzenie instaluje sterowniki InfiniBand ND (dla nieobsługiwanej funkcji SR-IOV) i sterowników OFED (dla rozmiarów SR-IOV) serii H i maszyn wirtualnych serii N z systemem Windows. W zależności od rodziny maszyn wirtualnych rozszerzenie instaluje odpowiednie sterowniki dla karty sieciowej Connect-X.

Rozszerzenie jest również dostępne do instalowania sterowników InfiniBand dla maszyn wirtualnych z systemem Linux.

Wymagania wstępne

System operacyjny

To rozszerzenie obsługuje następujące dystrybucje systemu operacyjnego, w zależności od obsługi sterowników dla określonej wersji systemu operacyjnego. Zwróć uwagę na odpowiednią kartę sieciową InfiniBand dla interesujących rozmiarów maszyn wirtualnych serii H i N.

Dystrybucja	Sterowniki kart interfejsu sieciowego InfiniBand
Windows 10	CX5, CX6
Windows Server 2019	CX5, CX6
Windows Server 2016	CX5, CX6
Windows Server 2012 R2	CX5, CX6

Aby uzyskać najnowszą listę obsługiwanych wersji systemu operacyjnego i sterowników, zobacz resources.json

Łączność z Internetem

Rozszerzenie platformy Microsoft Azure dla sterowników InfiniBand wymaga, aby docelowa maszyna wirtualna została połączona i ma dostęp do Internetu.

Schemat rozszerzenia

Poniższy kod JSON przedstawia schemat rozszerzenia.

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

Właściwości

Nazwisko	Wartość / przykład	Typ danych
apiVersion	2015-06-15	data
wydawca	Microsoft.HpcCompute	string
type	InfiniBandDriverWindows	string
typeHandlerVersion	1.5	int

Wdrożenie

Szablon usługi Azure Resource Manager

Rozszerzenia maszyn wirtualnych platformy Azure można wdrażać za pomocą szablonów usługi Azure Resource Manager. Szablony są idealne podczas wdrażania co najmniej jednej maszyny wirtualnej wymagającej konfiguracji po wdrożeniu.

Konfiguracja JSON rozszerzenia maszyny wirtualnej może być zagnieżdżona wewnątrz zasobu maszyny wirtualnej lub umieszczona na poziomie głównym lub najwyższym szablonu JSON usługi Resource Manager. Umieszczanie konfiguracji JSON wpływa na wartość nazwy i typu zasobu. Aby uzyskać więcej informacji, zobacz Ustawianie nazwy i typu dla zasobów podrzędnych.

W poniższym przykładzie założono, że rozszerzenie jest zagnieżdżone wewnątrz zasobu maszyny wirtualnej. Podczas zagnieżdżania zasobu rozszerzenia kod JSON jest umieszczany w "resources": [] obiekcie maszyny wirtualnej.

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

Program PowerShell

Set-AzVMExtension
    -ResourceGroupName "myResourceGroup" `
    -VMName "myVM" `
    -Location "southcentralus" `
    -Publisher "Microsoft.HpcCompute" `
    -ExtensionName "InfiniBandDriverWindows" `
    -ExtensionType "InfiniBandDriverWindows" `
    -TypeHandlerVersion 1.5 `
    -SettingString '{ `
	}'

Interfejs wiersza polecenia platformy Azure

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

Dodawanie rozszerzenia do zestawu skalowania maszyn wirtualnych

W poniższym przykładzie zainstalowano najnowszą wersję 1.5 InfiniBandDriverWindows na wszystkich maszynach wirtualnych obsługujących funkcję RDMA w istniejącym zestawie skalowania maszyn wirtualnych o nazwie myVMSS wdrożonym w grupie zasobów o nazwie 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 "*"

Rozwiązywanie problemów i pomoc techniczna

Rozwiązywanie problemów

Dane dotyczące stanu wdrożeń rozszerzeń można pobrać z witryny Azure Portal i przy użyciu programu Azure PowerShell i interfejsu wiersza polecenia platformy Azure. Aby wyświetlić stan wdrożenia rozszerzeń dla danej maszyny wirtualnej, uruchom następujące polecenie.

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

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

Dane wyjściowe wykonywania rozszerzenia są rejestrowane w następującym pliku. Zapoznaj się z tym plikiem, aby śledzić stan instalacji, a także rozwiązać problemy z błędami.

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

Kody zakończenia

W poniższej tabeli opisano znaczenie i zalecaną akcję na podstawie kodów zakończenia procesu instalacji rozszerzenia.

Kod błędu	Znaczenie	Możliwe działanie
0	Operacja powiodła się
3010	Operacja powiodła się. Wymagany jest ponowny rozruch.
100	Operacja nie jest obsługiwana lub nie można jej ukończyć.	Możliwe przyczyny: wersja programu PowerShell nie jest obsługiwana, rozmiar maszyny wirtualnej nie jest maszyną wirtualną z obsługą protokołu InfiniBand, niepowodzenie pobierania danych. Sprawdź pliki dziennika, aby określić przyczynę błędu.
240, 840	Limit czasu operacji.	Ponów próbę wykonania operacji.
-1	Wystąpił wyjątek.	Sprawdź pliki dziennika, aby określić przyczynę wyjątku.

Pomoc techniczna

Jeśli potrzebujesz więcej pomocy w dowolnym momencie tego artykułu, możesz skontaktować się z ekspertami platformy Azure na forach MSDN Azure i Stack Overflow. Alternatywnie możesz zgłosić zdarzenie pomocy technicznej za pośrednictwem witryny pomoc techniczna platformy Azure. Aby uzyskać informacje na temat korzystania z pomocy technicznej platformy Azure, zapoznaj się z często zadawanymi pytaniami dotyczącymi usługi Microsoft pomoc techniczna platformy Azure.

Następne kroki

Aby uzyskać więcej informacji na temat maszyn wirtualnych z włączoną obsługą protokołu InfiniBand ('r'), zobacz Maszyny wirtualne serii H i N.