Collecting Amber File

InfiniBand and Ethernet Switches 

InfiniBand and Ethernet switches have one MST device for which Amber file is collected. Following command can be used to collect amber file:

1. Find the MST device by running the command: 

   # sudo mst status -v
   

2. Run mlxlink command to collect the amber: 

   # mlxlink -d <mst device name> --amber_collect <path to save the amber file>

   Example: 

   mlxlink –d /dev/mst/mt54000_pciconf0 –amber_collect /tmp/amber.csv

XDR Switches

On XDR switches there are four devices - one per ASIC.

1. To get the amber for all the ASICs, create a planarized device. To do so, run the following command:

   # sudo mst start --planarized_device_pci

   Expected output:
   

2. Run mlxlink command for the planarized device:  

   sudo mlxlink -d /dev/mst/planarized_device_pci --amber_collect <path to save the amber file>

   Example: 

   sudo mlxlink -d /dev/mst/planarized_device_pci --amber_collect /tmp/amber.csv

   This command creates four amber files – one per ASIC and labels the file name as: amber_ASIC_0.csv, amber_ASIC_1.csv, amber_ASIC_2.csv, amber_ASIC_3.csv
   Each amber file will have information for a particular split port.

Last updated: August 06, 2025