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

Artikel
12/16/2024

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) und den Ressourcen-SKUs (Stock Keeping Units) entsprechen, und klassifiziert sie als konform oder nicht konform. Zu den Gerätetypen zählen Customer Edge (CE)-, Top of Rack (TOR)-, Management (MGMT)- und Network Packet Broker (NPB)-Geräte. 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.

Weitere Informationen zu Stücklisten finden Sie unter SKUs für Azure Operator Nexus.

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.
Für das Speicherkonto gelten die folgenden Voraussetzungen:
- Das Speicherkonto muss sich in einer anderen Azure-Region befinden als das Network Fabric.
- Die Rolle Storage Blob Data Contributor muss Nexus Network Fabric RP zugewiesen sein und der Zugriff dem Speicherkonto.
Der Microsoft-Support muss Nexus Network Fabric mit einer aktiven Speicher-SAS-URL patchen, bevor die Verkabelung überprüft wird.

Erstellen einer Azure-Supportanfrage für das Patchen von Nexus Network Fabric:

Weitere Informationen finden Sie unter Erstellen einer Azure-Supportanfrage.
Geben Sie für das Problem Nexus Network Fabric ein, und klicken Sie auf Go.
Wählen Sie Azure Operator Nexus als den Dienst aus, mit dem Sie Probleme haben.
Wählen Sie das Subscription aus, das die Ressource enthält.
Wählen Sie unter dem Ressourcenfeld General aus, und klicken Sie auf Next.
Wählen Sie unter der Eingabeaufforderung für das Problem Network fabric instance provisioning aus, und klicken Sie auf Next.
Wählen Sie oben auf dem Blatt „Support“ die Option Create a support request aus.
Klicken Sie auf der Registerkarte Problem description auf Next.
Warten Sie, bis die Recommended solution angezeigt wird, und klicken Sie dann auf den Link „Zurück zur Supportanfrage“.
Klicken Sie auf der Registerkarte Problem description erneut auf Next, um mit Additional details fortzufahren.
Geben Sie die erforderlichen Anforderungsdetails zum Patchen von Nexus Network Fabric ein, und klicken Sie dann auf Next.
Überprüfen Sie die Informationen auf der Registerkarte Review + create, und klicken Sie auf Create.

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.

Generieren der Speicher-URL

Informationen dazu, wie Sie einen Container im Speicherkonto erstellen, finden Sie unter Erstellen eines Containers.

Hinweis

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

Informationen zum Generieren einer SAS-URL für den Container, um Schreibzugriff auf Nexus Fabric zu gewähren, finden Sie unter Generieren einer freigegebenen Zugriffssignatur.

Hinweis

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

Überprüfen der Verkabelung

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 aus dem Abschnitt Azure-AsyncOperation der Debugausgabe. Dieser Teil der URL wird im folgenden Schritt verwendet, um den Vorgangsstatus zu überprüfen.
```
cli.azure.cli.core.sdk.policies:     'Azure-AsyncOperation': '<Azure-AsyncOperation-endpoint url>'
```
Der folgende Fehler weist darauf hin, dass Fabric nicht mit einer gültigen SAS-URL gepatcht wurde:
```
azure.core.exceptions.HttpResponseError: Operation returned an invalid status 'OK'
```

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

Der Vorgangsstatus gibt an, ob die API erfolgreich war.

Hinweis

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

Laden Sie die überprüften Ergebnisse von der <CABLING_REPORT_STORAGE_URL> herunter, die nach Abschluss des Befehls zurückgegeben wird, 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 des Customer Edge-zu-Top-Of-Rack (TOR)-Switches

{ 
                      "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	Der Überprüfungsstatus ist mit der Stücklistenspezifikation für die Schnittstelle konform.
NonCompliant	Der Überprüfungsstatus ist nicht mit der Stücklistenspezifikation für die Schnittstelle konform.
Unbekannt	Bei der Überprüfung konnten keine Details zur Schnittstellenverbindung abgerufen werden, oder es wurden keine LLDP-Daten (Link Layer Discovery Protocol) zurückgegeben. Der Status `Unknown` wird zurückgegeben, wenn das Zielgerät ausgeschaltet ist, fehlt, getrennt ist oder für diesen Schnittstellentyp nicht unterstützt wird.

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 der Kabel und Kabelspezifikation).
`deviceDestinationResourceId`	Azure Resource Manager-ID des verbundenen Nachbarn (Zielgerät).
`roleName`	Die Rolle des Network Fabric-Geräts (CE oder TOR).

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

