Ekstensi Driver InfiniBand untuk Windows

Ekstensi ini menginstal driver ND InfiniBand (untuk non-SR-IOV) dan driver OFED (untuk SR-IOV) (ukuran 'r') VM H-series dan N-series VM yang menjalankan Windows. Bergantung pada keluarga VM, ekstensi menginstal driver yang sesuai dengan Connect-X NIC.

Ekstensi juga tersedia untuk menginstal driver InfiniBand untuk VM Linux.

Prasyarat

Sistem operasi

Ekstensi ini mendukung distro OS berikut, bergantung pada dukungan driver untuk versi OS tertentu. Perhatikan bahwa InfiniBand NIC yang sesuai untuk ukuran VM H-series dan N-series yang diinginkan.

Distribusi	Driver InfiniBand NIC
Windows 10	CX5, CX6
Server Windows 2019	CX5, CX6
Server Windows 2016	CX5, CX6
Windows Server 2012 R2	CX5, CX6

Untuk daftar terbaru versi OS dan driver yang didukung, lihat resources.json

Konektivitas internet

Ekstensi Microsoft Azure untuk Driver InfiniBand mengharuskan VM target tersambung dan memiliki akses ke internet.

Skema ekstensi

JSON berikut menunjukkan skema ekstensi.

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

Properti

Nama	Nilai / Contoh	Jenis Data
apiVersion	2015-06-15	tanggal
penerbit	Microsoft.HpcCompute	string
jenis	InfiniBandDriverWindows	string
typeHandlerVersion	1.5	int

Penyebaran

Templat Azure Resource Manager

Ekstensi Azure VM dapat disebarkan dengan templat Azure Resource Manager. Template sangat ideal saat menyebarkan satu atau beberapa komputer virtual yang memerlukan konfigurasi pasca penyebaran.

Konfigurasi JSON untuk ekstensi komputer virtual dapat disarangkan di dalam sumber daya komputer virtual, atau ditempatkan di tingkat akar atau teratas templat JSON Azure Resource Manager. Penempatan konfigurasi JSON memengaruhi nilai nama dan jenis sumber daya. Untuk informasi selengkapnya, lihat Set nama dan jenis untuk sumber daya elemen anak.

Contoh berikut mengasumsikan ekstensi bersarang di dalam sumber daya komputer virtual. Saat menyarangkan sumber daya ekstensi, JSON ditempatkan di objek "resources": [] dari komputer virtual.

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

Menambahkan ekstensi ke Set Skala Komputer Virtual

Contoh berikut menginstal ekstensi InfiniBandDriverWindows versi 1.5 terbaru di semua mesin virtual berkemampuan RDMA dalam set skala mesin virtual yang sudah ada bernamamyVMSS yang disebarkan di grup sumber daya bernama 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 "*"

Pecahkan masalah dan dukung

Pecahkan masalah

Data tentang status penyebaran ekstensi dapat diambil dari portal Azure, dan dengan menggunakan Azure PowerShell dan Azure CLI. Untuk melihat status penyebaran ekstensi untuk VM tertentu, jalankan perintah berikut.

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

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

Output eksekusi ekstensi dicatat ke file berikut. Lihat file ini untuk melacak status penginstalan serta memecahkan masalah kegagalan apa pun.

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

Kode keluar

Tabel berikut menjelaskan makna dan tindakan yang direkomendasikan berdasarkan kode keluar dari proses penginstalan ekstensi.

Kode Galat	Makna	Kemungkinan Tindakan
0	Operasi berhasil
3010	Operasi berhasil. Memulai ulang diperlukan.
100	Operasi tak didukung atau tidak dapat diselesaikan.	Kemungkinan penyebab: Versi PowerShell tidak didukung, ukuran VM bukan VM yang didukung InfiniBand, Gagal mengunduh data. Periksa file log untuk menentukan penyebab kesalahan.
240, 840	Waktu operasi habis.	Coba lagi operasi.
-1	Terjadi pengecualian.	Periksa file log untuk menentukan penyebab pengecualian.

Dukungan

Jika memerlukan bantuan lebih lanjut pada titik mana pun dalam artikel ini, Anda dapat menghubungi pakar Azure di Forum MSDN Azure dan Stack Overflow. Atau, Anda dapat mengajukan insiden dukungan melalui situs dukungan Azure. Untuk informasi tentang cara menggunakan Dukungan Azure, baca Tanya Jawab Umum tentang dukungan Microsoft Azure.

Langkah berikutnya

Untuk informasi selengkapnya tentang dukungan InfiniBand (ukuran 'r'), lihat VM H-series dan N-series.