Validierung von Kabeln für Nexus Network Fabric

In diesem Artikel wird die Fabric-Kabelüberprüfung erläutert, bei der die primäre Funktion der Diagnose-API darin besteht, alle Fabric-Geräte auf mögliche Kabelprobleme zu überprüfen. Die Diagnose-API beurteilt, ob die miteinander verbundenen Geräte die Anforderungen der Stückliste (Bill of Materials, BOM) und der Ressourcen-Lagerhaltungseinheiten (Stock Keeping Units, SKUs) erfüllen und klassifiziert sie als konform oder nicht konform. Zu den Gerätetypen gehören Customer Edge (CE), Top of Rack (TOR), Management (MGMT) und NpB-Geräte (Network Packet Broker). Die Ergebnisse werden in einem JSON-Format dargestellt, das Details wie Überprüfungsstatus, Fehler, Bezeichnertyp und Benachbarte Geräte-ID umfasst. Diese Ergebnisse werden in einem vom Kunden bereitgestellten Speicherkonto gespeichert. Es ist entscheidend für die Gesamtbereitstellung, dass die in diesem Bericht identifizierten Fehler behoben werden, bevor Sie mit dem Schritt der Clusterbereitstellung fortfahren. Die calble-Überprüfung unterstützt auch die Verwendung eines vom Kunden bereitgestellten Speicherkontos zum Speichern von Ausgabedateien mit api Version 2024-06-15-preview.

Informationen zu BOM finden Sie unter Azure Operator Nexus SKUs

Voraussetzungen

• Stellen Sie sicher, dass die Nexus Network Fabric erfolgreich bereitgestellt wird.
• Stellen Sie die Network Fabric-ID und die Speicher-URL mit WRITE-Zugriff über ein Supportticket bereit.
• Das Speicherkonto hat die folgenden Voraussetzungen:
  • Das Speicherkonto muss sich in einer anderen Azure-Region als in der Azure-Region "Network Fabric" befinden.
  • Storage Blob Data Contributor Rolle muss Nexus Network Fabric RP zugewiesen werden, mit Zugriff auf das Speicherkonto.
• Der Microsoft-Support muss die Nexus Network Fabric mit einer aktiven Speicher-SAS-URL patchen, bevor die Kabelvalidierung erfolgt.

Erstellen einer Azure-Supportanfrage für Patching Nexus Network Fabric:

• Verweisen Sie auf So erstellen Sie eine Azure-Supportanfrage
• Geben Sie die Eingabetaste Nexus Network Fabric für das Problem ein, und klicken Sie auf Go.
• Wählen Sie Azure Operator Nexus als Dienst aus, mit dem Sie Probleme haben.
• Wählen Sie Subscription aus, wo sich die Ressource befindet.
• Wählen Sie General unter dem Ressourcenfeld aus, und klicken Sie auf Next.
• Wählen Sie Network fabric instance provisioning unter der Problemaufforderung aus, und klicken Sie auf Next.
• Wählen Sie Create a support request nun oben auf dem Supportblatt aus.
• Klicken Sie Next auf die Problem description Registerkarte.
• Warten Sie auf Recommended solution und klicken Sie dann auf den Link zurück zu "Rückkehr zur Supportanforderung"
• Klicken Sie Next erneut auf die Problem description Registerkarte, um zu Additional details fortzufahren.
• Füllen Sie die erforderlichen Anforderungsdetails aus, um Nexus Network Fabric zu patchen, und klicken Sie dann auf Next
• Überprüfen Sie die Informationen auf der Review + create Registerkarte, und klicken Sie dann auf Create.

Generieren der Speicher-URL

Informationen zum Erstellen eines Containers im Speicherkonto finden Sie unter "Erstellen eines Containers".

Informationen zum Generieren einer SAS-URL für den Container, um Schreibzugriff auf die Nexus Fabric bereitzustellen, finden Sie unter Generieren einer freigegebenen Zugriffssignatur

Ü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 (abgeschnittene) Ausgabe wird angezeigt. Kopieren Sie die URL aus dem Azure-AsyncOperation Abschnitt der Debugausgabe. Dieser Teil der URL wird im folgenden Schritt verwendet, um den Status des Vorgangs zu überprüfen.

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

   Der folgende Fehler zeigt an, dass das Fabric nicht mit einer gültigen SAS-URL gepatcht wurde.

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

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>" 
   {
     "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 oder fehlgeschlagen ist.

   Hinweis

   Der Vorgang dauert je nach Anzahl der Racks ungefähr 20 bis 40 Minuten.

3. Laden Sie die geprüften Ergebnisse, die vom abgeschlossenen Befehl zurückgegeben wurden, herunter und lesen Sie sie.

Die Beispielausgabe wird in den folgenden Abschnitten gezeigt.

Beispiel für die Überprüfung von Customer Edge (CE) zu 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 to 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 
                          } 
                        } 
                      ]

Status der Überprüfung

Überprüfungsattribute

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. Diese Schnittstellen zeigen Unknown den Status im Bericht an.
• Die Validierung von Kabelverbindungen zwischen MGMT-Schnittstellen und ausgeschalteten oder nicht bereitgestellten Computeservern im Nexus-Cluster oder nicht unterstützten Compute-Server-Controllern wird nicht unterstützt. Diese Schnittstellen zeigen Unknown den Status im Bericht an.
• Die Kabelüberprüfung für NPB wird für loopback und nni-direct Schnittstellen nicht unterstützt, da derzeit keine show lldp neighbors Anbieterunterstützung vorhanden ist. Diese Schnittstellen zeigen Unknown Status im Bericht an.
• Die LLDP-Nachbarermittlung wird für NPB-Geräteports nicht unterstützt, und die Kabelüberprüfung für diese Ports wird nur mit seriennummernvergleichen ausgeführt.
• Die Speicher-URL muss sich in einer anderen Region als der Network Fabric befinden. Wenn das Fabric beispielsweise in Ost-US gehostet wird, sollte sich die Speicher-URL außerhalb der USA befinden.
• Die Kabelüberprüfung unterstützt vier Racks mit je 16 Computes und acht Racks mit je 16 Computes (BOMs).
• Wenn das Zielgerät ausgeschaltet ist, die Kabel fehlen oder getrennt sind, oder wenn die Validierung für den Schnittstellentyp nicht unterstützt wird, zeigt die Schnittstelle den Status Unknown an. Es ist wichtig, alle Unknown Schnittstellen zu bewerten, die Not-Connected für die BOM gelten, um festzustellen, ob Reparaturmaßnahmen erforderlich sind.

Typische Kabelvalidierung NonCompliant und Unknown Probleme

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

Siehe Wie man die JSON-Ausgabe des Kabelvalidierungsberichts in HTML konvertiert.