驗證 Nexus 網路網狀架構的纜線

發行項
12/15/2024

本文說明網狀架構纜線驗證，其中診斷 API 的主要功能是檢查所有網狀架構裝置是否有潛在的纜線問題。診斷 API 會評估互連裝置是否符合材料帳單（BOM），並根據資源庫存單位（SKU），將它們分類為符合規範或不符合規範。裝置類型包括 Customer Edge （CE）、機架頂端（TOR）、管理（MGMT）和網路封包代理程式（NPB）裝置。結果會以 JSON 格式呈現，其中包含驗證狀態、錯誤、標識碼類型和鄰近裝置識別碼等詳細數據。這些結果會儲存在客戶提供的記憶體帳戶中。在移至叢集部署步驟之前，必須解決此報告中所識別錯誤的整體部署。

如需 BOM 詳細數據，請參閱 Azure 操作員 Nexus SKU

必要條件

請確定已成功布建 Nexus Network Fabric。
透過支援票證提供具有寫入存取權的網路網狀架構標識碼和記憶體 URL。
記憶體帳戶具有下列必要條件：
- 記憶體帳戶必須位於與 Network Fabric Azure 區域不同的 Azure 區域中。
- Storage Blob Data Contributor 角色必須指派給 Nexus Network Fabric RP ，且具有指派給記憶體帳戶的存取權。
Microsoft 支援服務必須先使用作用中記憶體 SAS URL 修補 Nexus Network Fabric，才能執行纜線驗證。

建立修補 Nexus 網路網狀架構的 Azure 支援要求：

請參閱如何建立 Azure 支援要求
針對問題輸入 Nexus Network Fabric ，然後按下 Go。
選取 Azure Operator Nexus 作為您遇到問題的服務。
選取 Subscription 資源所在的位置。
選取 General 資源欄位底下，然後按下 Next。
在問題提示字元下選取 Network fabric instance provisioning ，然後按下 Next。
現在，選取 Create a support request 支援刀鋒視窗頂端的。
按兩下 Next 索引標籤 Problem description 。
等候 Recommended solution ，然後按兩下連結回到 [返回支援要求]
再次按下 Next 索引標籤 Problem description 以繼續 Additional details
填寫必要的要求詳細數據以修補 Nexus Network Fabric，然後按兩下 Next
檢閱索引標籤 Review + create 中的資訊，然後按下 Create。

注意

記憶體 URL （SAS）是短期的。根據預設，它會設定為八小時內到期。如果 SAS URL 過期，則必須重新修補網狀架構。

產生記憶體 URL

若要在記憶體帳戶中建立容器，請參閱建立容器

注意

僅使用小寫字母輸入容器的名稱。

若要為容器產生 SAS URL 以提供 Nexus Fabric 的寫入許可權，請參閱產生共用存取簽章

注意

SAS URL 的存留時間很短。根據預設，它會設定為八小時內到期。如果 SAS URL 過期，您必須開啟Microsoft支援票證，才能新增 URL。

驗證纜線

執行下列 Azure CLI 命令：

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

下列（截斷）輸出隨即出現。從 Azure-AsyncOperation 偵錯輸出的區段複製URL。下一個步驟會使用這個部分的 URL 來檢查作業的狀態。

cli.azure.cli.core.sdk.policies:     'Azure-AsyncOperation': '<Azure-AsyncOperation-endpoint url>'

下列錯誤指出網狀架構未使用有效的 SAS URL 進行修補：

azure.core.exceptions.HttpResponseError: Operation returned an invalid status 'OK'

您可以執行下列命令，以程式設計方式檢查作業的狀態：

az rest -m get -u "<Azure-AsyncOperation-endpoint url>" 
{
  "endTime": "<OPERATION_COMPLETION_TIME>",
  "id": "<OPERATION_ID>",
  "name": "OPERATION_NAME",
  "properties": {
    "url": "CABLING_REPORT_STORAGE_URL"
  },
  "resourceId": "<FABRIC_RID>",
  "startTime": "<OPERATION_START_TIME>",
  "status": "Succeeded"
}

作業狀態會指出 API 是否成功或失敗。

注意

作業需要大約 20~40 分鐘的時間，才能根據機架數目來完成。

從 <CABLING_REPORT_STORAGE_URL> 已完成的命令下載並讀取重新微調的已驗證結果。

下列各節會顯示範例輸出。

Customer Edge （CE）至 Provider Edge （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 
                      } 
                    } 
                  ] 
                },

Customer Edge 至機架頂端（TOR）交換器驗證

{ 
                      "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 
                          } 
                        } 
                      ]

驗證的狀態

