Kabels valideren voor Nexus Network Fabric

Artikel
12/15/2024

In dit artikel wordt de validatie van infrastructuurkabels uitgelegd, waarbij de primaire functie van de diagnostische API is om alle infrastructuurapparaten te controleren op mogelijke bekabelingsproblemen. De diagnostische API beoordeelt of de onderling verbonden apparaten voldoen aan de stuklijst (Bill of Materials) en volgens de resource Stock Keeping Units (SKU's), deze classificeren als compatibel of niet-compatibel. Apparaattypen zijn onder andere Customer Edge (CE), Top of Rack (TOR), Beheer (MGMT) en NPB-apparaten (Network Packet Broker). De resultaten worden weergegeven in een JSON-indeling, die details omvat, zoals de validatiestatus, fouten, het id-type en de apparaat-id van de buur. Deze resultaten worden opgeslagen in een door de klant opgegeven opslagaccount. Het is essentieel voor de algehele implementatie dat fouten die in dit rapport zijn geïdentificeerd, worden opgelost voordat u naar de stap clusterimplementatie gaat.

Raadpleeg Azure Operator Nexus-SKU's voor BOM-details

Vereisten

Zorg ervoor dat de Nexus Network Fabric is ingericht.
Geef de Network Fabric-id en opslag-URL op met SCHRIJFtoegang via een ondersteuningsticket.
Het opslagaccount heeft de volgende vereisten:
- Het opslagaccount moet zich in een andere Azure-regio bevinden dan de Azure-regio Network Fabric.
- Storage Blob Data Contributor de rol moet worden toegewezen aan de Nexus Network Fabric RP rol met toegang die is toegewezen aan het opslagaccount.
Microsoft Ondersteuning moet de Nexus Network Fabric patchen met een actieve SAS-URL voor opslag voordat u bekabelingsvalidatie uitvoert.

Een Azure-ondersteuningsaanvraag maken voor het patchen van Nexus Network Fabric:

Raadpleeg Hoe u een ondersteuning voor Azure-aanvraag maakt
Voer het Nexus Network Fabric probleem in en klik op Go.
Selecteer Azure Operator Nexus deze optie als de service waarmee u een probleem ondervindt.
Selecteer Subscription waar de resource zich bevindt.
Selecteer General onder het resourceveld en klik op Next.
Selecteer Network fabric instance provisioning onder de prompt voor het probleem en klik op Next.
Selecteer Create a support request nu bovenaan de ondersteuningsblade.
Klik Next op het Problem description tabblad.
Wacht op de Recommended solution en klik vervolgens op de koppeling terug naar 'Terug naar ondersteuningsaanvraag'
Klik Next nogmaals op het Problem description tabblad om door te gaan Additional details
Vul de vereiste aanvraaggegevens in om Nexus Network Fabric te patchen en klik vervolgens op Next
Controleer de informatie op het Review + create tabblad en klik op Create.

Notitie

De OPSLAG-URL (SAS) heeft een korte levensduur. Deze is standaard ingesteld op verlopen in acht uur. Als de SAS-URL verloopt, moet de infrastructuur opnieuw worden gepatcht.

De opslag-URL genereren

Als u een container in het opslagaccount wilt maken, raadpleegt u Een container maken

Notitie

Voer de naam van de container in met alleen kleine letters.

Als u een SAS-URL voor de container wilt genereren voor schrijftoegang tot de Nexus Fabric, raadpleegt u Een handtekening voor gedeelde toegang genereren

Notitie

SAS-URL's hebben een korte levensduur. Deze is standaard ingesteld op verlopen in acht uur. Als de SAS-URL verloopt, moet u een Microsoft-ondersteuningsticket openen om een nieuwe URL toe te voegen.

Bekabeling valideren

Voer de volgende Azure CLI-opdracht uit:

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

De volgende uitvoer (afgekapt) wordt weergegeven. Kopieer de URL uit de Azure-AsyncOperation sectie van de foutopsporingsuitvoer. Dit gedeelte van de URL wordt in de volgende stap gebruikt om de status van de bewerking te controleren.

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

De volgende fout geeft aan dat de Fabric niet is gepatcht met een geldige SAS-URL:

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

U kunt de status van de bewerking programmatisch controleren door de volgende opdracht uit te voeren:

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

De bewerkingsstatus geeft aan of de API is geslaagd of mislukt.

Notitie

De bewerking duurt ongeveer 20~40 minuten op basis van het aantal racks.

Download en lees de gevalideerde resultaten van de <CABLING_REPORT_STORAGE_URL> geretourneerde opdracht uit de voltooide opdracht.

Voorbeelduitvoer wordt weergegeven in de volgende secties.

Voorbeeld van pe-validatieuitvoer (Customer Edge) naar 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 
                      } 
                    } 
                  ] 
                },

Tor-switchvalidatie (Customer Edge to Top Of Rack)

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

Statussen van validatie

Statustype	Definitie
compatibel	De validatiestatus voldoet aan de BOM-specificatie voor de interface.
Compatibel	Validatie voldoet niet aan de BOM-specificatie voor de interface.
Onbekend	Validatie kan geen interfaceverbindingsgegevens ophalen of lldp-gegevens worden niet geretourneerd. De `Unknown` status wordt geretourneerd als het doelapparaat is uitgeschakeld, ontbreekt, verbroken of niet wordt ondersteund voor dit interfacetype.

