Windows 用の InfiniBand ドライバー拡張機能

この拡張機能により、InfiniBand ND ドライバー (SR-IOV 以外が有効な場合) および OFED ドライバー (SR-IOV が有効な場合) が、Windows を実行している InfiniBand と SR-IOV 対応 ('r' サイズ) の H シリーズと N シリーズの 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

サポートされている OS とドライバーのバージョンの最新の一覧については、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": {
    }
  }
}

Properties

名前	値/例	データ型
apiVersion	2015-06-15	date
publisher	Microsoft.HpcCompute	string
type	InfiniBandDriverWindows	string
typeHandlerVersion	1.5	INT

デプロイ

Azure Resource Manager テンプレート

Azure VM 拡張機能は、Azure Resource Manager テンプレートでデプロイできます。 テンプレートは、デプロイ後の構成が必要な仮想マシンを 1 つ以上デプロイするときに最適です。

仮想マシン拡張機能の 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 portal から取得することも、Azure PowerShell、Azure CLI を使用して取得することもできます。 特定の 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 サポートに関する FAQ」を参照してください。

次のステップ

InfiniBand 対応 ('r' サイズ) の詳細については、H シリーズと N シリーズの VM を参照してください。