Broadcom NICCLI Configuration Utility
NICCLI ist ein 2023 erstmals veröffentlichtes Tool von Broadcom, welches das bisherige bnxtnvm Tool ersetzt. Bei NICCLI gibt es verschiedene Modi für die Benutzung, man unterschiedet zwischen Interactive Modus, One Line Modus und Batch Modus.
Dieser Artikel bietet einen Einstieg in NICCLI und zeigt nützliche Befehle auf, die für die Konfiguration von Broadcom-Netzwerkkarten nützlich sein können:
Interactive Modus
- Aufruf durch die Eingabe von niccli in der Shell
- Anschließend wird folgender Prompt ausgegeben:
root@PMX4:~# niccli ------------------------------------------------------------------------------- Scrutiny NIC CLI v227.0.130.0 - Broadcom Inc. (c) 2023 (Bld-61.52.25.90.16.0) ------------------------------------------------------------------------------- BoardId MAC Address FwVersion PCIAddr Type Mode 1) BCM57508 84:16:0C:6F:0F:10 216.0.251.4 00:01:00:00 NIC PCI 2) BCM57508 84:16:0C:6F:0F:11 216.0.251.4 00:01:00:01 NIC PCI 3) BCM57416 00:62:0B:31:7F:00 226.0.145.0 00:41:00:00 NIC PCI 4) BCM57416 00:62:0B:31:7F:01 226.0.145.0 00:41:00:01 NIC PCI 5) BCM57504 00:62:0B:6E:E5:48 226.0.145.1 00:81:00:00 NIC PCI 6) BCM57504 00:62:0B:6E:E5:48 226.0.145.1 00:81:00:01 NIC PCI 7) BCM57504 00:62:0B:6E:E5:4A 226.0.145.1 00:81:00:02 NIC PCI 8) BCM57504 00:62:0B:6E:E5:4B 226.0.145.1 00:81:00:03 NIC PCI Enter the target index to connect with : 4 BCM57416>
Die Indexnummern der jeweiligen Ports (hier: 1-8) werden zusätzlich zu weiteren Informationen (wie FW Version, PCI Adresse, etc.) angezeigt. Um nun mit der Konfiguration zu starten muss der Index des Ports eingegeben werden. Anschließend werden alle weiteren Kommandos nur auf diesen Port angewendet. Dieser Index wird allerdings auch beim One Line Modus verwendet, um den zu konfigurierenden Port anzugeben. Um das Fenster zu verlassen, geben Sie quit ein.
BCM57416> quit root@PMX4:~#
One Line Modus
Der One Line Modus wird den meisten von bnxtnvm noch bekannt sein, hier hat sich lediglich die Syntax von manchen Befehlen geändert:
# Ausgabe aller unterstützen Netzwerkkarten niccli --list # Anzeigen aller Geräte inkl. Gerätetyp niccli --listdev # FW Update niccli -i [Indexnummer] install [FW Package] # Verifizierung der installierten Firmware niccli -i [Indexnummer] verify # Anzeigen der aktuell installierten FW niccli -i [Indexnummer] pkgver # Anzeigen von Device Infos niccli -i [Indexnummer] show # Temperatur auslesen niccli -i [Indexnummer] device_temperature # Auflistung aller Konfigurationsoptionen niccli -i [Indexnummer] nvm -getoption [Optionenname] -scope [Portindex] # Konfiguration aller Optionen niccli -i [Indexnummer] nvm -setoption [Optionenname] -scope [Portindex] -value [Wert]
Alternativ zu -i [Indexnummer] können Sie auch -pci [PCI-ID] nutzen.
All diese Befehle können Sie auch im Interactive oder Batch Modus anwenden.
Batch Modus
Der Batch Modus bietet die Möglichkeit, innerhalb einer Datei mehrere Kommandos anzugeben, welche durch das Einbinden der Datei nacheinander ausgeführt werden.
Ein Beispiel für das Auslesen von Geräteinformationen, Temperatur und FW Version:
root@PMX4:~# cat script device_info device_temperature pkgver
root@PMX4:~# niccli -i 1 --batch script ------------------------------------------------------------------------------- Scrutiny NIC CLI v227.0.130.0 - Broadcom Inc. (c) 2023 (Bld-61.52.25.90.16.0) ------------------------------------------------------------------------------- Executing command : 'device_info' Interface Name : enp1s0f0np0 MAC Address : 84:16:0C:6F:0F:10 Base MAC Address : 84:16:0C:6F:0F:10 Serial Number : P21002218000CWFV Part Number : BCM957508-P2100G PCI Address : 0000:01:00:00 Chip Number : BCM57508 Chip Name : THOR Description : Broadcom NetXtreme-E Dual-port 100Gb Ethernet PCIe Adapter Active Package Name : 216.0.293.8 Firmware Name : PRIMATE_FW Firmware Version : 216.0.251.4 RoCE Firmware Version : 216.0.251.0 HWRM Interface Spec : 1.10.1 Kong mailbox channel : Not Applicable Trusted VFs : Supported Active Package Version : 216.0.293.8 Package Version on NVM : 216.0.293.8 PCI Device ID : 0x1750 PCI Vendor ID : 0x14E4 PCI Revision ID : 0x11 PCI Component ID : 0x1750 PCI Subsys Device ID : 0x2100 PCI Subsys Vendor ID : 0x14E4 Active NVM config version : 0.0.14 NVM config version : 0.0.14 Reboot Required : No Firmware Reset Counter : 0 Error Recovery Counter : Not Available Crash Dump Timestamp : Not Available Secure Boot : Enabled Secure Firmware Update : Enabled FW Image Status : Operational Crash Dump Available in DDR : No Executing command : 'device_temperature' Device Temperature : 41 Celsius PHY Temperature : 44 Celsius Optical Module Temperature : 0 Celsius Executing command : 'pkgver' Package Information : Active Package Version : 216.0.293.8 Package Version on NVM : 216.0.293.8 Primary SBI Version : 0.0.1.80 Secondary SBI Version : 0.0.1.80 Primary SRT Version : 216.0.251.4 Secondary SRT Version : 216.0.251.4 Primary SRT Version : Not Available Secondary SRT Version : Not Available
Autor: Niklas Pauli Niklas Pauli arbeitet im Product Management Team von Thomas-Krenn. Er absolvierte am Gymnasium Freyung seine Allgemeine Hochschulreife und ist seit 2021 als Azubi zum Fachinformatiker für Systemintegration bei Thomas-Krenn beschäftigt. Dabei beschäftigt sich Herr Pauli unter anderem mit Proxmox Virtualisierung oder dem Thomas-Krenn-Wiki. |