User Manual

Rev 2.1-1.0.6
Mellanox Technologies
181
8.8.2 Installing the Adaptive Routing
Adaptive Routing Manager is a Subnet Manager plug-in, i.e. it is a shared library (libarmgr.so)
that is dynamically loaded by the Subnet Manager. Adaptive Routing Manager is installed as a
part of Mellanox OFED installation.
8.8.3 Running Subnet Manager with Adaptive Routing Manager
Adaptive Routing (AR) Manager can be enabled/disabled through SM options file.
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 184.
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.