Bagikan melalui


Memvalidasi Kabel untuk Nexus Network Fabric

Artikel ini menjelaskan validasi kabel Fabric, di mana fungsi utama API diagnostik adalah memeriksa semua perangkat fabric untuk potensi masalah kabel. API Diagnostik menilai apakah perangkat yang saling terhubung mematuhi Bill of Materials (BOM) dan sesuai dengan sumber daya Stock Keeping Units (SKU), mengklasifikasikannya sebagai sesuai atau tidak patuh. Jenis perangkat termasuk perangkat Customer Edge (CE), Top of Rack (TOR), Management (MGMT), dan Network Packet Broker (NPB). Hasilnya disajikan dalam format JSON, mencakup detail seperti status validasi, kesalahan, jenis pengidentifikasi, dan ID perangkat tetangga. Hasil ini disimpan di akun Penyimpanan yang disediakan pelanggan. Sangat penting untuk penyebaran keseluruhan bahwa kesalahan yang diidentifikasi dalam laporan ini diselesaikan sebelum pindah ke langkah penyebaran Kluster.

Untuk detail BOM, lihat SKU Nexus Operator Azure

Prasyarat

  • Pastikan Nexus Network Fabric berhasil disediakan.
  • Berikan ID Network Fabric dan URL penyimpanan dengan akses WRITE melalui tiket dukungan.
  • Akun penyimpanan memiliki prasyarat ini:
    • Akun penyimpanan harus berada di wilayah Azure yang berbeda dari wilayah Network Fabric Azure.
    • Storage Blob Data Contributor peran harus ditetapkan ke dengan akses yang Nexus Network Fabric RP ditetapkan ke akun penyimpanan.
  • Dukungan Microsoft harus menambal Nexus Network Fabric dengan URL SAS penyimpanan aktif sebelum menjalankan validasi kabel.

Membuat Permintaan Dukungan Azure untuk Patching Nexus Network Fabric:

  • Lihat Cara membuat permintaan dukungan Azure
  • Masukkan Nexus Network Fabric untuk masalah ini dan klik Go.
  • Pilih Azure Operator Nexus sebagai layanan yang mengalami masalah.
  • Pilih Subscription tempat sumber daya berada.
  • Pilih General di bawah bidang sumber daya dan klik Next.
  • Pilih Network fabric instance provisioning di bawah perintah masalah dan klik Next.
  • Sekarang pilih Create a support request di bagian atas bilah dukungan.
  • Klik Next pada tab Problem description .
  • Tunggu Recommended solution lalu klik tautan kembali ke 'Kembali ke permintaan dukungan'
  • Klik Next lagi pada Problem description tab untuk melanjutkan Additional details
  • Isi detail permintaan yang diperlukan untuk menambal Nexus Network Fabric lalu klik Next
  • Tinjau informasi di tab Review + create lalu klik Create.

Catatan

URL Penyimpanan (SAS) berumur pendek. Secara default, diatur kedaluwarsa dalam delapan jam. Jika URL SAS kedaluwarsa, maka fabric harus di-patch ulang.

Membuat URL penyimpanan

Untuk membuat kontainer di akun penyimpanan, lihat Membuat kontainer

Catatan

Masukkan nama kontainer hanya menggunakan huruf kecil.

Untuk menghasilkan URL SAS untuk kontainer guna menyediakan akses tulis ke Nexus Fabric, lihat Membuat tanda tangan akses bersama

Catatan

URL SAS berumur pendek. Secara default, diatur kedaluwarsa dalam delapan jam. Jika URL SAS kedaluwarsa, Maka Anda harus membuka tiket dukungan Microsoft untuk menambahkan URL baru.

Memvalidasi Kabel

  1. Jalankan perintah Azure CLI berikut:

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

    Output berikut (terpotong) muncul. Salin URL dari bagian Azure-AsyncOperation output debug. Bagian URL ini digunakan dalam langkah berikut untuk memeriksa status operasi.

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

    Kesalahan berikut menunjukkan Fabric tidak di-patch dengan URL SAS yang valid:

    azure.core.exceptions.HttpResponseError: Operation returned an invalid status 'OK'
    
  2. Anda dapat memeriksa status operasi secara terprogram dengan menjalankan perintah berikut:

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

    Status operasi menunjukkan apakah API berhasil atau gagal.

    Catatan

    Operasi ini membutuhkan waktu sekitar 20 ~40 menit untuk diselesaikan berdasarkan jumlah rak.

  3. Unduh dan baca hasil yang divalidasi dari yang <CABLING_REPORT_STORAGE_URL> dikembalikan dari perintah selesai.

