Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Esta extensão instala drivers OFED InfiniBand em máquinas virtuais InfiniBand e SR-IOV ativadas (tamanhos 'r') HB-series e N-series que executam o Linux. Dependendo da família VM, a extensão instala os drivers apropriados para a placa de rede Connect-X. Não instala os drivers InfiniBand ND nas VMs HB-series e N-series que não estão habilitadas para SR-IOV.
Instruções sobre a instalação manual dos drivers OFED estão disponíveis em Ativar InfiniBand em VMs HPC.
Uma extensão também está disponível para instalar drivers InfiniBand para VMs do Windows.
Observação
Experimenta o VM assist para diagnósticos mais rápidos. Recomendamos que execute o VM assist para Windows ou o VM assist para Linux. Essas ferramentas de diagnóstico baseadas em script ajudam você a identificar problemas comuns que afetam o Agente Convidado da VM do Azure e a integridade geral da VM.
Se estiver a experienciar problemas de desempenho com máquinas virtuais, antes de contactar o suporte, execute estas ferramentas.
Pré-requisitos
Sistema Operativo
Esta extensão é compatível com as seguintes distribuições do sistema operativo (SO), dependendo do suporte do driver para uma versão específica do SO. Para obter a lista mais recente de versões de SO e controladores suportados, consulte resources.json
| Distribuição | Versão | Drivers InfiniBand NIC |
|---|---|---|
| Ubuntu | 18,04 LTS, 20,04 LTS, 22,04 LTS | CX3-Pro, CX5, CX6 |
| Red Hat Enterprise Linux | 7.4, 7.5, 7.6, 7.7, 7.8, 7.9, 8.1, 8,2 | CX3-Pro, CX5, CX6 |
Importante
Este documento faz referência a uma versão de lançamento do Linux que está a aproximar-se ou já atingiu o Fim de Vida (EOL). Por favor, considere atualizar para uma versão mais atual.
conectividade 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": "InfiniBandDriverLinux",
"typeHandlerVersion": "1.2",
"autoUpgradeMinorVersion": true,
"settings": {
}
}
}
Propriedades
| Nome | Valor / Exemplo | Tipo de dados |
|---|---|---|
| apiVersion | 2015-06-15 | data |
| editor | Microsoft.HpcCompute | cadeia (de caracteres) |
| tipo | InfiniBandDriverLinux | cadeia (de caracteres) |
| typeHandlerVersion | 1.2 | Int |
Implantaçã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 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": "InfiniBandDriverLinux",
"typeHandlerVersion": "1.2",
"autoUpgradeMinorVersion": true,
"settings": {
}
}
}
PowerShell
Set-AzVMExtension
-ResourceGroupName "myResourceGroup" `
-VMName "myVM" `
-Location "southcentralus" `
-Publisher "Microsoft.HpcCompute" `
-ExtensionName "InfiniBandDriverLinux" `
-ExtensionType "InfiniBandDriverLinux" `
-TypeHandlerVersion 1.2 `
-SettingString '{ `
}'
Azure CLI (Interface de Linha de Comando da Azure)
az vm extension set \
--resource-group myResourceGroup \
--vm-name myVM \
--name InfiniBandDriverLinux \
--publisher Microsoft.HpcCompute \
--version 1.2
Adicionar extensão a um conjunto de dimensionamento de máquina virtual
O exemplo a seguir instala a versão mais recente 1.2 da extensão InfiniBandDriverLinux 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 "InfiniBandDriverLinux" -Publisher "Microsoft.HpcCompute" -Type "InfiniBandDriverLinux" -TypeHandlerVersion "1.2"
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 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.
/var/log/azure/ib-vmext-status
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 saída | Significado | Ação possível |
|---|---|---|
| 0 | Operação bem-sucedida | |
| 1 | Uso incorreto da extensão | Verificar o registo de resultados da execução |
| 10 | Linux Integration Services para Hyper-V e Azure não disponível ou instalado | Verifique a saída de lspci |
| 11 | O Mellanox InfiniBand não foi encontrado neste tamanho de VM | Usar um tamanho de VM e sistema operacional suportados |
| 12 | Oferta de imagem não suportada | |
| 13 | Tamanho da VM não suportado | Utilize uma VM habilitada para InfiniBand (tamanho 'r') série H e série N para implantar |
| 14 | Operação sem sucesso | Verificar o registo de resultados da execução |
Apoio
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 da série HB e da série N.