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 yangNexus 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 klikGo
. - Pilih
Azure Operator Nexus
sebagai layanan yang mengalami masalah. - Pilih
Subscription
tempat sumber daya berada. - Pilih
General
di bawah bidang sumber daya dan klikNext
. - Pilih
Network fabric instance provisioning
di bawah perintah masalah dan klikNext
. - Sekarang pilih
Create a support request
di bagian atas bilah dukungan. - Klik
Next
pada tabProblem description
. - Tunggu
Recommended solution
lalu klik tautan kembali ke 'Kembali ke permintaan dukungan' - Klik
Next
lagi padaProblem description
tab untuk melanjutkanAdditional details
- Isi detail permintaan yang diperlukan untuk menambal Nexus Network Fabric lalu klik
Next
- Tinjau informasi di tab
Review + create
lalu klikCreate
.
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
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'
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.
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 dannni-direct
karena saat ini tidak ada dukungan vendor untukshow lldp neighbors
. Antarmuka ini menunjukkanUnknown
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 semuaUnknown
antarmuka yang bertentanganNot-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.