DUMP2PSL(1)

NAME
dump2psl.pl - Dump psl file to be used for credit loop checking based on some opensm output files

SYNOPSIS
cat opensm-{subnet.lst,path-records.dump} | dump2psl.pl > opensm.psl

DESCRIPTION
dump2psl.pl dumps a psl file based on some opensm output files. A psl file contains paths (including SLs) and is needed for subsequent credit loop checking (via ibdmchk). This conversion is needed when ibutils is not installed and credit loop checking is done on a different machine or later. Credit loop checking is especially valuable for the QoS based routing algorithms (e.g. torus-2QoS, lash, etc.).

ibdiagnet -vlr dumps the psl (and slvl) files needed for ibdmchk -M -a -s (which is the credit loop check).

Dumping of path records is accomplished by the PathRecord dumping plugin to the OpenSM. When the environment variable DUMP_FULL_PATH_RECORDS is set to 1, the full set of SA path records is dumped to opensm-path-records.dump in the dump_files_dir directory (default is /var/log).

When the routing protocol is torus-2QoS, the following two files are dumped by the PathRecord dumping plugin: opensm-peer-paths.dump and opensm-sw2sw-path-records.dump. The peer paths dump file contains the CAs and their neighbor switch and includes the link MTU and RATE. The switch to switch file contains for each source switch a table of destination switches and the SL, RATE, and MTU to be used for MPI traffic.

Note that since the PathRecord dump uses port GUIDs and the ibdmchk psl file uses node GUIDs, the fabric .lst file is also required as input (see SYNOPSIS).

SEE ALSO

dump2slvl(1), ibdmchk(1), ibdiagnet(1)

AUTHOR
Hal Rosenstock, Mellanox Technologies LTD, hal@mellanox.com