驗證 Nexus 網路網狀架構的纜線
本文說明網狀架構纜線驗證,其中診斷 API 的主要功能是檢查所有網狀架構裝置是否有潛在的纜線問題。 診斷 API 會評估互連裝置是否符合「材料帳單」(BOM),將其分類為符合規範或不符合規範。 結果會以 JSON 格式呈現,其中包含驗證狀態、錯誤、標識碼類型和鄰近裝置識別碼等詳細數據。 這些結果會儲存在客戶提供的 儲存體 帳戶中。 在移至叢集部署步驟之前,必須解決此報告中所識別錯誤的整體部署。
必要條件
- 請確定已成功布建 Nexus Network Fabric。
- 透過支援票證提供具有寫入存取權的網路網狀架構標識碼和記憶體 URL。
注意
儲存體 URL (SAS) 是短期的。 根據預設,它會設定為八小時內到期。 如果 SAS URL 過期,則必須重新修補網狀架構。
驗證纜線
執行下列 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-
您可以執行下列命令,以程式設計方式檢查作業的狀態:
az rest -m get -u "<Azure-AsyncOperation-endpoint url>"
作業狀態會指出 API 是否成功或失敗。
注意
作業需要大約 20~40 分鐘的時間,才能根據機架數目來完成。
從記憶體 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 至機架交換器驗證的頂端
{
"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 規格時 |
不符合標準 | 當狀態不符合 BOM 規格時 |
Unknown | 當狀態未知時 |
驗證屬性
屬性 | 定義 |
---|---|
deviceConfiguration |
裝置上可用的設定。 |
error |
來自裝置的錯誤 |
reason |
當裝置的狀態不明時,就會填入此欄位。 |
validationType |
此參數會指出驗證的類型。 (纜線和纜線規格驗證) |
deviceDestinationResourceId |
已連線芳鄰的 Azure Resource Manager 識別碼(目的地裝置) |
roleName |
網路網狀架構裝置的角色(CE 或 TOR) |
纜線驗證的已知問題和限制
- 不支援 TOR 與計算伺服器之間的驗證後 連線。
- 不支援 NPB 的纜線驗證,因為 Arista 不支援 “show lldp neighbors”。
- 儲存體 URL 必須位於網路網狀架構的不同區域中。 例如,如果網狀架構裝載在美國東部,則記憶體 URL 應位於美國東部以外。
- 纜線驗證同時支援四個機架和八個機架 BOM。
產生記憶體 URL
請參閱建立容器以建立容器。
注意
僅使用小寫字母輸入容器的名稱。
請參閱產生共用存取簽章,以建立容器的SAS URL。 提供SAS的寫入許可權。
注意
ESAS URL 的存留時間很短。 根據預設,它會設定為八小時內到期。 如果 SAS URL 到期,您必須開啟 Microsoft 支援票證以新增 URL。