User Manual

OpenSM – Subnet ManagerRev 2.2-1.0.1
Mellanox Technologies
212
8.8.3.1 Enabling Adaptive Routing
To enable Adaptive Routing, perform the following:
1. Create the Subnet Manager options file. Run:
opensm -c <options-file-name>
2. Add 'armgr' to the 'event_plugin_name' option in the file:
# Event plugin name(s)
event_plugin_name armgr
3. Run Subnet Manager with the new options file:
opensm -F <options-file-name>
Adaptive Routig Manager can read options file with various configuration parameters to fine-
tune AR mechanism and AR Manager behavior. Default location of the AR Manager options file
is
/etc/opensm/ar_mgr.conf.
To provide an alternative location, please perform the following:
1. Add '
armgr --conf_file <ar-mgr-options-file-name>' to the 'event_plugin_options'
option in the file
# Options string that would be passed to the plugin(s)
event_plugin_options armgr --conf_file <ar-mgr-options-file-name>
2. Run Subnet Manager with the new options file:
opensm -F <options-file-name>
See an example of AR Manager options file with all the default values in “Example of Adaptive
Routing Manager Options File” on page 215.
8.8.3.2 Disabling Adaptive Routing
There are two ways to disable Adaptive Routing Manager:
1. By disabling it explicitly in the Adaptive Routing configuration file.
2. By removing the 'armgr' option from the Subnet Manager options file.
Adaptive Routing mechanism is automatically disabled once the switch
receives setting of the usual linear routing table (LFT).
Therefore, no action is required to clear Adaptive Routing configuration on the switches if you
do not wish to use
Adaptive Routing.
8.8.4 Querying Adaptive Routing Tables
When Adaptive Routing is active, the content of the usual Linear Forwarding Routing Table on
the switch is invalid, thus the standard tools that query LFT (e.g. smpquery, dump_lfts.sh, and
others) cannot be used. To query the switch for the content of its Adaptive Routing table, use the
'smparquery' tool that is installed as a part of the Adaptive Routing Manager package. To see its
usage details, run 'smparquery -h'.