Linux용 InfiniBand 드라이버 확장
이 확장은 Linux를 실행하는 InfiniBand 및 SR-IOV 사용(‘r’ 크기) HB 시리즈 및 N 시리즈 VM에 InfiniBand OFED 드라이버를 설치합니다. VM 제품군에 따라 확장은 Connect-X NIC에 적절한 드라이버를 설치합니다. 비 SR-IOV 사용 HB 시리즈 및 N 시리즈 VM에는 InfiniBand ND 드라이버를 설치하지 않습니다.
OFED 드라이버의 수동 설치에 대한 지침은 HPC VM에서 InfiniBand 사용에서 확인할 수 있습니다.
Windows VM용 InfiniBand 드라이버를 설치하기 위한 확장도 사용할 수 있습니다.
필수 조건
운영 체제
이 확장은 특정 OS 버전의 드라이버 지원에 따라 다음 OS 배포판을 지원합니다. 지원되는 OS 및 드라이버 버전의 최신 목록은 resources.json을 참조하세요.
| 배포 | 버전 | 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 |
Important
이 문서에서는 EOL(수명 종료)에 도달했거나 근접하는 Linux의 릴리스 버전을 참조합니다. 최신 버전으로 업데이트하는 것이 좋습니다.
인터넷 연결
InfiniBand 드라이버용 Microsoft Azure 확장을 사용하려면 대상 VM이 인터넷에 연결되어 있고 액세스 권한이 있어야 합니다.
확장 스키마
확장에 대한 스키마를 보여 주는 JSON은 다음과 같습니다.
{
"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": {
}
}
}
속성
| 이름 | 값/예제 | 데이터 형식 |
|---|---|---|
| apiVersion | 2015-06-15 | 날짜 |
| publisher | Microsoft.HpcCompute | string |
| type | InfiniBandDriverLinux | string |
| typeHandlerVersion | 1.2 | int |
배포
Azure Resource Manager 템플릿
Azure Resource Manager 템플릿을 사용하여 Azure VM 확장을 배포할 수 있습니다. 배포 후 구성이 필요한 하나 이상의 가상 머신을 배포하는 경우 템플릿을 사용하는 것이 좋습니다.
가상 머신 확장에 대한 JSON 구성은 가상 머신 리소스 내에 중첩되거나 루트 또는 최상위 수준의 Resource Manager JSON 템플릿에 배치될 수 있습니다. JSON 구성의 배치는 리소스 이름 및 형식 값에 영향을 줍니다. 자세한 내용은 자식 리소스의 이름 및 형식 설정을 참조하세요.
다음 예제에서는 확장이 가상 머신 리소스 내에 중첩되어 있다고 가정합니다. 확장 리소스를 중첩하는 경우 JSON은 가상 머신의 "resources": [] 개체에 배치됩니다.
{
"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
az vm extension set \
--resource-group myResourceGroup \
--vm-name myVM \
--name InfiniBandDriverLinux \
--publisher Microsoft.HpcCompute \
--version 1.2
가상 머신 확장 집합에 확장 추가
다음 예제에서는 myResourceGroup이라는 리소스 그룹에 배포된 myVMSS라는 기존 가상 머신 확장 집합의 모든 RDMA 지원 VM에 최신 버전 1.2 InfiniBandDriverLinux 확장을 설치합니다.
$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 "*"
문제 해결 및 지원
문제 해결
확장 배포 상태에 대한 데이터는 Azure Portal에서 Azure PowerShell 및 Azure CLI를 사용하여 검색할 수 있습니다. 지정된 VM에 대한 확장의 배포 상태를 보려면 다음 명령을 실행합니다.
Get-AzVMExtension -ResourceGroupName myResourceGroup -VMName myVM -Name myExtensionName
az vm extension list --resource-group myResourceGroup --vm-name myVM -o table
확장 실행 출력은 다음 파일에 기록됩니다. 설치 상태를 추적하고 오류를 해결하려면 이 파일을 참조하세요.
/var/log/azure/ib-vmext-status
종료 코드
다음 표에서는 확장 설치 프로세스의 종료 코드에 따른 의미와 권장 사항에 대해 설명합니다.
| 종료 코드 | 의미 | 가능한 작업 |
|---|---|---|
| 0 | 작업이 성공했습니다. | |
| 1 | 확장의 사용이 잘못되었습니다. | 실행 출력 로그를 확인합니다. |
| 10 | Hyper-V 및 Azure에 대한 Linux Integration Services를 사용하거나 설치할 수 없습니다. | lspci의 출력을 확인합니다. |
| 11 | 이 VM 크기에서 Mellanox InfiniBand을 찾을 수 없음 | 지원되는 VM 크기 및 OS를 사용합니다. |
| 12 | 지원되지 않는 이미지 제품 | |
| 13 | 지원되지 않는 VM 크기 | InfiniBand 사용('r' 크기) H 시리즈 및 N 시리즈 VM을 사용하여 배포 |
| 14 | 작업 실패 | 실행 출력 로그를 확인합니다. |
지원
이 문서의 어디에서든 도움이 필요한 경우 MSDN Azure 및 Stack Overflow 포럼에서 Azure 전문가에게 문의할 수 있습니다. 또는 Azure 지원 사이트를 통해 지원 인시던트를 제출할 수 있습니다. Azure 지원을 사용하는 방법에 대한 자세한 내용은 Microsoft Azure 지원 FAQ를 참조하세요.