Nexus Network Fabric のケーブルを検証する

この記事では、ファブリック ケーブルの検証について説明します。ここでの診断 API の主な機能は、すべてのファブリック デバイスで潜在的なケーブル接続の問題をチェックすることです。 診断 API は、相互接続されたデバイスが部品表 (BOM) に準拠しているかどうかを評価し、それらが準拠デバイスか非準拠デバイスかを分類します。 結果は JSON 形式で作成され、検証状態、エラー、識別子の種類、近隣デバイス ID などの詳細が含まれます。 これらの結果は、顧客が指定したストレージ アカウントに格納されます。 クラスターのデプロイ手順に進む前に、このレポートで特定されたエラーを解決することは、デプロイ全体にとって重要です。

前提条件

  • Nexus Network Fabric が正常にプロビジョニングされていることを確認します。
  • サポート チケットを使って、書き込みアクセス権を持つ Network Fabric ID とストレージ URL を指定します。

Note

ストレージ 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 が成功したか失敗したかを示します。

    Note

    この操作は、ラックの数に基づいて完了するまで約 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 
                      } 
                    } 
                  ] 
                },

顧客のエッジから Top-of-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 
                          } 
                        } 
                      ]

検証の状態

状態の種類 Definition
対応 状態が BOM 仕様に準拠している場合
非準拠 状態が BOM 仕様に準拠していない場合
Unknown 状態が不明な場合

検証属性

Attribute Definition
deviceConfiguration デバイスで使用できる構成。
error デバイスからのエラー
reason このフィールドは、デバイスの状態が不明な場合に設定されます。
validationType このパラメーターは、検証の種類を示します。 (ケーブルおよびケーブル仕様の検証)
deviceDestinationResourceId 接続されている近隣 (宛先デバイス) の Azure Resource Manager ID
roleName Network Fabric デバイス (CE または TOR) の役割

ケーブル検証に関する既知の問題と制限事項

  • TOR とコンピューティング サーバー間の検証後の接続はサポートされていません。
  • Arista からの "show lldp neighbors" はサポートされていないため、NPB のケーブル検証はサポートされていません。
  • ストレージ URL は、Network Fabric とは異なるリージョンに存在する必要があります。 たとえば、ファブリックが米国東部でホストされている場合、ストレージ URL は米国東部以外である必要があります。
  • ケーブル検証は、4 ラックと 8 ラックの BOM の両方をサポートします。

ストレージ URL を生成する

コンテナーを作成する方法については、コンテナーの作成に関する説明を参照してください。

Note

小文字のみを使ってコンテナーの名前を入力します。

コンテナーの SAS URL を作成する方法については、共有アクセス署名の生成に関する説明を参照してください。 SAS の書き込みアクセス許可を指定します。

Note

ESAS URL の有効期間は短いです。 既定では、有効期限は 8 時間に設定されます。 SAS URL の有効期限が切れた場合は、Microsoft サポート チケットを開いて新しい URL を追加する必要があります。