適用於 Windows 的 InfiniBand 驅動程式擴充功能

發行項
08/25/2024

此延伸模組會安裝 InfiniBand ND 驅動程式 (適用於非 SR-IOV 啟用) 和 OFED 驅動程式 (適用於啟用 SR-IOV 的大小) H 系列和 N 系列執行 Windows 的 VM。視 VM 系列而定，此擴充功能會為 Connect-X NIC 安裝適當的驅動程式，

擴充功能也可用來安裝適用於 Linux VM 的 InfiniBand 驅動程式。

必要條件

作業系統

此擴充功能支援下列 OS 發行版，視特定 OS 版本的驅動程式支援而定。請記下適用於感興趣的 H 和 N 系列 VM 大小的適當 InfiniBand NIC。

Distribution	InfiniBand NIC 驅動程式
Windows 10	CX5, CX6
Windows Server 2019	CX5, CX6
Windows Server 2016	CX5, CX6
Windows Server 2012 R2	CX5, CX6

如需支援的作業系統和驅動程式版本的最新清單，請參閱 resources.json

網際網路連線能力

適用於 InfiniBand 驅動程式的 Microsoft Azure 擴充功能會要求目標 VM 連線到網際網路並擁有存取權。

擴充功能結構描述

下列 JSON 會顯示擴充功能的結構描述。

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

屬性

名稱	值 / 範例	資料類型
apiVersion	2015-06-15	date
publisher	Microsoft.HpcCompute	string
type	InfiniBandDriverWindows	string
typeHandlerVersion	1.5	int

部署

Azure Resource Manager 範本

也可以使用 Azure Resource Manager 範本部署 Azure VM 擴充功能。部署一或多部需要部署後設定的虛擬機器時，很適合使用範本。

虛擬機器擴充功能的 JSON 設定可以巢狀方式置於虛擬機器資源內部，或放在 Resource Manager JSON 範本的根目錄或最上層。 JSON 設定的放置會影響資源名稱和類型的值。如需詳細資訊，請參閱設定子資源的名稱和類型。

下列範例假設擴充功能以巢狀方式置於虛擬機器資源內部。在巢狀處理擴充資源時，JSON 會放在虛擬機器的 "resources": [] 物件中。

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

將擴充功能新增至虛擬機器擴展集

下列範例會在名為 myResourceGroup 的資源群組中部署的名為 myVMSS 的現有虛擬機器擴展集中的所有 RDMA 功能型 VM 上，安裝最新版本 1.5 InfiniBandDriverWindows 擴充功能：

$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 "*"

疑難排解與支援

疑難排解

使用 Azure PowerShell 和 Azure CLI，就可以從 Azure 入口網站擷取有關擴充功能部署狀態的資料。若要查看指定 VM 的擴充功能部署狀態，請執行下列命令。

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

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

擴充功能執行輸出會記錄至下列檔案。請參閱此檔案追蹤安裝狀態，並針對任何失敗進行疑難排解。

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

結束代碼

下表按照擴充功能安裝程序的結束代碼來說明代表意義和建議動作。

錯誤碼	意義	可能的動作
0	作業已順利完成
3010	作業成功。需要重新開機。
100	不支援或無法完成作業。	可能原因：PowerShell 版本不受支援、VM 大小不是已啟用 InfiniBand VM、資料下載失敗。請檢查記錄檔，以判斷錯誤的成因。
240、840	作業逾時。	重試作業。
-1	發生例外狀況。	請檢查記錄檔，以判斷例外狀況的成因。

支援

如果您在本文中有任何需要協助的地方，您可以連絡 MSDN Azure 和 Stack Overflow 論壇上的 Azure 專家。或者，您可以透過 Azure 支援網站提出支援事件。如需使用 Azure 支援的資訊，請參閱 Microsoft Azure 支援常見問題集。

下一步

如需已啟用 InfiniBand ('r' 規格) 的詳細資訊，請參閱 H 系列和 N 系列 VM。

共用方式為