Contoh output ditampilkan di bagian berikut.

Contoh output validasi Customer Edge (CE) ke 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 
                      } 
                    } 
                  ] 
                },

Validasi switch Customer Edge ke Top Of Rack (TOR)

{ 
                      "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 validasi

Tipe Status Definisi
Sesuai Status validasi sesuai dengan spesifikasi BOM untuk antarmuka.
NonCompliant Validasi tidak sesuai dengan spesifikasi BOM untuk antarmuka.
Tidak dikenal Validasi tidak dapat mengambil detail koneksi antarmuka atau data lldp tidak dikembalikan. Status Unknown dikembalikan jika perangkat tujuan dimatikan, hilang, terputus, atau tidak didukung untuk jenis antarmuka ini.

Atribut validasi

Atribut Definisi
deviceConfiguration Konfigurasi yang tersedia di perangkat.
error Kesalahan dari perangkat.
reason Bidang ini diisi ketika status perangkat tidak diketahui.
validationType Parameter ini menunjukkan jenis validasi apa. (validasi spesifikasi kabel & kabel).
deviceDestinationResourceId ID Azure Resource Manager dari Tetangga yang terhubung (perangkat tujuan).
roleName Peran Network Fabric Device (CE atau TOR).

Masalah dan batasan yang diketahui dalam validasi kabel

  • Validasi Kabel koneksi antara TOR dan Server Komputasi yang dimatikan atau tidak disediakan di kluster Nexus tidak didukung. Antarmuka ini menunjukkan Unknown status dalam laporan.
  • Validasi Kabel koneksi antara antarmuka MGMT dan Server Komputasi yang dimatikan atau tidak diprovisikan di kluster Nexus atau Pengontrol Server Komputasi tidak didukung. Antarmuka ini menunjukkan Unknown status dalam laporan.
  • Validasi Kabel untuk NPB tidak didukung untuk loopback antarmuka dan nni-direct karena saat ini tidak ada dukungan vendor untuk show lldp neighbors. Antarmuka ini menunjukkan Unknown status dalam laporan.
  • URL Penyimpanan harus berada di wilayah yang berbeda dari Network Fabric. Misalnya, jika Fabric dihosting di US Timur, URL penyimpanan harus berada di luar US Timur.
  • Validasi kabel mendukung empat rak dengan 16 Komputasi per rak dan delapan rak dengan 16 Komputasi per BOM rak.
  • Saat perangkat tujuan dimatikan, kabel hilang atau terputus, atau jika validasi tidak didukung untuk jenis antarmuka, maka antarmuka menunjukkan Unknown status. Penting untuk mengevaluasi semua Unknown antarmuka yang bertentangan Not-Connected dengan BOM untuk menentukan apakah tindakan perbaikan diperlukan.

Validasi NonCompliant dan Unknown Masalah kabel umum

validationType Status Kesalahan Resolusi
CableValidation NonCompliant Device cable connection is incorrect. Verifikasi koneksi pada antarmuka sumber dan tujuan yang cocok dengan BOM. deviceConfiguration dapat membantu mengidentifikasi tanggal port tujuan yang dikembalikan pada antarmuka.
CableValidation Unknown Unable to fetch data from the device. Verifikasi koneksi pada antarmuka sumber dan tujuan tersambung dan cocok dengan BOM
CableValidation NonCompliant Device cabling in <INTERFACE> incorrect. Antarmuka tidak tersambung. Verifikasi koneksi pada antarmuka sumber dan tujuan terhubung sesuai dengan BOM.
CableValidation Unknown Port <INTERFACE> has no connections as per device response. Verifikasi koneksi pada antarmuka sumber dan tujuan terhubung dan cocok dengan BOM.
CableSpecificationValidation Unknown Unable to fetch Interface Status for <INTERFACE>. Verifikasi koneksi pada antarmuka sumber dan tujuan terhubung dan cocok dengan BOM.
CableSpecificationValidation NonCompliant Device cable connection is incorrect Verifikasi kartu antarmuka dan kabel yang cocok dengan spesifikasi BOM di antarmuka ini.

Mengonversi Laporan Validasi Kabel ke Format HTML

Lihat Cara Mengonversi output JSON laporan Validasi Kabel ke HTML.