Die Kabelüberprüfung von Verbindungen zwischen TOR und Computeservern, die im Nexus-Cluster ausgeschaltet oder nicht bereitgestellt sind, wird nicht unterstützt. Für diese Schnittstellen wird im Bericht der Status Unknown angezeigt.
Die Kabelüberprüfung von Verbindungen zwischen MGMT-Schnittstellen und Computeservern, die im Nexus-Cluster oder in den Computeservercontrollern ausgeschaltet oder nicht bereitgestellt sind, wird nicht unterstützt. Für diese Schnittstellen wird im Bericht der Status Unknown angezeigt.
Die Kabelüberprüfung für NPB wird für loopback- und nni-direct-Schnittstellen nicht unterstützt, da derzeit keine Anbieterunterstützung für show lldp neighbors verfügbar ist. Für diese Schnittstellen wird im Bericht der Status Unknown angezeigt.
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 gemäß der Rackstückliste vier Racks mit 16 Computeressourcen pro Rack und acht Racks mit 16 Computeressourcen.
Wenn das Zielgerät ausgeschaltet ist, Kabel fehlen oder getrennt sind oder die Überprüfung für den Schnittstellentyp nicht unterstützt wird, wird für die Schnittstelle der Status Unknown angezeigt. Es ist wichtig, alle Schnittstellen mit dem Status Unknown, die Not-Connected sind, anhand der Stückliste auszuwerten, um festzustellen, ob eine Reparaturaktion erforderlich ist.

Häufige Probleme vom Typ `NonCompliant` und `Unknown` beim Überprüfen der Kabel

validationType	Status	Fehler	Lösung
CableValidation	`NonCompliant`	`Device cable connection is incorrect.`	Stellen Sie sicher, dass Verbindungen auf den Quell- und Zielschnittstellen mit der Stückliste übereinstimmen. Die `deviceConfiguration` kann dabei helfen, das auf der Schnittstelle zurückgegebene Zielportdatum zu ermitteln.
CableValidation	`Unknown`	`Unable to fetch data from the device.`	Stellen Sie sicher, dass Verbindungen auf den Quell- und Zielschnittstellen verbunden sind und mit der Stückliste übereinstimmen.
CableValidation	`NonCompliant`	`Device cabling in <INTERFACE> incorrect.`	Die Schnittstelle ist nicht verbunden. Stellen Sie sicher, dass Verbindungen auf den Quell- und Zielschnittstellen verbunden sind und der Stückliste entsprechen.
CableValidation	`Unknown`	`Port <INTERFACE> has no connections as per device response.`	Stellen Sie sicher, dass Verbindungen auf den Quell- und Zielschnittstellen verbunden sind und der Stückliste entsprechen.
CableSpecificationValidation	`Unknown`	`Unable to fetch Interface Status for <INTERFACE>.`	Stellen Sie sicher, dass Verbindungen auf den Quell- und Zielschnittstellen verbunden sind und der Stückliste entsprechen.
CableSpecificationValidation	`NonCompliant`	`Device cable connection is incorrect`	Stellen Sie sicher, dass die Adapterkarte und die Kabel mit der Stücklistenspezifikation in dieser Schnittstelle übereinstimmen.

Konvertieren des Kabelüberprüfungsberichts in das HTML-Format

Weitere Informationen finden Sie unter How to Convert Cable Validation report JSON output to HTML (Konvertieren der JSON-Ausgabe des Kabelüberprüfungsberichts in das HTML-Format).

Freigeben über

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

Voraussetzungen

Erstellen einer Azure-Supportanfrage für das Patchen von Nexus Network Fabric:

Generieren der Speicher-URL

Überprüfen der Verkabelung

Exemplarische Ausgabe für die Überprüfung von Kunden-Edge (Customer Edge, CE) zu Anbieter-Edge (Provider Edge, PE)

Überprüfung des Customer Edge-zu-Top-Of-Rack (TOR)-Switches

Statuswerte der Überprüfung

Validierungsattribute

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

Häufige Probleme vom Typ `NonCompliant` und `Unknown` beim Überprüfen der Kabel

Konvertieren des Kabelüberprüfungsberichts in das HTML-Format

Feedback

Zusätzliche Ressourcen

Freigeben über

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

Voraussetzungen

Erstellen einer Azure-Supportanfrage für das Patchen von Nexus Network Fabric:

Generieren der Speicher-URL

Überprüfen der Verkabelung

Exemplarische Ausgabe für die Überprüfung von Kunden-Edge (Customer Edge, CE) zu Anbieter-Edge (Provider Edge, PE)

Überprüfung des Customer Edge-zu-Top-Of-Rack (TOR)-Switches

Statuswerte der Überprüfung

Validierungsattribute

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

Häufige Probleme vom Typ NonCompliant und Unknown beim Überprüfen der Kabel

Konvertieren des Kabelüberprüfungsberichts in das HTML-Format

Feedback

Zusätzliche Ressourcen

Häufige Probleme vom Typ `NonCompliant` und `Unknown` beim Überprüfen der Kabel