狀態類型	定義
符合標準	驗證狀態符合介面的 BOM 規格。
NonCompliant	驗證不符合介面的 BOM 規格。
Unknown	驗證無法擷取介面連線詳細數據，或不會傳回 lldp 數據。如果目的地裝置已關閉、遺失、中斷連線或不支援此介面類型，則會 `Unknown` 傳回狀態。

驗證屬性

屬性	定義
`deviceConfiguration`	裝置上可用的設定。
`error`	來自裝置的錯誤。
`reason`	當裝置的狀態不明時，就會填入此欄位。
`validationType`	此參數會指出驗證的類型。（纜線和纜線規格驗證）。
`deviceDestinationResourceId`	已連線芳鄰的 Azure Resource Manager 識別碼（目的地裝置）。
`roleName`	網路網狀架構裝置的角色（CE 或 TOR）。

纜線驗證的已知問題和限制

不支援在 Nexus 叢集中關閉或取消布建的 TOR 與計算伺服器之間的連線纜線驗證。這些介面會在報表中顯示 Unknown 狀態。
不支援在 Nexus 叢集中關閉或取消佈建 MGMT 介面與計算伺服器之間的連線纜線驗證，或不支援計算伺服器控制器。這些介面會在報表中顯示 Unknown 狀態。
和 nni-direct 介面不支援 loopback NPB 的纜線驗證，因為目前show lldp neighbors沒有廠商支援。這些介面會在報表中顯示 Unknown 狀態。
記憶體 URL 必須位於與網路網狀架構不同的區域中。例如，如果網狀架構裝載在美國東部，則記憶體 URL 應位於美國東部以外。
纜線驗證支援每個機架 16 個計算的四個機架，以及 8 個機架，每個機架 BOM 有 16 個計算。
當目的地裝置關閉時，纜線遺失或中斷連線，或介面類型不支持驗證，則介面會顯示 Unknown 狀態。 請務必評估針對 BOM 的所有 Unknown 介面 Not-Connected ，以判斷是否需要修復動作。

一般纜線驗證 `NonCompliant` 和 `Unknown` 問題

validationType	狀態	錯誤	解決方法
CableValidation	`NonCompliant`	`Device cable connection is incorrect.`	確認來源和目的地介面上的連線符合 BOM。 `deviceConfiguration`可協助識別介面上傳回的目的地埠日期。
CableValidation	`Unknown`	`Unable to fetch data from the device.`	確認來源和目的地介面上的連線已連線，並符合 BOM
CableValidation	`NonCompliant`	`Device cabling in <INTERFACE> incorrect.`	介面未連線。確認來源和目的地介面上的連線符合 BOM。
CableValidation	`Unknown`	`Port <INTERFACE> has no connections as per device response.`	確認來源和目的地介面上的連線已連線，並符合 BOM。
CableSpecificationValidation	`Unknown`	`Unable to fetch Interface Status for <INTERFACE>.`	確認來源和目的地介面上的連線已連線，並符合 BOM。
CableSpecificationValidation	`NonCompliant`	`Device cable connection is incorrect`	確認介面卡和纜線符合此介面中的 BOM 規格。

將纜線驗證報告轉換為 HTML 格式

請參閱如何將纜線驗證報告 JSON 輸出轉換成 HTML。

共用方式為

驗證 Nexus 網路網狀架構的纜線

必要條件

建立修補 Nexus 網路網狀架構的 Azure 支援要求：

產生記憶體 URL

驗證纜線

Customer Edge （CE）至 Provider Edge （PE）驗證輸出範例

Customer Edge 至機架頂端（TOR）交換器驗證

驗證的狀態

驗證屬性

纜線驗證的已知問題和限制

一般纜線驗證 `NonCompliant` 和 `Unknown` 問題

將纜線驗證報告轉換為 HTML 格式

意見反應

其他資源

共用方式為

驗證 Nexus 網路網狀架構的纜線

必要條件

建立修補 Nexus 網路網狀架構的 Azure 支援要求：

產生記憶體 URL

驗證纜線

Customer Edge （CE） 至 Provider Edge （PE） 驗證輸出範例

Customer Edge 至機架頂端 （TOR） 交換器驗證

驗證的狀態

驗證屬性

纜線驗證的已知問題和限制

一般纜線驗證 NonCompliant 和 Unknown 問題

將纜線驗證報告轉換為 HTML 格式

意見反應

其他資源

Customer Edge （CE）至 Provider Edge （PE）驗證輸出範例

Customer Edge 至機架頂端（TOR）交換器驗證

一般纜線驗證 `NonCompliant` 和 `Unknown` 問題