mstconfig Commands
mstconfig Backup Command
The backup command is used to save the current non-volatile configurations (TLV) in the deviceinto a
file in raw TLV syntax so it can be restored anytime using the set_raw command.
mstconfig backup command allows backing up the all of the configurations which are relatedonly to
the PCI Physical Function associated with the given MST device. To back up all of thedevice
configurations, perform the operation from every PCI Physical Function the deviceexposes. Restoring
the configurations must be made from the matching PCI Physical Function.
# mstconfig -d 41:00.0 -f /tmp/backup.conf backup
Collecting...
Saving output...
Done!
# cat /tmp/backup.conf
MLNX_RAW_TLV_FILE
% TLV Type: 0x00000400, Writer ID: ICMD mstCONFIG(0x09), Writer Host ID: 0x00
0x00000014 0x00000400 0x00000000 0x00000000 0x000e0000 0x001000f6 0x20160526
0x11250000
# mstconfig -d 41:00.0 -f /tmp/backup.conf set_raw
Raw TLV #1 Info:
Length: 0x14
Version: 0
OverrideEn: 0
Type: 0x00000400
Data: 0x00000000 0x000e0000 0x001000f6 0x20160526 0x11250000
Operation intended for advanced users.
Are you sure you want to apply raw TLV file? ? (y/n) [n] : y
Applying... Done!
-I- Please reboot machine to load new configurations.
Generating an XML Template for the Configurations
Users can generate an XML file that contains a template for the configurations. The templatedescribes
the configurations and their parameters. No values are included in the template.
To generate such a template, run the gen_tlvs_file command. This command will generate a
filecontaining a list of all supported configurations by mstconfig, with a zero appearing in the end
ofeach configuration. To choose a configuration, change the 0 to 1, then save the file and run
thegen_xml_template command. An XML file containing the required configurations will begenerated.
Example:
# mstconfig gen_tlvs_file /tmp/confs.txt
Saving output...
Done!
# cat /tmp/confs.txt
nv_host_to_bmc 0
nv_kdnet_data 0
nv_fpga_data 0
nv_packet_pacing 0
nv_debug_mode 0
nv_global_pci_conf 0
In a MultiHost environment, these operations are required to be executed per host.