適用於 Windows 的 InfiniBand 驅動程式擴充功能
此延伸模組會安裝 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 支援常見問題集。