JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Sun Datacenter InfiniBand Switch 36 Topic Set
search filter icon
search icon

Document Information

Using This Documentation

Related Documentation

Documentation, Support, and Training

User's Guide

Installing the Switch

Understanding Switch Specifications

Routing Service Cables

Understanding InfiniBand Cabling

Preparing for Installation

Verify Shipping Carton Contents

Route the InfiniBand Cables

Install the Switch in the Rack

Powering On the Switch

Connecting InfiniBand Cables

Verifying the InfiniBand Fabric

Administering the Switch

Troubleshooting the Switch

Understanding Administrative Commands

Monitoring the Hardware

Monitoring the InfiniBand Fabric

Monitoring the Subnet Manager

Controlling the Hardware

Controlling the InfiniBand Fabric

Controlling the Subnet Manager

Servicing the Switch

Replaceable Components

Servicing Power Supplies

Servicing Fans

Servicing InfiniBand Cables

Servicing the Battery

Firmware Upgrades

Remote Management

Understanding Oracle ILOM on the Switch

Oracle ILOM Overview

Supported Features

Understanding Oracle ILOM Targets

Installing the Oracle ILOM Firmware

Firmware Delivery

Acquire the Oracle ILOM Firmware Version 1.1.3

Install the Oracle ILOM Firmware Version 1.1.3

Administering Oracle ILOM (CLI)

CLI Overview

Accessing Oracle ILOM From the CLI

Switching Between the Oracle ILOM Shell and the Linux Shell

Monitoring Oracle ILOM Targets (CLI)

Controlling Oracle ILOM Targets (CLI)

Upgrading the Switch Firmware Through Oracle ILOM (CLI)

Administering Oracle ILOM (Web)

Web Interface Overview

Access Oracle ILOM From the Web Interface

Monitoring Oracle ILOM Targets (Web)

Controlling Oracle ILOM Targets (Web)

Upgrading the Switch Firmware Through Oracle ILOM (Web)

Using the Fabric Monitor

Access the Fabric Monitor

Fabric Monitor Features

Accessing the Rear Panel Diagram

Accessing Status Pane Information

Control Panel Function

Monitoring Parameters and Status

Administering Oracle ILOM (SNMP)

SNMP Overview

Understanding SNMP Commands

Monitoring Oracle ILOM Targets (SNMP)

Controlling Oracle ILOM Targets (SNMP)

Administering Hardware (IPMI)

ipmitool Overview

Display the Sensors' State (IPMI)

Display the Sensor Information (IPMI)

Display the System Event Log (IPMI)

Display FRU ID Information (IPMI)

Display Switch Status LED States (IPMI)

Enable the Locator LED (IPMI)

Disable the Locator LED (IPMI)

Understanding Oracle ILOM Commands

cd Command

create Command

delete Command

dump Command

exit Command (ILOM)

help Command (ILOM)

load Command

reset Command

set Command

show Command

version Command (ILOM)


Understanding Hardware Commands

Linux Shells for Hardware Commands

chassis_led Command

checkboot Command

checkguidfilesftree Command

checkpower Command

checktopomax Command

checkvoltages Command

connector Command

dcsport Command

disablecablelog Command

disablelinklog Command

disablesm Command

disableswitchport Command

enablecablelog Command

enablelinklog Command

enablesm Command

enableswitchport Command

env_test Command

exit Command (Hardware)

generatetopology Command

getfanspeed Command

getmaster Command

getnm2type Command

getportstatus Command

help Command (Hardware)

ibdevreset Command

listlinkup Command

managementreset Command

matchtopology Command

setcontrolledhandover Command

setloghost Command

setmsmlocationmonitor Command

setsmpriority Command

setsubnetprefix Command

showfruinfo Command

showpsufru Command

showsmlog Command

showtemps Command

showtopology Command

showunhealthy Command

smconfigtest Command

version Command (Hardware)

Understanding InfiniBand Commands

Linux Shells for InfiniBand Commands

ibaddr Command

ibcheckerrors Command

ibchecknet Command

ibchecknode Command

ibcheckport Command

ibcheckportstate Command

ibcheckportwidth Command

ibcheckstate Command

ibcheckwidth Command

ibclearcounters Command

ibclearerrors Command

ibdatacounters Command

ibdatacounts Command

ibdiagnet Command

ibdiagpath Command

ibhosts Command

ibnetdiscover Command

ibnetstatus Command

ibnodes Command

ibportstate Command

ibroute Command

ibrouters Command

ibstat Command

ibstatus Command

ibswitches Command

ibsysstat Command

ibtracert Command

perfquery Command

saquery Command

sminfo Command

smpdump Command

smpquery Command

Understanding SNMP MIB OIDs

OID Tables Overview

Understanding the SUN-DCS-MIB MIB OIDs



Understanding the SUN-PLATFORM-MIB MIB OIDs

Understanding the ENTITY-MIB MIB OIDs


setcontrolledhandover Command

Enables or disables controlled handover.


setcontrolledhandover state|list

where state is either TRUE or FALSE.


This hardware command enables or disables the controlled handover feature. The TRUE option enables and the FALSE option disables the action. The list option provides a listing of the Subnet Manager settings in respect to priority, controlled handover, and subnet prefix.

Note - You must stop or disable the OpenSM Subnet Manager before using the setcontrolledhandover command. See disablesm Command.

The InfiniBand specification identifies two parameters used to negotiate a master Subnet Manager - the Subnet Manager priority and the port GUID. Should two or more Subnet Managers have the same highest configured priority, the Subnet Manager with the lowest GUID becomes the master Subnet Manager.

If an un-controlled or automatic handover state exists, when the primary-and-master Subnet Manager fails, the secondary-and-standby Subnet Manager takes on the role of the new master Subnet Manager. During this time, traffic is temporarily suspended as the secondary-and-master Subnet Manager discovers and sets up the InfiniBand fabric.

If the primary Subnet Manager is able to recover from the failure, reboot, and reinitialize itself, it identifies itself as the intended master Subnet Manager. Again, traffic is temporarily suspended as the primary-and-master Subnet Manager re-discovers and sets up the InfiniBand fabric. The secondary Subnet Manager returns to the standby status.

If controlled handover is enabled, then some priority values become reserved. The Subnet Managers dynamically adjust their respective priorities to avoid the dual handover situation. A secondary Subnet Manager that became a master Subnet Manager due to a handover raises its priority to a reserved value and retains its master Subnet Manager status. Regardless if the primary Subnet Manager comes back online, the second handover does not occur.

The user-configured priorities of the Subnet Managers are retained, only during a handover are reserved priorities used.

The result of this scheme is that the user-configured priority is respected during system boot, but dual handover does not occur because the primary Subnet Manager loses its master Subnet Manager status (secondary Subnet Manager priority changes to reserve).

Note - Manually starting Subnet Managers individually is equivalent to the system boot sequence.

The setcontrolledhandover command is available from the /SYS/Fabric_Mgmt Linux shell target of the Oracle ILOM CLI interface.


The following example shows how to enable a controlled handover of Subnet Managers with the setcontrolledhandover command.

# setcontrolledhandover TRUE
/etc/opensm/opensm.conf updated 
setcontrolledhandover:INFO:Current setting in /etc/opensm/opensm.conf:
controlled_handover TRUE
setcontrolledhandover:INFO:Current setting in /etc/opensm/opensm.conf:
sm_priority 0
Related Information