Nexus 네트워크 패브릭용 케이블 유효성 검사

이 문서에서는 진단 API의 기본 함수가 모든 패브릭 디바이스에 잠재적인 케이블 연결 문제가 있는지 유효성을 검사하는 Fabric 케이블 유효성 검사에 대해 설명합니다. 진단 API는 상호 연결된 디바이스가 BOM(제품 구성 정보)을 준수하는지 평가하여 규격 또는 비규격으로 분류합니다. 결과는 유효성 검사 상태, 오류, 식별자 형식, 인접 디바이스 ID 등의 세부 정보를 포함하는 JSON 형식으로 표시됩니다. 이러한 결과는 고객이 제공한 스토리지 계정에 저장됩니다. 클러스터 배포 단계로 이동하기 전에 이 보고서에서 식별된 오류를 해결하는 것이 전체 배포에 매우 중요합니다.

필수 조건

  • Nexus 네트워크 패브릭이 성공적으로 프로비전되었는지 확인합니다.
  • 지원 티켓을 통해 쓰기 권한이 있는 네트워크 패브릭 ID와 스토리지 URL을 제공합니다.

참고 항목

스토리지 URL(SAS)은 수명이 짧습니다. 기본적으로 8시간 후에 만료되도록 설정되어 있습니다. SAS URL이 만료되면 패브릭을 다시 패치해야 합니다.

케이블 연결 유효성 검사

  1. 다음 Azure CLI 명령을 실행합니다.

    az networkfabric fabric validate-configuration –resource-group "<NFResourceGroupName>" --resource-name "<NFResourceName>" --validate-action "Cabling" --no-wait --debug  
    

    다음(잘린) 출력이 나타납니다. 프라이빗 미리 보기를 통해 URL을 복사합니다. URL의 이 부분은 다음 단계에서 작업 상태를 확인하는 데 사용됩니다.

    https://management.azure.com/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/providers/Microsoft.ManagedNetworkFabric/locations/EASTUS2EUAP/operationStatuses/59fdc0c8-eeb1-4258-9163-3cf096490148*A9E6DB3DF5C58D67BD395F7A608C056BC8219C392CC1CE0AD22E4C36D70CEE5C?api-version=2022-01-15-privatepreview&t=638485032018035520&c=MIIHHjCCBgagAwIBAgITfwKWMg6goKCq4WwU2AAEApYyDjANBgkqhkiG9w0BAQsFADBEMRMwEQYKCZImiZPyLGQBGRYDR0JMMRMwEQYKCZImiZPyLGQBGRYDQU1FMRgwFgYDVQQDEw9BTUUgSW5mcmEgQ0EgMDIwHhcNMjQwMTMwMTAzMDI3WhcNMjUwMTI0MTAzMDI3WjBAMT4wPAYDVQQDEzVhc3luY29wZXJhdGlvbnNpZ25pbmdjZXJ0aWZpY2F0ZS5tYW5hZ2VtZW50LmF6dXJlLmNvbTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBALMk1pBZQQoNY8tos8XBaEjHjcdWubRHrQk5CqKcX3tpFfukMI0_PVZK-Kr7xkZFQTYp_ItaM2RPRDXx-0W9-mmrUBKvdcQ0rdjcSXDek7GvWS29F5sDHojD1v3e9k2jJa4cVSWwdIguvXmdUa57t1EHxqtDzTL4WmjXitzY8QOIHLMRLyXUNg3Gqfxch40cmQeBoN4rVMlP31LizDfdwRyT1qghK7vgvworA3D9rE00aM0n7TcBH9I0mu-96JE0gSX1FWXctlEcmdwQmXj_U0sZCu11_Yr6Oa34bmUQHGc3hDvO226L1Au-QsLuRWFLbKJ-0wmSV5b3CbU1kweD5LUCAwEAAaOCBAswggQHMCcGCSsGAQQBgjcVCgQaMBgwCgYIKwYBBQUHAwEwCgYIKwYBBQUHAwIwPQYJKwYBBAGCNxUHBDAwLgYmKwYBBAGCNxUIhpDjDYTVtHiE8Ys-
    
    
  2. 다음 명령을 실행하여 작업 상태를 프로그래밍 방식으로 확인할 수 있습니다.

    az rest -m get -u "<Azure-AsyncOperation-endpoint url>" 
    

    작업 상태는 API의 성공 또는 실패 여부를 나타냅니다.

    참고 항목

    작업은 랙 수에 따라 대략 20~40분 정도 소요됩니다.

  3. 스토리지 URL에서 유효성 검사된 결과를 다운로드하고 읽습니다.

출력 예는 다음 섹션에 표시됩니다.

CE(고객 에지)에서 PE(공급자 에지)로의 유효성 검사 출력 예

