Extensão de driver InfiniBand para Windows

Artigo
08/03/2023

Essa extensão instala os drivers InfiniBand ND (para os drivers não habilitados para SR-IOV) e OFED (habilitados para SR-IOV) (tamanhos 'r') das VMs série H e série N que executam o Windows. Dependendo da família de VMs, a extensão instala os drivers apropriados para a NIC Connect-X.

Uma extensão também está disponível para instalar os drivers InfiniBand para VMs Linux.

Pré-requisitos

Sistema operacional

Esta extensão é compartível com as seguintes distribuições do sistema operacional, dependendo do suporte do driver para uma versão específica do sistema operacional. Observe a NIC InfiniBand apropriada para os tamanhos de VM da série H e N de interesse.

Distribuição	Drivers de NIC InfiniBand
Windows 10	CX5, CX6
Windows Server 2019	CX5, CX6
Windows Server 2016	CX5, CX6
Windows Server 2012 R2	CX5, CX6

Para ver a lista mais recente das versões compatíveis do sistema operacional e do driver, confira resources.json

Conectividade com a Internet

A extensão do Microsoft Azure para drivers InfiniBand requer que a VM de destino esteja conectada e tenha acesso à Internet.

Esquema de extensão

O JSON a seguir mostra o esquema para a extensão.

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

Propriedades

Nome	Valor/Exemplo	Tipo de Dados
apiVersion	2015-06-15	date
publicador	Microsoft.HpcCompute	string
type	InfiniBandDriverWindows	string
typeHandlerVersion	1.5	INT

Implantação

Modelo do Azure Resource Manager

Extensões de VM do Azure podem ser implantadas com modelos do Azure Resource Manager. Modelos são ideais ao implantar uma ou mais máquinas virtuais que exigem configuração pós-implantação.

A configuração do JSON para uma extensão da máquina virtual pode ser aninhado dentro do recurso de máquina virtual ou localizado no nível de raiz ou superior de um modelo JSON do Resource Manager. O posicionamento da configuração do JSON afeta o valor do tipo e nome do recurso. Para obter mais informações, consulte Definir o nome e o tipo de recursos filho.

O exemplo a seguir pressupõe que a extensão está aninhada dentro do recurso de máquina virtual. Ao aninhar o recurso de extensão, o JSON é colocado no objeto "resources": [] da máquina 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 '{ `
	}'

CLI do Azure

az vm extension set \
  --resource-group myResourceGroup \
  --vm-name myVM \
  --name InfiniBandDriverWindows \
  --publisher Microsoft.HpcCompute \
  --version 1.5

Adicionar extensão a um conjunto de dimensionamento de máquinas virtuais

O seguinte exemplo instala a extensão InfiniBandDriverWindows mais recente da versão 1.5 em todas as VMs compatíveis com RDMA em um conjunto de dimensionamento de máquinas virtuais existente chamado myVMSS implantado no grupo de recursos chamado 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 "*"

Solução de problemas e suporte

Solucionar problemas

Os dados sobre o estado das implantações de extensão podem ser recuperados no Portal do Azure usando o Azure PowerShell e a CLI do Azure. Para ver o estado da implantação das extensões de uma determinada VM, execute o comando a seguir.

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

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

A saída de execução da extensão é registrada no arquivo a seguir. Confira este arquivo para acompanhar o status de instalação, bem como para solucionar problemas de quaisquer falhas.

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

Códigos de saída

A tabela a seguir descreve o significado e a ação recomendada com base nos códigos de saída do processo de instalação da extensão.

Código do Erro	Significado	Ação possível
0	Operação concluída com êxito
3010	Operação concluída com êxito. É necessário reiniciar.
100	Operação sem suporte ou não pôde ser concluída.	Possíveis causas: não há suporte para a versão do PowerShell, o tamanho da VM não é uma VM habilitada para InfiniBand, Falha ao fazer download de dados. Verifique os arquivos de log para determinar a causa do erro.
240, 840	Tempo limite da operação.	Operação de teste.
-1	Exceção ocorreu.	Verifique os arquivos de log para determinar a causa da exceção.

Suporte

Caso precise de mais ajuda em qualquer ponto deste artigo, entre em contato com os especialistas do Azure nos fóruns do Azure e do Stack Overflow no MSDN. Como alternativa, você pode arquivar um incidente de suporte por meio do site de Suporte do Azure. Para saber mais sobre como usar o suporte do Azure, leia as Perguntas frequentes sobre o suporte do Microsoft Azure.

Próximas etapas

Para obter mais informações VMs habilitadas para InfiniBand (tamanho 'r'), consulte VMs Série H e Série N.