Verifiera kablar för Nexus Network Fabric
I den här artikeln beskrivs infrastrukturkabelvalidering, där den primära funktionen för diagnostik-API:et är att kontrollera alla infrastrukturenheter för potentiella kabelproblem. Diagnostik-API:et utvärderar om de sammankopplade enheterna följer bommen (Bill of Materials) och enligt resursens lagerhållningsenheter (SKU:er) och klassificerar dem som kompatibla eller inkompatibla. Enhetstyper inkluderar Enheter med Customer Edge (CE), Top of Rack (TOR), Management (MGMT) och NPB (Network Packet Broker). Resultaten visas i ett JSON-format som omfattar information som valideringsstatus, fel, identifierartyp och enhets-ID för granne. Dessa resultat lagras i ett lagringskonto som tillhandahålls av kunden. Det är viktigt för den övergripande distributionen att fel som identifieras i den här rapporten löses innan du går vidare till steget Klusterdistribution.
Information om strukturlisteinformation finns i Azure Operator Nexus SKU:er
Förutsättningar
- Kontrollera att Nexus Network Fabric har etablerats.
- Ange Nätverksinfrastruktur-ID och lagrings-URL med SKRIV-åtkomst via ett supportärende.
- Lagringskontot har följande förutsättningar:
- Lagringskontot måste finnas i en annan Azure-region än Network Fabric Azure-regionen.
Storage Blob Data Contributor
rollen måste tilldelas tillNexus Network Fabric RP
med åtkomst tilldelad till lagringskontot.
- Microsoft Support måste korrigera Nexus Network Fabric med en SAS-URL för aktiv lagring innan du kör kabelvalidering.
Skapa en Azure-supportbegäran för korrigering av Nexus Network Fabric:
- Se Så här skapar du en Azure Support begäran
- Ange
Nexus Network Fabric
för problemet och klicka påGo
. - Välj
Azure Operator Nexus
som den tjänst som du har problem med. - Välj
Subscription
var resursen finns. - Välj
General
under resursfältet och klicka påNext
. - Välj
Network fabric instance provisioning
under frågan och klicka påNext
. - Välj
Create a support request
nu överst på supportbladet. - Klicka
Next
på flikenProblem description
. - Vänta på
Recommended solution
och klicka sedan på länken tillbaka till "Återgå till supportbegäran" - Klicka
Next
på flikenProblem description
igen för att fortsätta tillAdditional details
- Fyll i den begärd information som krävs för att korrigera Nexus Network Fabric och klicka sedan på
Next
- Granska informationen på fliken
Review + create
och klicka sedan påCreate
.
Kommentar
Lagrings-URL:en (SAS) är kortlivad. Som standard är den inställd på att upphöra att gälla om åtta timmar. Om SAS-URL:en upphör att gälla måste infrastrukturresurserna korrigeras igen.
Generera lagrings-URL:en
Om du vill skapa en container i lagringskontot läser du Skapa en container
Kommentar
Ange namnet på containern med endast gemener.
Om du vill generera en SAS-URL för containern för att ge skrivåtkomst till Nexus Fabric läser du Generera en signatur för delad åtkomst
Kommentar
SAS-URL:er är kortlivade. Som standard är den inställd på att upphöra att gälla om åtta timmar. Om SAS-URL:en upphör att gälla måste du öppna ett Microsoft-supportärende för att lägga till en ny URL.
Verifiera kabeldragning
Kör följande Azure CLI-kommando:
az networkfabric fabric validate-configuration –resource-group "<NFResourceGroupName>" --resource-name "<NFResourceName>" --validate-action "Cabling" --no-wait --debug
Följande (trunkerade) utdata visas. Kopiera URL:en från
Azure-AsyncOperation
avsnittet i felsökningsutdata. Den här delen av URL:en används i följande steg för att kontrollera åtgärdens status.cli.azure.cli.core.sdk.policies: 'Azure-AsyncOperation': '<Azure-AsyncOperation-endpoint url>'
Följande fel anger att infrastrukturresursen inte har korrigerats med en giltig SAS-URL:
azure.core.exceptions.HttpResponseError: Operation returned an invalid status 'OK'
Du kan programmatiskt kontrollera statusen för åtgärden genom att köra följande kommando:
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" }
Åtgärdsstatusen anger om API:et lyckades eller misslyckades.
Kommentar
Åtgärden tar ungefär 20~40 minuter att slutföra baserat på antalet rack.
Ladda ned och läs de verifierade resultaten från det
<CABLING_REPORT_STORAGE_URL>
returnerade kommandot från det slutförda kommandot.
Exempelutdata visas i följande avsnitt.
Exempel på verifieringsutdata från Customer Edge (CE) till 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-växelvalidering (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
}
}
]
Status för validering
Statustyp | Definition |
---|---|
Godkänd | Valideringsstatusen är kompatibel med BOM-specifikationen för gränssnittet. |
Kompatibla | Valideringen är inte kompatibel med BOM-specifikationen för gränssnittet. |
Okänt | Verifieringen kan inte hämta anslutningsinformation för gränssnittet eller så returneras inte lldp-data. Statusen Unknown returneras om målenheten är avstängd, saknas, kopplas från eller inte stöds för den här gränssnittstypen. |
Valideringsattribut
Attribut | Definition |
---|---|
deviceConfiguration |
Konfiguration som är tillgänglig på enheten. |
error |
Fel från enheten. |
reason |
Det här fältet fylls i när enhetens status är okänd. |
validationType |
Den här parametern anger vilken typ av validering. (validering av kabel- och kabelspecifikation). |
deviceDestinationResourceId |
Azure Resource Manager-ID för den anslutna grannen (målenheten). |
roleName |
Rollen för Network Fabric Device (CE eller TOR). |
Kända problem och begränsningar i kabelvalidering
- Kabelverifiering av anslutningar mellan TOR- och beräkningsservrar som är avstängda eller oetablerade i Nexus-klustret stöds inte. Dessa gränssnitt visar
Unknown
status i rapporten. - Kabelverifiering av anslutningar mellan MGMT-gränssnitt och beräkningsservrar som är avstängda eller oetablerade i Nexus-klustret eller Beräkningsserverkontrollanterna stöds inte. Dessa gränssnitt visar
Unknown
status i rapporten. - Kabelverifiering för NPB stöds inte för
loopback
ochnni-direct
gränssnitt eftersom det för närvarande inte finns något leverantörsstöd förshow lldp neighbors
. Dessa gränssnitt visarUnknown
status i rapporten. - Lagrings-URL:en måste finnas i en annan region än nätverksinfrastrukturen. Om infrastrukturresurserna till exempel finns i USA, östra bör lagrings-URL:en vara utanför USA, östra.
- Kabelvalidering stöder fyra rack med 16 beräkningar per rack och åtta rack med 16 beräkningsuppsättningar per rack.
- När målenheten stängs av saknas eller kopplas kablarna bort, eller om verifieringen inte stöds för gränssnittstypen visar
Unknown
gränssnittet status. Det är viktigt att utvärdera allaUnknown
gränssnitt som ärNot-Connected
emot bommen för att avgöra om reparationsåtgärd krävs.
Typisk kabelverifiering NonCompliant
och Unknown
problem
validationType | Status | Fel | Åtgärd |
---|---|---|---|
CableValidation | NonCompliant |
Device cable connection is incorrect. |
Kontrollera att anslutningarna i käll- och målgränssnitten matchar bommen. deviceConfiguration Kan hjälpa till att identifiera målportdatumet som returneras i gränssnittet. |
CableValidation | Unknown |
Unable to fetch data from the device. |
Kontrollera att anslutningarna i käll- och målgränssnitten är anslutna och matchar bommen |
CableValidation | NonCompliant |
Device cabling in <INTERFACE> incorrect. |
Gränssnittet är inte anslutet. Kontrollera att anslutningarna i käll- och målgränssnitten är anslutna till bommen. |
CableValidation | Unknown |
Port <INTERFACE> has no connections as per device response. |
Kontrollera att anslutningarna i käll- och målgränssnitten är anslutna och matchar bommen. |
CableSpecificationValidation | Unknown |
Unable to fetch Interface Status for <INTERFACE>. |
Kontrollera att anslutningarna i käll- och målgränssnitten är anslutna och matchar bommen. |
CableSpecificationValidation | NonCompliant |
Device cable connection is incorrect |
Kontrollera att gränssnittskortet och kablarna matchar BOM-specifikationen i det här gränssnittet. |
Konvertera kabelverifieringsrapport till HTML-format
Se Konvertera JSON-utdata för kabelverifieringsrapport till HTML.