Überprüfen von Kabeln für Nexus-Netzwerk-Fabric
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
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 --debugDie 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-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.
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.
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für