Aracılığıyla paylaş


Nexus Network Fabric kablolarını doğrulama

Bu makalede, tanılama API'sinin birincil işlevinin olası kablolama sorunları için tüm doku cihazlarını denetlemek olduğu Doku kablosu doğrulaması açıklanmaktadır. Tanılama API'si, birbirine bağlı cihazların Ürün Reçetesine (BOM) bağlı olup olmadığını ve kaynak Stok Tutma Birimlerine (SKU' lar) göre uygun olup olmadığını değerlendirir ve bunları uyumlu veya uyumsuz olarak sınıflandırır. Cihaz türleri Customer Edge (CE), Raf Üstü (TOR), Yönetim (MGMT) ve Ağ Paket Aracısı (NPB) cihazlarıdır. Sonuçlar, doğrulama durumu, hatalar, tanımlayıcı türü ve komşu cihaz kimliği gibi ayrıntıları kapsayan bir JSON biçiminde sunulur. Bu sonuçlar müşteri tarafından sağlanan bir Depolama hesabında depolanır. Küme dağıtım adımına geçmeden önce bu raporda tanımlanan hataların çözümlenmesi genel dağıtım için çok önemlidir.

Ürün reçetesi ayrıntıları için bkz . Azure Operatör Nexus SKU'ları

Önkoşullar

  • Nexus Network Fabric'in başarıyla sağlandığından emin olun.
  • Destek bileti aracılığıyla WRITE erişimiyle Network Fabric Kimliğini ve depolama URL'sini sağlayın.
  • Depolama hesabının önkoşulları şunlardır:
    • Depolama hesabının Network Fabric Azure bölgesinden farklı bir Azure bölgesinde olması gerekir.
    • Storage Blob Data Contributor rolüne Nexus Network Fabric RP , depolama hesabına atanmış erişimle atanmalıdır.
  • Microsoft Desteği kablo doğrulamasını çalıştırmadan önce Nexus Network Fabric'e etkin bir depolama SAS URL'si ile düzeltme eki uygulamalıdır.

Nexus Network Fabric'e Düzeltme Eki Uygulama için Azure Destek İsteği Oluşturma:

  • bkz. Azure desteği isteği oluşturma
  • Sorun için girin Nexus Network Fabric ve öğesine tıklayın Go.
  • Sorun yaşadığınız hizmet olarak seçin Azure Operator Nexus .
  • Kaynağın bulunduğu yeri seçin Subscription .
  • Kaynak alanının altında öğesini seçin General ve öğesine tıklayın Next.
  • Sorun isteminin altında öğesini seçin Network fabric instance provisioning ve öğesine tıklayın Next.
  • Şimdi destek dikey penceresinin üst kısmından öğesini seçin Create a support request .
  • Sekmeye Problem description tıklayınNext.
  • öğesini bekleyin Recommended solution ve ardından 'Destek isteğine dön' bağlantısına tıklayın
  • Problem description Devam etmek için sekmeye yeniden tıklayın NextAdditional details
  • Nexus Network Fabric'e düzeltme eki uygulamak için gerekli istek ayrıntılarını doldurun ve ardından Next
  • Sekmedeki Review + create bilgileri gözden geçirin ve öğesine tıklayın Create.

Not

Depolama URL'si (SAS) kısa ömürlüdür. Varsayılan olarak, süresi sekiz saat içinde dolacak şekilde ayarlanır. SAS URL'sinin süresi dolarsa, dokuya yeniden düzeltme eki eklenmelidir.

Depolama URL'sini oluşturma

Depolama hesabında kapsayıcı oluşturmak için bkz . Kapsayıcı oluşturma

Not

Kapsayıcının adını yalnızca küçük harf kullanarak girin.

Nexus Fabric'e yazma erişimi sağlamak üzere kapsayıcı için sas URL'si oluşturmak için Bkz . Paylaşılan erişim imzası oluşturma

Not

SAS URL'leri kısa sürelidir. Varsayılan olarak, süresi sekiz saat içinde dolacak şekilde ayarlanır. SAS URL'sinin süresi dolarsa, yeni bir URL eklemek için bir Microsoft destek bileti açmanız gerekir.

Kablolama Doğrulama

  1. Aşağıdaki Azure CLI komutunu yürütür:

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

    Aşağıdaki (kesilmiş) çıkış görüntülenir. Hata ayıklama çıkışının Azure-AsyncOperation bölümünden URL'yi kopyalayın. URL'nin bu bölümü, işlemin durumunu denetlemek için aşağıdaki adımda kullanılır.

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

    Aşağıdaki hata, Doku'ya geçerli bir SAS URL'si ile düzeltme eki uygulamamış olduğunu gösterir:

    azure.core.exceptions.HttpResponseError: Operation returned an invalid status 'OK'
    
  2. Aşağıdaki komutu çalıştırarak işlemin durumunu program aracılığıyla deleyebilirsiniz:

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

    İşlem durumu, API'nin başarılı mı yoksa başarısız mı olduğunu gösterir.

    Not

    İşlemin tamamlanması raf sayısına göre yaklaşık 20~40 dakika sürer.

  3. Tamamlanan komutundan <CABLING_REPORT_STORAGE_URL> döndürülen doğrulanmış sonuçları indirin ve okuyun.

Örnek çıktı aşağıdaki bölümlerde gösterilmiştir.

Customer Edge (CE) -Provider Edge (PE) doğrulama çıktısı örneği

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 
                      } 
                    } 
                  ] 
                },