networkFabricInfoSkuId": "M8-A400-A100-C16-ab", 
  "racks": [ 
    { 
      "rackId": "AR-SKU-10005", 
      "networkFabricResourceId": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx/resourceGroups/ResourceGroupName/providers/Microsoft.managedNetworkFabric/networkFabrics/NFName", 
      "rackInfo": { 
        "networkConfiguration": { 
          "configurationState": "Succeeded", 
          "networkDevices": [ 
            { 
              "name": "AR-CE1", 
              "deviceSourceResourceId": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx/resourceGroups/ResourceGroupName/providers/Microsoft.ManagedNetworkFabric/networkDevices/NFName-AggrRack", 
              "roleName": "CE1", 
              "deviceSku": "DCS-XXXXXXXXX-36", 
              "deviceSN": "XXXXXXXXXXX", 
              "fixedInterfaceMaps": [ 
                { 
                  "name": "Ethernet1/1", 
                  "description": "AR-CE1:Et1/1 to PE1:EtXX", 
                  "deviceConnectionDescription": "SourceHostName:Ethernet1/1 to DestinationHostName:Ethernet", 
                  "sourceHostname": "SourceHostName", 
                  "sourcePort": "Ethernet1/1", 
                  "destinationHostname": "DestinationHostName", 
                  "destinationPort": "Ethernet", 
                  "identifier": "Ethernet1", 
                  "interfaceType": "Ethernet", 
                  "deviceDestinationResourceId": null, 
                  "speed in Gbps": "400", 
                  "cableSpecification": { 
                    "transceiverType": "400GBASE-FR4", 
                    "transceiverSN": "XKT220900XXX", 
                    "cableSubType": "AOC", 
                    "modelType": "AOC-D-D-400G-10M", 
                    "mediaType": "Straight" 
                  }, 
                  "validationResult": [ 
                    { 
                      "validationType": "CableValidation", 
                      "status": "Compliant", 
                      "validationDetails": { 
                        "deviceConfiguration": "Device Configuration detail", 
                        "error": null, 
                        "reason": null 
                      } 
                    }, 
                    { 
                      "validationType": "CableSpecificationValidation", 
                      "status": "Compliant", 
                      "validationDetails": { 
                        "deviceConfiguration": "Speed: 400 ; MediaType : Straight", 
                        "error": "null", 
                        "reason": null 
                      } 
                    } 
                  ] 
                },

고객 Edge to Top of the Rack 스위치 유효성 검사

{ 
                      "name": "Ethernet11/1", 
                      "description": "AR-CE2:Et11/1 to CR1-TOR1:Et24", 
                      "deviceConnectionDescription": " SourceHostName:Ethernet11/1 to DestinationHostName:Ethernet24", 
                      "sourceHostname": "SourceHostName", 
                      "sourcePort": "Ethernet11/1", 
                      "destinationHostname": "DestinationHostName ", 
                      "destinationPort": "24", 
                      "identifier": "Ethernet11", 
                      "interfaceType": "Ethernet", 
                      "deviceDestinationResourceId": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx/resourceGroups/ResourceGroupName/providers/Microsoft.ManagedNetworkFabric/networkDevices/ NFName-CompRack", 
                      "speed in Gbps": "400", 
                      "cableSpecification": { 
                        "transceiverType": "400GBASE-AR8", 
                        "transceiverSN": "XYL221911XXX", 
                        "cableSubType": "AOC", 
                        "modelType": "AOC-D-D-400G-10M", 
                        "mediaType": "Straight" 
                      }, 
                      "validationResult": [ 
                        { 
                          "validationType": "CableValidation", 
                          "status": "Compliant", 
                          "validationDetails": { 
                            "deviceConfiguration": "Device Configuration detail", 
                            "error": null, 
                            "reason": null 
                          } 
                        }, 
                        { 
                          "validationType": "CableSpecificationValidation", 
                          "status": "Compliant", 
                          "validationDetails": { 
                            "deviceConfiguration": "Speed: 400 ; MediaType : Straight", 
                            "error": "", 
                            "reason": null 
                          } 
                        } 
                      ]

유효성 검사 상태

Status Type 정의
준수 상태가 BOM 사양을 준수하는 경우
비준수 상태가 BOM 사양을 준수하지 않는 경우
Unknown 상태를 알 수 없는 경우

유효성 검사 특성

Attribute 정의
deviceConfiguration 디바이스에서 사용할 수 있는 구성입니다.
error 디바이스 오류
reason 이 필드는 디바이스 상태를 알 수 없는 경우 채워집니다.
validationType 이 매개 변수는 유효성 검사 형식을 나타냅니다. (케이블 및 케이블 사양 유효성 검사)
deviceDestinationResourceId 연결된 이웃(대상 디바이스)의 Azure Resource Manager ID
roleName 네트워크 패브릭 디바이스(CE 또는 TOR)의 역할

케이블 유효성 검사의 알려진 문제 및 제한 사항

  • TOR과 컴퓨팅 서버 간의 사후 유효성 검사 연결은 지원되지 않습니다.
  • Arista에서 "lldp 인접 항목 표시"를 지원하지 않기 때문에 NPB에 대한 케이블 유효성 검사는 지원되지 않습니다.
  • 스토리지 URL은 네트워크 패브릭과 다른 지역에 있어야 합니다. 예를 들어, Fabric이 미국 동부에서 호스트되는 경우 스토리지 URL은 미국 동부 외부에 있어야 합니다.
  • 케이블 유효성 검사는 4개의 랙 BOM과 8개의 랙 BOM을 모두 지원합니다.

스토리지 URL 생성

컨테이너를 만들려면 컨테이너 만들기를 참조하세요.

참고 항목

컨테이너 이름은 소문자로만 입력합니다.

컨테이너의 SAS URL을 만들려면 공유 액세스 서명 생성을 참조하세요. SAS에 대한 쓰기 권한을 제공합니다.

참고 항목

ESAS URL은 수명이 짧습니다. 기본적으로 8시간 후에 만료되도록 설정되어 있습니다. SAS URL이 만료되면 Microsoft 지원 티켓을 열어 새 URL을 추가해야 합니다.