Weryfikacja kabli dla systemu Nexus Network Fabric

W tym artykule wyjaśniono weryfikację sieci szkieletowej, w której podstawową funkcją interfejsu API diagnostyki jest sprawdzenie wszystkich urządzeń sieci szkieletowej pod kątem potencjalnych problemów z okablowaniem. Interfejs API diagnostyki ocenia, czy połączone urządzenia są zgodne z rachunkiem materiałów (BOM) i zgodnie z jednostkami przechowywania zasobów (SKU), klasyfikując je jako zgodne lub niezgodne. Typy urządzeń obejmują urządzenia Customer Edge (CE), Top of Rack (TOR), Management (MGMT) i Network Packet Broker (NPB). Wyniki są prezentowane w formacie JSON zawierającym szczegółowe informacje, takie jak stan weryfikacji, błędy, typ identyfikatora i identyfikator urządzenia sąsiada. Te rezultaty są przechowywane na koncie pamięci masowej dostarczonym przez klienta. Zanim przejdziemy do etapu wdrożenia klastra, kluczowe jest, aby błędy zidentyfikowane w tym raporcie zostały rozwiązane, co jest niezbędne dla ogólnego wdrożenia. Walidacja calble obsługuje również używanie konta magazynu dostarczonego przez klienta do przechowywania plików wyjściowych przy użyciu interfejsu API w wersji 2024-06-15-preview.

Aby uzyskać szczegółowe informacje na temat BOM, zapoznaj się z Azure Operator Nexus SKU.

Wymagania wstępne

• Upewnij się, że sieć szkieletowa Nexus została pomyślnie aprowizowana.
• Podaj identyfikator sieci szkieletowej i adres URL magazynu z dostępem WRITE za pośrednictwem biletu pomocy technicznej.
• Konto magazynowe ma następujące wymagania wstępne:
  • Konto magazynu musi znajdować się w innym regionie świadczenia usługi Azure niż sieć szkieletowa platformy Azure.
  • Storage Blob Data Contributor rola musi być przypisana Nexus Network Fabric RP z dostępem do konta magazynu.
• Pomoc techniczna firmy Microsoft musi zastosować poprawki dla fabryki Nexus Network z aktywnym adresem URL SAS magazynu przed uruchomieniem weryfikacji okablowania.

Tworzenie żądania wsparcia technicznego dla platformy Azure dotyczącego aktualizacji Nexus Network Fabric:

• Zapoznaj się z artykułem Jak utworzyć żądanie pomocy technicznej platformy Azure
• Wprowadź Nexus Network Fabric dotyczący problemu i kliknij Go.
• Wybierz Azure Operator Nexus jako usługę, z którą masz problem.
• Wybierz Subscription miejsce, w którym znajduje się zasób.
• Wybierz General pod polem zasobu, a następnie kliknij pozycję Next.
• Wybierz Network fabric instance provisioning w oknie z komunikatem o problemie, a następnie kliknij Next.
• Teraz wybierz Create a support request w górnej części panelu wsparcia.
• Kliknij Next na karcie Problem description.
• Poczekaj na Recommended solution, a następnie kliknij link prowadzący z powrotem do "Powrotu do zgłoszenia pomocy technicznej".
• Kliknij ponownie Next na karcie Problem description, aby kontynuować do Additional details
• Uzupełnij wymagane informacje dotyczące żądania, aby zaktualizować sieć szkieletową Nexus, a następnie kliknij Next
• Przejrzyj informacje na karcie Review + create, a następnie kliknij Create.

Wygeneruj adres URL magazynu

Aby utworzyć kontener na koncie magazynu, zobacz Tworzenie kontenera

Aby wygenerować URL z sygnaturą dostępu współdzielonego dla kontenera w celu umożliwienia dostępu do zapisu w Nexus Fabric, zobacz Generowanie sygnatury dostępu współdzielonego

Weryfikowanie okablowania

1. Wykonaj następujące polecenie interfejsu wiersza polecenia platformy Azure:

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

   Zostanie wyświetlone następujące (obcięte) dane wyjściowe. Skopiuj adres URL z Azure-AsyncOperation sekcji danych wyjściowych debugowania. Ta część adresu URL jest używana w poniższym kroku, aby sprawdzić stan operacji.

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

   Następujący błąd wskazuje, że Fabric nie został zaktualizowany przy użyciu prawidłowego URL podpisu dostępu współdzielonego:

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

2. Możesz programowo sprawdzić stan operacji, uruchamiając następujące polecenie:

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

   Stan operacji wskazuje, czy interfejs API zakończył się powodzeniem, czy niepowodzeniem.

   Uwaga / Notatka

   Operacja trwa około 20~40 minut na podstawie liczby stojaków.

3. Pobierz i odczytaj zweryfikowane wyniki zwrócone przez <CABLING_REPORT_STORAGE_URL> z ukończonego polecenia.

Przykładowe dane wyjściowe są wyświetlane w poniższych sekcjach.

Przykład danych wyjściowych weryfikacji przeglądarki Edge (CE) dla przeglądarki 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 
                      } 
                    } 
                  ] 
                },

Walidacja przełącznika Tor (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 
                          } 
                        } 
                      ]

Stany weryfikacji

Atrybuty weryfikacji

Znane problemy i ograniczenia dotyczące weryfikacji kabli

• Sprawdzanie poprawności połączeń między przełącznikami TOR a serwerami obliczeniowymi, które są wyłączone lub niezakonfigurowane w klastrze Nexus, nie jest obsługiwane. Te interfejsy pokazują Unknown status w raporcie.
• Weryfikacja połączeń między interfejsami MGMT i serwerami obliczeniowymi, które są wyłączone lub nieprowizowane w klastrze Nexus lub kontrolery serwera obliczeniowego nie są obsługiwane. Te interfejsy pokazują Unknown stan w raporcie.
• Weryfikacja przewodów dla NPB nie jest obsługiwana dla loopback i nni-direct interfejsów, ponieważ obecnie brak wsparcia dostawcy dla show lldp neighbors. Te interfejsy pokazują Unknown status w raporcie.
• Protokół LLDP do odkrywania sąsiadów nie jest obsługiwany na portach urządzenia NPB, a walidacja tych portów jest wykonywana wyłącznie przy użyciu dopasowania numeru seryjnego.
• Adres URL magazynu musi znajdować się w innym regionie niż infrastruktura sieciowa. Jeśli na przykład sieć szkieletowa jest hostowana w regionie Wschodnie stany USA, adres URL magazynu powinien znajdować się poza regionem Wschodnie stany USA.
• Walidacja kabli obsługuje cztery stojaki z 16 serwerami w każdym oraz osiem stojaków z 16 serwerami na wzorce materiałowe dla każdego stojaka.
• Gdy urządzenie docelowe jest wyłączone, kable są nieobecne lub odłączone, lub jeśli walidacja nie jest obsługiwana dla typu interfejsu, wówczas interfejs wyświetla Unknown stan. Ważne jest, aby ocenić wszystkie Unknown interfejsy, które są Not-Connected względem BOM, aby określić, czy są wymagane działania naprawcze.

Typowa walidacja kabli NonCompliant i problemy Unknown

Konwertowanie raportu weryfikacji kabli do formatu HTML

Zapoznaj się z tematem How to Convert Cable Validation report JSON output to HTML.