Customer Edge-Top Of Rack (TOR) anahtar doğrulaması

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

Doğrulama durumları

Durum Türü Tanım
Uyumlu Doğrulama durumu, arabirimin ürün reçetesi belirtimiyle uyumludur.
Uyumsuz Doğrulama, arabirim için ürün reçetesi belirtimiyle uyumlu değildir.
Bilinmiyor Doğrulama arabirim bağlantısı ayrıntılarını alamıyor veya lldp verileri döndürülmüyor. Unknown Bu arabirim türü için hedef cihaz kapalı, eksik, bağlantısı kesilmiş veya desteklenmiyorsa durum döndürülür.

Doğrulama öznitelikleri

Öznitelik Tanım
deviceConfiguration Cihazda kullanılabilen yapılandırma.
error Cihazdan hata.
reason Bu alan, cihazın durumu bilinmediğinde doldurulur.
validationType Bu parametre ne tür doğrulama olduğunu gösterir. (kablo ve kablo belirtimi doğrulamaları).
deviceDestinationResourceId Bağlı Komşunun (hedef cihaz) Azure Resource Manager kimliği.
roleName Network Fabric Cihazının (CE veya TOR) rolü.

Kablo doğrulamayla ilgili bilinen sorunlar ve sınırlamalar

  • Nexus kümesinde kapalı olan veya sağlanmayan TOR ile İşlem Sunucuları arasındaki bağlantıların Kablo Doğrulaması desteklenmez. Bu arabirimler rapordaki durumu gösterir Unknown .
  • Nexus kümesinde veya İşlem Sunucusu Denetleyicilerinde kapatılan veya sağlanmayan MGMT arabirimleri ile İşlem Sunucuları arasındaki bağlantıların Kablo Doğrulaması desteklenmez. Bu arabirimler rapordaki durumu gösterir Unknown .
  • şu anda için satıcı desteği olmadığından NPB için loopback Kablo Doğrulaması ve nni-direct arabirimleri için show lldp neighborsdesteklenmez. Bu arabirimler rapordaki durumu gösterir Unknown .
  • Depolama URL'si Network Fabric'ten farklı bir bölgede olmalıdır. Örneğin Doku Doğu ABD'de barındırılıyorsa depolama URL'si Doğu ABD dışında olmalıdır.
  • Kablo doğrulaması, raf başına 16 İşlem içeren dört rafı ve raf başına 16 İşlem ürün reçetesine sahip sekiz rafı destekler.
  • Hedef cihaz kapatıldığında, kablolar eksik veya bağlantısı kesilmiş ya da arabirim türü için doğrulama desteklenmiyorsa arabirim durumu gösterir Unknown . Onarım eyleminin gerekli olup olmadığını belirlemek için ürün reçetesine karşı olan tüm Unknown arabirimlerin Not-Connected değerlendirilmesi önemlidir.

Tipik kablo doğrulama NonCompliant ve Unknown Sorunlar

validationType Durum Hata Çözüm
CableValidation NonCompliant Device cable connection is incorrect. Kaynak ve hedef arabirimlerdeki bağlantıların ürün reçetesiyle eşleşip eşleşmedığını doğrulayın. , deviceConfiguration arabirimde döndürülen hedef bağlantı noktası tarihini belirlemeye yardımcı olabilir.
CableValidation Unknown Unable to fetch data from the device. Kaynak ve hedef arabirimlerdeki bağlantıların bağlı olduğunu ve ürün reçetesiyle eşleştiklerini doğrulayın
CableValidation NonCompliant Device cabling in <INTERFACE> incorrect. Arabirim bağlı değil. Kaynak ve hedef arabirimlerdeki bağlantıların ürün reçetesiyle eşleşip bağlanmadığını doğrulayın.
CableValidation Unknown Port <INTERFACE> has no connections as per device response. Kaynak ve hedef arabirimlerdeki bağlantıların bağlı olduğunu ve ürün reçetesiyle eşleştiklerini doğrulayın.
CableSpecificationValidation Unknown Unable to fetch Interface Status for <INTERFACE>. Kaynak ve hedef arabirimlerdeki bağlantıların bağlı olduğunu ve ürün reçetesiyle eşleştiklerini doğrulayın.
CableSpecificationValidation NonCompliant Device cable connection is incorrect Arabirim kartının ve kabloların bu arabirimdeki BOM belirtimine uygun olduğunu doğrulayın.

Kablo Doğrulama Raporunu HTML Biçimine Dönüştürme

Kablo Doğrulama raporu JSON çıkışını HTML'ye dönüştürme bölümüne bakın.