Validatiekenmerken

Kenmerk	Definitie
`deviceConfiguration`	Configuratie die beschikbaar is op het apparaat.
`error`	Fout van het apparaat.
`reason`	Dit veld wordt ingevuld wanneer de status van het apparaat onbekend is.
`validationType`	Deze parameter geeft aan welk type validatie. (validaties van kabel- en kabelspecificaties).
`deviceDestinationResourceId`	Azure Resource Manager-id van de verbonden buurman (doelapparaat).
`roleName`	De rol van het Network Fabric Device (CE of TOR).

Bekende problemen en beperkingen in kabelvalidatie

Kabelvalidatie van verbindingen tussen TOR- en Compute-servers die zijn uitgeschakeld of die niet zijn geïmplementeerd in het Nexus-cluster, worden niet ondersteund. Deze interfaces geven Unknown de status in het rapport weer.
Kabelvalidatie van verbindingen tussen MGMT-interfaces en rekenservers die zijn uitgeschakeld of niet zijn ingerichte in het Nexus-cluster of de Compute Server Controllers worden niet ondersteund. Deze interfaces geven Unknown de status in het rapport weer.
Kabelvalidatie voor NPB wordt niet ondersteund voor loopback en nni-direct interfaces omdat er momenteel show lldp neighborsgeen ondersteuning voor leveranciers is. Deze interfaces geven Unknown de status in het rapport weer.
De opslag-URL moet zich in een andere regio bevinden dan de netwerkinfrastructuur. Als de infrastructuur bijvoorbeeld wordt gehost in VS - oost, moet de opslag-URL zich buiten VS - oost bevinden.
Kabelvalidatie ondersteunt vier racks met 16 berekeningen per rek en acht racks met 16 rekenkracht per rack-BOM's.
Wanneer het doelapparaat is uitgeschakeld, ontbreken of worden kabels losgekoppeld, of als de validatie niet wordt ondersteund voor het interfacetype, wordt de status van de interface weergegeven Unknown . Het is belangrijk om alle Unknown interfaces te evalueren die zich Not-Connected tegen de BOM bevinden om te bepalen of herstelactie is vereist.

Typische kabelvalidatie `NonCompliant` en `Unknown` problemen

validationType	Status	Error	Oplossing
CableValidation	`NonCompliant`	`Device cable connection is incorrect.`	Controleer of verbindingen op de bron- en doelinterfaces overeenkomen met de BOM. De `deviceConfiguration` kan helpen bij het identificeren van de doelpoortdatum die wordt geretourneerd op de interface.
CableValidation	`Unknown`	`Unable to fetch data from the device.`	Controleer of verbindingen op de bron- en doelinterfaces zijn verbonden en overeenkomen met de stuklijst
CableValidation	`NonCompliant`	`Device cabling in <INTERFACE> incorrect.`	De interface is niet verbonden. Controleer of verbindingen op de bron- en doelinterfaces zijn verbonden met de BOM.
CableValidation	`Unknown`	`Port <INTERFACE> has no connections as per device response.`	Controleer of verbindingen op de bron- en doelinterfaces zijn verbonden en overeenkomen met de BOM.
CableSpecificationValidation	`Unknown`	`Unable to fetch Interface Status for <INTERFACE>.`	Controleer of verbindingen op de bron- en doelinterfaces zijn verbonden en overeenkomen met de BOM.
CableSpecificationValidation	`NonCompliant`	`Device cable connection is incorrect`	Controleer of de interfacekaart en kabels overeenkomen met bomspecificatie in deze interface.

Bekabelingsvalidatierapport converteren naar HTML-indeling

Raadpleeg JSON-uitvoer van bekabelingsvalidatierapport converteren naar HTML.

Delen via

Kabels valideren voor Nexus Network Fabric

Vereisten

Een Azure-ondersteuningsaanvraag maken voor het patchen van Nexus Network Fabric:

De opslag-URL genereren

Bekabeling valideren

Voorbeeld van pe-validatieuitvoer (Customer Edge) naar Provider Edge (PE)

Tor-switchvalidatie (Customer Edge to Top Of Rack)

Statussen van validatie

Validatiekenmerken

Bekende problemen en beperkingen in kabelvalidatie

Typische kabelvalidatie `NonCompliant` en `Unknown` problemen

Bekabelingsvalidatierapport converteren naar HTML-indeling

Feedback

Aanvullende resources

Delen via

Kabels valideren voor Nexus Network Fabric

Vereisten

Een Azure-ondersteuningsaanvraag maken voor het patchen van Nexus Network Fabric:

De opslag-URL genereren

Bekabeling valideren

Voorbeeld van pe-validatieuitvoer (Customer Edge) naar Provider Edge (PE)

Tor-switchvalidatie (Customer Edge to Top Of Rack)

Statussen van validatie

Validatiekenmerken

Bekende problemen en beperkingen in kabelvalidatie

Typische kabelvalidatie NonCompliant en Unknown problemen

Bekabelingsvalidatierapport converteren naar HTML-indeling

Feedback

Aanvullende resources

Typische kabelvalidatie `NonCompliant` en `Unknown` problemen