Расширение драйвера InfiniBand для Windows

Статья
08/25/2024

Это расширение устанавливает драйверы InfiniBand ND (для устройств, не поддерживающих SR-IOV) и драйверы OFED (для виртуальных машин с поддержкой SR-IOV) (размер r)серий H и N под управлением Windows. В зависимости от семейства виртуальных машин расширение устанавливает соответствующие драйверы для сетевого адаптера Connect-X.

Расширение также доступно для установки драйверов InfiniBand для виртуальных машин Linux.

Необходимые компоненты

Операционная система

Это расширение поддерживает указанные ниже дистрибутивы, в зависимости от поддержки драйвера в конкретной версии ОС. Обратите внимание на соответствующий сетевой адаптер InfiniBand для виртуальных машин серии H и N выбранного размера.

Распределение	Драйверы сетевого адаптера InfiniBand
Windows 10	CX5, CX6
Windows Server 2019	CX5, CX6
Windows Server 2016	CX5, CX6
Windows Server 2012 R2	CX5, CX6

Актуальный список поддерживаемых версий ОС и драйверов см. в разделе resources.json

Подключение к Интернету

Для работы расширения Microsoft Azure для драйверов InfiniBand требуется, чтобы целевая виртуальная машина была подключена к Интернету.

Схема расширения

В следующем коде 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": {
    }
  }
}

Свойства

Имя.	Значение и пример	Тип данных
версия_API	15.06.2015	Дата
издатель	Microsoft.HpcCompute	строка
type	InfiniBandDriverWindows	строка
typeHandlerVersion	1.5	INT

Развертывание

Шаблон Azure Resource Manager

Расширения виртуальной машины Azure можно развернуть с помощью шаблонов Azure Resource Manager. Шаблоны идеально подходят для развертывания одной или нескольких виртуальных машин, требующих настройки после развертывания.

Конфигурацию JSON для расширения виртуальной машины можно вложить в ресурс виртуальной машины или поместить в корень или на верхний уровень JSON-файла шаблона Resource Manager. Размещение конфигурации JSON влияет на значения имени и типа ресурса. Дополнительные сведения см. в разделе Указание имени и типа дочернего ресурса в шаблоне Resource Manager.

В следующем примере предполагается, что расширение виртуальной машины расположено в ресурсе виртуальной машины. При вложении ресурса расширения 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

Добавление расширения в масштабируемый набор виртуальных машин

В следующем примере показана установка последней версии 1.5 расширения InfiniBandDriverWindows на всех виртуальных машинах с поддержкой RDMA в существующем масштабируемом наборе виртуальных машин с именем myVMSS, развернутом в группе ресурсов 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 "*"

Устранение неполадок и поддержка

Устранение неполадок

Сведения о состоянии развертывания расширения можно получить на портале Azure, а также с помощью Azure PowerShell или Azure CLI. Чтобы просмотреть состояние развертывания расширений для определенной виртуальной машины, выполните следующую команду.

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 не поддерживается, размер виртуальной машины отличается от размера виртуальной машины с поддержкой InfiniBand, сбой при загрузке данных. Проверьте файлы журнала, чтобы определить причину ошибки.
240, 840	Время ожидания операции истекло.	Повторите операцию.
-1	Возникло исключение.	Проверьте файлы журнала, чтобы определить причину исключения.

Поддержка

Если в любой момент при изучении этой статьи вам потребуется дополнительная помощь, вы можете обратиться к экспертам по Azure на форумах MSDN Azure и Stack Overflow. Кроме того, можно зарегистрировать обращение в службу поддержки на сайте поддержки Azure. Дополнительные сведения об использовании службы поддержки Azure см. в статье Часто задаваемые вопросы о поддержке Microsoft Azure.

Следующие шаги

Дополнительные сведения о виртуальных машинах (размер r) с поддержкой InfiniBand см. в статье "Виртуальные машины серий H и N".

Поделиться через