Freigeben über

Überprüfen von Kabeln für Nexus-Netzwerk-Fabric

  • Artikel

In diesem Artikel wird die Fabric-Kabelüberprüfung erläutert. Dabei besteht die Hauptfunktion der Diagnose-API darin, alle Fabric-Geräte auf mögliche Kabelprobleme zu überprüfen. Die Diagnose-API bewertet, ob die miteinander verbundenen Geräte der Stückliste (Bill of Materials, BOM) entsprechen, und klassifiziert sie als konform oder als nicht konform. Die Ergebnisse werden in einem JSON-Format dargestellt, das Details wie Überprüfungsstatus, Fehler, Bezeichnertyp und die benachbarte Geräte-ID umfasst. Diese Ergebnisse werden in einem kundenseitig bereitgestellten Storage-Konto gespeichert. Für die allgemeine Bereitstellung ist es wichtig, dass in diesem Bericht identifizierte Fehler behoben werden, bevor Sie mit dem Clusterbereitstellungsschritt fortfahren.

Voraussetzungen

  • Stellen Sie sicher, dass das Nexus-Netzwerk-Fabric erfolgreich bereitgestellt wurde.
  • Stellen Sie die Netzwerk-Fabric-ID und die Speicher-URL mit Schreibzugriff (WRITE) über ein Supportticket bereit.

Hinweis

Die Speicher-URL (SAS) ist kurzlebig. Standardmäßig läuft sie innerhalb von acht Stunden ab. Nach Ablauf der SAS-URL muss das Fabric erneut gepatcht werden.

Überprüfen der Verkabelung

  1. Führen Sie den folgenden Azure CLI-Befehl aus:

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

    Die folgende (gekürzte) Ausgabe wird angezeigt. Kopieren Sie die URL über private Vorschau. Dieser Teil der URL wird im folgenden Schritt verwendet, um den Status des Vorgangs zu überprüfen.

    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. Sie können den Status des Vorgangs programmgesteuert überprüfen, indem Sie den folgenden Befehl ausführen:

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

    Der Vorgangsstatus gibt an, ob die API erfolgreich war.

    Hinweis

    Der Vorgang dauert je nach Rackanzahl ca. 20 bis 40 Minuten.

  3. Laden Sie die überprüften Ergebnisse über die Speicher-URL herunter, und lesen Sie sie.

Die folgenden Abschnitte enthalten eine Beispielausgabe.

Exemplarische Ausgabe für die Überprüfung von Kunden-Edge (Customer Edge, CE) zu Anbieter-Edge (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 
                      } 
                    } 
                  ] 
                },

Überprüfung von Kunden-Edge zu Top-Of-Rack-Switch

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

Statuswerte der Überprüfung

Statustyp Definition
Konform Wenn der Status mit der BOM-Spezifikation konform ist
Nicht konform Wenn der Status nicht mit der BOM-Spezifikation konform ist
Unbekannt Wenn der Status unbekannt ist

Validierungsattribute

Attribut Definition
deviceConfiguration Auf dem Gerät verfügbare Konfiguration.
error Geräteseitiger Fehler
reason Dieses Feld wird aufgefüllt, wenn der Status des Geräts unbekannt ist.
validationType Dieser Parameter gibt an, welche Art von Überprüfung verwendet werden soll. (Überprüfung des Kabels und der Kabelspezifikation)
deviceDestinationResourceId Azure Resource Manager-ID des verbundenen Nachbarn (Zielgerät)
roleName Die Rolle des Netzwerk-Fabric-Geräts (CE oder TOR)

Bekannte Probleme und Einschränkungen bei der Kabelüberprüfung

  • Verbindungen zwischen TORs and Computeservern nach der Überprüfung werden nicht unterstützt.
  • Die Kabelüberprüfung für NPB wird nicht unterstützt, da „show lldp neighbors“ von Arista nicht unterstützt wird.
  • Die Speicher-URL muss sich in einer anderen Region befinden als das Netzwerk-Fabric. Wenn das Fabric beispielsweise in „USA, Osten“ gehostet wird, muss sich die Speicher-URL außerhalb von „USA, Osten“ befinden.
  • Die Kabelüberprüfung unterstützt sowohl BOMs mit vier Racks als auch BOMs mit acht Racks.

Generieren der Speicher-URL

Erstellen Sie einen Container. Eine entsprechende Anleitung finden Sie unter Erstellen eines Containers.

Hinweis

Geben Sie den Namen des Containers ein, und verwenden Sie dabei nur Kleinbuchstaben.

Erstellen Sie die SAS-URL des Containers. Eine entsprechende Anleitung finden Sie unter Generieren einer freigegebenen Zugriffssignatur. Erteilen Sie Schreibberechtigung für SAS.

Hinweis

ESAS-URLs sind kurzlebig. Standardmäßig laufen sie innerhalb von acht Stunden ab. Nach Ablauf der SAS-URL muss ein Microsoft-Supportticket erstellt werden, um eine neue URL hinzuzufügen.