Weryfikowanie dla sieci szkieletowej Nexus

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 wyniki są przechowywane na koncie magazynu dostarczonym przez klienta. Przed przejściem do kroku wdrożenia klastra należy rozwiązać ogólne wdrożenie, które błędy zidentyfikowane w tym raporcie zostały rozwiązane.

Aby uzyskać szczegółowe informacje na temat modelu BOM, zapoznaj się z jednostkami SKU Nexus operatora platformy Azure

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 magazynu 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 do konta magazynu z dostępem przypisanym do konta magazynu.
• pomoc techniczna firmy Microsoft musi zostać poprawiona sieć szkieletowa Nexus przy użyciu aktywnego adresu URL sygnatury dostępu współdzielonego magazynu przed uruchomieniem weryfikacji okablowania.

Tworzenie żądania pomocy technicznej platformy Azure dotyczącego stosowania poprawek sieci szkieletowej Nexus:

• Zapoznaj się z artykułem Jak utworzyć żądanie pomoc techniczna platformy Azure
• Wprowadź Nexus Network Fabric wartość problemu i kliknij pozycję 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 wierszu polecenia problemu, a następnie kliknij pozycję Next.
• Teraz wybierz Create a support request w górnej części bloku pomocy technicznej.
• Kliknij Next kartę Problem description .
• Poczekaj Recommended solution , a następnie kliknij link z powrotem do "Powrót do wniosku o pomoc techniczną"
• Kliknij Next ponownie kartę Problem description , aby kontynuować Additional details
• Wypełnij wymagane szczegóły żądania, aby zastosować poprawkę sieci szkieletowej Nexus, a następnie kliknij przycisk Next
• Przejrzyj informacje na Review + create karcie, a następnie kliknij pozycję Create.

Uwaga

Adres URL magazynu (SAS) jest krótkotrwały. Domyślnie jest ona ustawiana na wygaśnięcie w ciągu ośmiu godzin. Jeśli adres URL sygnatury dostępu współdzielonego wygaśnie, sieć szkieletowa musi zostać ponownie poprawiona.

Generowanie adresu URL magazynu

Aby utworzyć kontener na koncie magazynu, zobacz Tworzenie kontenera

Uwaga

Wprowadź nazwę kontenera, używając tylko małych liter.

Aby wygenerować adres URL sygnatury dostępu współdzielonego dla kontenera w celu zapewnienia dostępu do zapisu w sieci szkieletowej Nexus, zobacz Generowanie sygnatury dostępu współdzielonego

Uwaga

Adresy URL sygnatur dostępu współdzielonego są krótkotrwałe. Domyślnie jest ona ustawiana na wygaśnięcie w ciągu ośmiu godzin. Jeśli adres URL sygnatury dostępu współdzielonego wygaśnie, musisz otworzyć bilet pomocy technicznej firmy Microsoft, aby dodać nowy adres URL.

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 sieć szkieletowa nie jest poprawna przy użyciu prawidłowego adresu URL sygnatury 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

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

3. Pobierz i odczyt zweryfikowanych wyników zwróconych <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

Typ stanu	Definicja
Zgodne	Stan weryfikacji jest zgodny ze specyfikacją BOM interfejsu.
Niezgodnych	Walidacja nie jest zgodna ze specyfikacją BOM interfejsu.
Nieznane	Walidacja nie może pobrać szczegółów połączenia interfejsu lub dane lldp nie są zwracane. Stan Unknown jest zwracany, jeśli urządzenie docelowe jest wyłączone, brakuje, odłączone lub nieobsługiwane dla tego typu interfejsu.

Atrybuty weryfikacji

Atrybut	Definicja
deviceConfiguration	Konfiguracja dostępna na urządzeniu.
error	Błąd z urządzenia.
reason	To pole jest wypełniane, gdy stan urządzenia jest nieznany.
validationType	Ten parametr wskazuje typ weryfikacji. (weryfikacje specyfikacji i).
deviceDestinationResourceId	Identyfikator usługi Azure Resource Manager połączonego sąsiada (urządzenia docelowego).
roleName	Rola urządzenia sieci szkieletowej (CE lub TOR).

Znane problemy i ograniczenia dotyczące weryfikacji

• Sprawdzanie poprawności połączeń między serwerami TOR i obliczeniowymi, które są wyłączone lub nieprowizowane w klastrze Nexus, nie są obsługiwane. Te interfejsy pokazują Unknown stan 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 dla serwera NPB nie jest obsługiwana w przypadku loopback interfejsów i nni-direct , ponieważ obecnie nie ma obsługi dostawcy dla programu show lldp neighbors. Te interfejsy pokazują Unknown stan w raporcie.
• Adres URL magazynu musi znajdować się w innym regionie niż sieć szkieletowa sieci szkieletowej. 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 obsługuje cztery stojaki z 16 obliczeniami na stojak i osiem stojaków z 16 obliczeniami na jednostki BOM stojaka.
• Gdy urządzenie docelowe jest wyłączone, brakuje lub rozłączono je lub jeśli walidacja nie jest obsługiwana dla typu interfejsu, interfejs wyświetla Unknown stan. Ważne jest, aby ocenić wszystkie Unknown interfejsy, które są Not-Connected względem modelu BOM, aby określić, czy jest wymagana akcja naprawy.

Typowe problemy i Unknown walidacja NonCompliant

validationType	Stan	Błąd	Rozwiązanie
CableValidation	NonCompliant	Device cable connection is incorrect.	Sprawdź, czy połączenia w interfejsach źródłowych i docelowych są zgodne z modelem BOM. Element deviceConfiguration może pomóc zidentyfikować datę portu docelowego zwróconą w interfejsie.
CableValidation	Unknown	Unable to fetch data from the device.	Sprawdź, czy połączenia w interfejsach źródłowych i docelowych są połączone i pasują do modelu BOM
CableValidation	NonCompliant	Device cabling in <INTERFACE> incorrect.	Interfejs nie jest połączony. Sprawdź, czy połączenia w interfejsach źródłowych i docelowych są połączone, są zgodne z modelem BOM.
CableValidation	Unknown	Port <INTERFACE> has no connections as per device response.	Sprawdź, czy połączenia w interfejsach źródłowych i docelowych są połączone i pasują do modelu BOM.
CableSpecificationValidation	Unknown	Unable to fetch Interface Status for <INTERFACE>.	Sprawdź, czy połączenia w interfejsach źródłowych i docelowych są połączone i pasują do modelu BOM.
CableSpecificationValidation	NonCompliant	Device cable connection is incorrect	Sprawdź, czy karta interfejsu i pasują do specyfikacji BOM w tym interfejsie.

Konwertowanie raportu weryfikacji na format HTML

Zapoznaj się z tematem How to Convert Cable Validation report JSON output to HTML (Jak konwertować dane wyjściowe raportu weryfikacji na kod HTML).