Extensão dos Controladores InfiniBand para Windows

Artigo
08/25/2024

Esta extensão instala drivers InfiniBand ND (para não SR-IOV habilitado) e drivers OFED (para SR-IOV-enabled) (tamanhos 'r') VMs série H e série N executando Windows. Dependendo da família VM, a extensão instala os drivers apropriados para a placa de rede Connect-X.

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

Pré-requisitos

Sistema operativo

Esta extensão suporta as seguintes distros do SO, dependendo do suporte do driver para a versão específica do SO. Observe a NIC InfiniBand apropriada para os tamanhos de VM das séries H e N de interesse.

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

Para obter a lista mais recente de versões de SO e controladores suportados, consulte resources.json

Ligação à 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	data
editora	Microsoft.HpcCompute	string
tipo	InfiniBandDriverWindows	string
typeHandlerVersion	1.5	número inteiro

Implementação

Modelo do Azure Resource Manager

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

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

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

O exemplo a seguir instala a versão mais recente 1.5 da extensão InfiniBandDriverWindows em todas as VMs compatíveis com RDMA em um conjunto de escala de máquina virtual 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

Resolver problemas

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

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. Consulte este arquivo para acompanhar o status da instalação, bem como para solucionar 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 de Erro	Significado	Ação possível
0	Operação bem-sucedida
3010	Operação bem-sucedida. Reinicialização necessária.
100	Operação não suportada ou não pôde ser concluída.	Causas possíveis: Versão do PowerShell não suportada, tamanho da VM não é uma VM habilitada para InfiniBand, Falha ao baixar dados. Verifique os arquivos de log para determinar a causa do erro.
240, 840	Tempo limite de operação.	Operação de nova tentativa.
-1	Ocorreu uma exceção.	Verifique os arquivos de log para determinar a causa da exceção.

Suporte

Se precisar de mais ajuda em qualquer ponto deste artigo, entre em contato com os especialistas do Azure nos fóruns MSDN Azure e Stack Overflow. Como alternativa, você pode registrar um incidente de suporte por meio do site de suporte do Azure. Para obter informações sobre como usar o Suporte do Azure, leia as Perguntas frequentes de suporte do Microsoft Azure.

Próximos passos

Para obter mais informações sobre tamanhos habilitados para InfiniBand ('r'), consulte VMs das séries H e N .

Partilhar via