Using This Documentation This command reference provides detailed information regarding the commands for ® administering the Sun Datacenter InfiniBand Switch 72 from Oracle . This document is written for developers, system administrators, and users who have advanced experience administering InfiniBand fabrics and hardware.
Submit comments about this document by clicking the Feedback[+] link at (http://docs.sun.com). Include the title and part number of your document with your feedback: Sun Datacenter InfiniBand Switch 72 Command Reference, part number 820-7752-12. Sun Datacenter InfiniBand Switch 72 Command Reference • May 2010...
Understanding the Commands This document provides detailed information regarding the commands which are used to administer the switch. “Understanding Hardware Commands” on page 1 ■ “Understanding InfiniBand Commands” on page 23 ■ Related Information Switch User’s Guide ■ Switch Remote Administration ■...
“Understanding InfiniBand Commands” on page 23 ■ checkboot Command Displays switch chip boot status. Syntax checkboot Description This hardware command checks the boot status of the switch chip. Output is a simplified OK. Sun Datacenter InfiniBand Switch 72 Command Reference • May 2010...
Example The following example shows how to check the boot status of the switch chips with the checkboot command. # checkboot I4-A OK I4-B OK I4-C OK I4-D OK I4-E OK I4-F OK Related Information “i4reset Command” on page 14 ■...
Measured 1.2VA = 1.22 V Measured 1.2VB = 1.21 V Measured 1.2VC = 1.21 V Measured 1.2VD = 1.22 V Measured 1.2VE = 1.21 V Measured 1.2VF = 1.21 V All voltages OK Related Information “checkpower Command” on page 3 ■...
Manufacturing day. 2-byte ASCII (1st = 01). Options The following table describes the options to the connector command and their purposes: Option Purpose Checks for the presence of connector number present Sun Datacenter InfiniBand Switch 72 Command Reference • May 2010...
Option Purpose Returns the data in register reg. Data values are hexadecimal. read Writes the value of data into the register reg. Data values are converted from write decimal to hexadecimal. Example The following example shows how to write a value of 14 (E in hexadecimal) to register 218 of connector 1A with the connector command.
This hardware command disables a port on the switch chip. Example The following example shows how to disable port 1 on switch chip A with the disableswitchport command. # disableswitchport A 1 Sun Datacenter InfiniBand Switch 72 Command Reference • May 2010...
Related Information “enableswitchport Command” on page 10 ■ “ibportstate Command” on page 61 ■ enablesm Command Enables the Subnet Manager within the management controller. Syntax enablesm Description This hardware command enables the OpenSM opensmd daemon on the management controller. Note – Similarly, both the enablesm and opensm commands invoke an instance of the same Subnet Manager.
The following example shows how to enable port 1 on switch chip A with the enableswitchport command. # enableswitchport A 1 Related Information “disableswitchport Command” on page 8 ■ “ibportstate Command” on page 61 ■ Sun Datacenter InfiniBand Switch 72 Command Reference • May 2010...
env_test Command Displays environmental status. Syntax env_test Description This hardware command performs a series of hardware and environmental tests of the switch. This command is an amalgamation of the following commands: ■ checkpower checkvoltages ■ showtemps ■ ■ getfanspeed ■ connector checkboot ■...
Starting I4 test: I4-A OK I4-B OK I4-C OK I4-D OK I4-E OK I4-F OK All I4s OK I4 test returned OK NM2 Environment test PASSED getfanspeed Command Displays fan speed. Sun Datacenter InfiniBand Switch 72 Command Reference • May 2010...
Syntax getfanspeed Description This hardware command displays the speed of the fans. The command also indicates if the fan is “not present” or has “stopped”. Example The following example shows how to display fan speeds with the getfanspeed command. # getfanspeed Fan 0 rpm 17940 Fan 1 rpm 17940 Fan 2 rpm 17687...
“ibcheckportwidth Command” on page 35 ■ i4reset Command Resets the switch chip. Syntax i4reset switch_chip where switch_chip is the letter of the switch chip (A–F). Description This hardware command resets the switch chip. Sun Datacenter InfiniBand Switch 72 Command Reference • May 2010...
Example The following example shows how to reset switch chip A with the i4reset command. # i4reset A Reset I4-A Related Information “checkboot Command” on page 2 ■ “ibportstate Command” on page 61 ■ listlinkup Command Displays links presence. Syntax listlinkup Description This hardware command lists the presence of links and the up-down state of the...
The command requests a reboot, and in most situations, this should be done. The managementreset command also forces links to retrain upon management controller services startup. The -r option bypasses the query for reboot and reboots automatically. Sun Datacenter InfiniBand Switch 72 Command Reference • May 2010...
Example The following example shows how to reset the management controller and InfiniBand fabric services with the managementreset command. # managementreset Stopping Environment daemon, please wait Resetting CPLD, please wait Restarting Environment daemon Reboot needed to reconnect to I4 and enable IB ports Do you want do reboot now [yes/no]:yes Broadcast message from root (pts/0) (Fri Nov 20 17:10:27 2009): The system is going down for reboot NOW!
In this example, only the output that is bold is relevant to the administration of the switch. Related Information Switch Service, display switch chip firmware version ■ readchfru Command Displays chassis FRU information. Syntax readchfru Sun Datacenter InfiniBand Switch 72 Command Reference • May 2010...
“listlinkup Command” on page 15 ■ “ibportstate Command” on page 61 ■ setsmpriority Command Sets the Subnet Manager priority. Syntax setsmpriority priority where priority is a number from 0 (lowest) to 13 (highest). Sun Datacenter InfiniBand Switch 72 Command Reference • May 2010...
Description This hardware command sets the priority of the Subnet Manager within the management controller. You use this command when there are multiple Subnet Managers in the InfiniBand fabric. By setting a Subnet Manager to a higher priority than another Subnet Manager, it becomes the master Subnet Manager. By setting a Subnet Manager to a lower priority than another Subnet Manager, it becomes the slave Subnet Manager.
I4-B temperature 47 maxtemperature 49 I4-C temperature 52 maxtemperature 52 I4-D temperature 48 maxtemperature 49 I4-E temperature 52 maxtemperature 52 I4-F temperature 52 maxtemperature 54 Related Information “env_test Command” on page 11 ■ Sun Datacenter InfiniBand Switch 72 Command Reference • May 2010...
showunhealthy Command Displays problematic components. Syntax showunhealthy Description This hardware command shows a list of switch components that appear to have a problem. Unlike the env_test command, the showunhealty command only displays messages for components that have failed testing. Example The following example shows how to display a list of unhealthy components in the switch with the showunhealthy command.
Purpose Sets the debug level. Can be used several times to increase the debug level. Uses the directed path address. The path is a comma delimited sequence of out ports. Sun Datacenter InfiniBand Switch 72 Command Reference • May 2010...
Option Purpose Shows the LID range and GID for port GUID addresses. Shows the LID range only. Shows the GID address only. Uses the specified channel adapter name. Uses the specified channel adapter port. Overrides the default timeout. Displays the version information. Provides help.
(threshold 100) lid 25 port 9 Error check on lid 25 (Sun DCS 72 QDR FC switch o4nm2-72p-2) port 9: FAILED #warn: counter XmtDiscards = 9714 (threshold 100) lid 25 port 1 Sun Datacenter InfiniBand Switch 72 Command Reference • May 2010...
Error check on lid 25 (Sun DCS 72 QDR FC switch o4nm2-72p-2) port 1: FAILED ## Summary: 6 nodes checked, 0 bad nodes found 142 ports checked, 3 ports have errors beyond threshold Note – The output in the example is just a portion of the full output. Related Information ibcheckerrors man page ■...
## Summary: 6 nodes checked, 0 bad nodes found 142 ports checked, 0 bad ports found 3 ports have errors beyond threshold Note – The output in the example is just a portion of the full output. Sun Datacenter InfiniBand Switch 72 Command Reference • May 2010...
ca_name is the channel adapter name. ■ ca_port is the channel adapter port. ■ timeout is the timeout in milliseconds. ■ lid is the local identifier. ■ guid is the global unit identifier. ■ port is the port being validated. ■...
■ port is the port being validated. ■ Description This InfiniBand command checks the specified port for the logical (Active) and physical (LinkUp) states. Sun Datacenter InfiniBand Switch 72 Command Reference • May 2010...
Note – The port address is a LID, unless the -G option is used to specify a GUID address. Options The following table describes the options to the ibcheckportstate command and their purposes: Option Purpose Uses the port GUID address. Provides help.
Uses the port GUID address. Provides help. Uses mono mode instead of color mode. Uses the specified channel adapter name. Uses the specified channel adapter port. Overrides the default timeout. Sun Datacenter InfiniBand Switch 72 Command Reference • May 2010...
Example The following example shows how to check the width of port 8 on LID 24 with the ibcheckportwidth command. # ibcheckportwidth -v 24 8 Port check lid 24 port 8: Related Information ibcheckportwidth man page ■ “getportstatus Command” on page 13 ■...
142 ports checked, 0 ports with bad state found Note – The output in the example is just a portion of the full output. Related Information ibcheckstate man page ■ “ibchecknode Command” on page 31 ■ Sun Datacenter InfiniBand Switch 72 Command Reference • May 2010...
■ ibclearcounters Command Clears port counters in the InfiniBand fabric. Syntax ibclearcounters [-h][topology|-C ca_name][-P ca_port][-t timeout] where: topology is the topology file. ■ ca_name is the channel adapter name. ■ Sun Datacenter InfiniBand Switch 72 Command Reference • May 2010...
ca_port is the channel adapter port. ■ timeout is the timeout in milliseconds. ■ Description This InfiniBand command is a script that clears the Performance Manager agent port counters by either discovering the InfiniBand fabric topology or using an existing topology file.
The following table describes the options to the ibclearerrors command and their purposes: Option Purpose Provides help. Uses mono mode instead of color mode. Uses the specified channel adapter name. Uses the specified channel adapter port. Overrides the default timeout. Sun Datacenter InfiniBand Switch 72 Command Reference • May 2010...
Example The following example shows how to clear all error counters with the ibclearerrors command. # ibclearerrors ## Summary: 6 nodes cleared 0 errors Related Information ibclearerrors man page ■ “ibnetdiscover Command” on page 56 ■ “perfquery Command” on page 85 ■...
Note – You might see more output than what is in the example. Related Information ibdatacounters man page ■ “ibdatacounts Command” on page 45 ■ “ibnetdiscover Command” on page 56 ■ Sun Datacenter InfiniBand Switch 72 Command Reference • May 2010...
ibdatacounts Command Displays InfiniBand fabric port data counters. Syntax ibdatacounts [-b][-G][-h][-N][-v][-C ca_name][-P ca_port][-t timeout] lid|guid port where: ca_name is the channel adapter name. ■ ca_port is the channel adapter port. ■ timeout is the timeout in milliseconds. ■ lid is the local identifier. ■...
[-c count][-v][-r][-o outputdir][-t topology][-s system][-i device][-p port][-wt topology][-pm][-pc][-P PM = value][-lw 1x|4x|12x][-ls 2.5|5|10][-skip checks][-load_db file][-h][-V] where: count is the number of packets. ■ outputdir is the output directory. ■ Sun Datacenter InfiniBand Switch 72 Command Reference • May 2010...
topology is the topology file. ■ system is the local system name. ■ device is the index of the device connecting to the InfiniBand fabric. ■ port is the port of the device. ■ PM is the Performance Manager counter number. ■...
Options The following table describes the options to the ibdiagnet command and their purposes: Option Purpose Sets the minimum number of packets sent across each link. Provides verbose output. Sun Datacenter InfiniBand Switch 72 Command Reference • May 2010...
Option Purpose Provides a report of fabric qualities. Specifies the topology file name. Specifies the local system name. In the case of multiple devices on the local system, this option specifies the index of the device of the port used to connect to the InfiniBand fabric. Specifies the local device port number used to connect to the InfiniBand fabric.
Page 66
Performance Counters Report Specific Link Width Check Specific Link Speed Check Partitions Check IPoIB Subnets Check Please see /tmp/ibdiagnet.log for complete log ---------------------------------------------------------------- -I- Done. Run time was 68 seconds. Sun Datacenter InfiniBand Switch 72 Command Reference • May 2010...
In the case of multiple devices on the local system, this option specifies the index of the device of the port used to connect to the InfiniBand fabric. Specifies the local device port number used to connect to the InfiniBand fabric. Sun Datacenter InfiniBand Switch 72 Command Reference • May 2010...
Option Purpose Specifies the output directory. Specifies the expected link width. Specifies the expected link speed. Dumps all the fabric link Performance Manager counters into ibdiagpath.pm. Resets all the fabric link Performance Manager counters. Use the Performance Manager counter of PM set to the threshold of value. Provides help.
Please see /tmp/ibdiagpath.log for complete log ---------------------------------------------------------------- -I- Done. Run time was 0 seconds. Related Information ibdiagpath man page ■ “ibdiagnet Command” on page 46 ■ ibhosts Command Displays host nodes. Sun Datacenter InfiniBand Switch 72 Command Reference • May 2010...
Syntax ibhosts [-h][topology|-C ca_name][-P ca_port][-t timeout] where: topology is the topology file. ■ ca_name is the channel adapter name. ■ ca_port is the channel adapter port. ■ timeout is the timeout in milliseconds. ■ Description This InfiniBand command is a script that discovers the InfiniBand fabric topology or uses the existing topology file to extract the channel adapter nodes.
Nodes, node types, node descriptions, links, port numbers, port LIDs, and GUIDs are displayed. The output is directed to a topology file, if the file name is specified. Sun Datacenter InfiniBand Switch 72 Command Reference • May 2010...
The output of the topology file follows this basic format for each node: vendid=vendor_ID_in_hex devid=device _ID_in_hex sysimgguid=GUID_in_hex and/or switchguid=GUID_in_hex(portGUID_in_hex) Switch ports_total "type-nodeGUID_in_hex" # "NodeDescription" base port 0 lid LID lmc 0 caguid=GUID_in_hex Ca ports_total "type-nodeGUID_in_hex" # "NodeDescription" [port] "type-nodeGUID_in_hex"[port](portGUID_in_hex) # "NodeDescription" lid LID widthspeed [port] "type-nodeGUID_in_hex"[port](portGUID_in_hex) # "NodeDescription"...
: 0x0021283a8620b0c0 ports 36 "Sun DCS 72 QDR switch 1.2(LC)" base port 0 lid 22 lmc 0 Note – The output in the example is just a portion of the full output. Sun Datacenter InfiniBand Switch 72 Command Reference • May 2010...
Related Information ibnodes man page ■ “ibnetdiscover Command” on page 56 ■ ibportstate Command Manages the state and link speed of an InfiniBand port. Syntax ibportstate [-d][-D][-e][-G][-h][-s smlid][-v][-C ca_name][-P ca_port][-t timeout] lid|dr_path|guid port [op] where: smlid is the Subnet Manager LID. ■...
8 with the ibportstate command. # ibportstate 24 8 PortInfo: # Port info: Lid 24 port 8 LinkState:.......Active PhysLinkState:....LinkUp LinkWidthSupported:....1X or 4X LinkWidthEnabled:....1X or 4X LinkWidthActive:....4X LinkSpeedSupported:....2.5 Gbps or 5.0 Gbps or 10.0 Gbps Sun Datacenter InfiniBand Switch 72 Command Reference • May 2010...
LinkSpeedEnabled:....2.5 Gbps or 5.0 Gbps or 10.0 Gbps LinkSpeedActive:....10.0 Gbps Peer PortInfo: # Port info: Lid 24 DR path slid 25; dlid 65535; 0,8 port 2 LinkState:.......Active PhysLinkState:....LinkUp LinkWidthSupported:....1X or 4X LinkWidthEnabled:....1X or 4X LinkWidthActive:....4X LinkSpeedSupported:....2.5 Gbps or 5.0 Gbps or 10.0 Gbps LinkSpeedEnabled:....2.5 Gbps or 5.0 Gbps or 10.0 Gbps LinkSpeedActive:....10.0 Gbps Related Information...
Uses smlid as the target LID for Subnet Manager or Subnet Administrator queries. Provides verbose output. Displays the version information. Uses the specified channel adapter name. Uses the specified channel adapter port. Overrides the default timeout. Sun Datacenter InfiniBand Switch 72 Command Reference • May 2010...
Example The following example shows how to display the forwarding table for LID 24 with the ibroute command. # ibroute 24 Unicast lids [0x0-0x19] of switch Lid 24 guid 0x0021283a8620b0e0 (Sun DCS 72 QDR switch 1.1(FC)): Destination Port Info 0x0014 001 : (Switch portguid 0x0021283a8620b0a0: ’Sun DCS 72 QDR switch 1.2(LC)’) 0x0015 011 : (Switch portguid 0x0021283a8620b0b0: ’Sun DCS 72 QDR switch 1.2(LC)’)
Infiniband device ’is4_0’ port 0 status: default gid: fe80:0000:0000:0000:0021:283a:8620:b0f0 base lid: 0x19 sm lid: 0x19 state: 4: ACTIVE phys state: 5: LinkUp rate: 40 Gb/sec (4X QDR) Related Information ibstatus man page ■ Sun Datacenter InfiniBand Switch 72 Command Reference • May 2010...
ibswitches Command Displays InfiniBand switch node in the topology. Syntax ibswitches [-h][topology|-C ca_name][-P ca_port][-t timeout] where: topology is the topology file. ■ ca_name is the channel adapter name. ■ ca_port is the channel adapter port. ■ timeout is the timeout in milliseconds. ■...
where: smlid is the Subnet Manager LID. ■ topology is the topology file. ■ ca_name is the channel adapter name. ■ ca_port is the channel adapter port. ■ timeout is the timeout in milliseconds. ■ oui is the OUI number. ■...
2: model AMD Opteron(tm) Processor 848 MHZ 2189.680 cpu 3: model AMD Opteron(tm) Processor 848 MHZ 2189.680 Related Information ibsysstat man page ■ ibtracert Command Traces the InfiniBand path. Sun Datacenter InfiniBand Switch 72 Command Reference • May 2010...
Syntax ibtracert [-d][-D][-G][-h][-m mlid][-s smlid][-v][-V][-C ca_name][-P ca_port][-t timeout][lid|dr_path|guid [startlid [endlid]]] where: mlid is the multicast LID. ■ smlid is the Subnet Manager LID. ■ ca_name is the channel adapter name. ■ ca_port is the channel adapter port. ■ timeout is the timeout in milliseconds. ■...
number][-console[off|local|socket|loopback]][-console-port port] [-i filename][-f path][-L size][-e][-P filename][-N][-Q[-Y filename]] [-y][-B][-I][-v][-V][-D flags][-dopt][-h] where: filename is the path and file for the respective option. ■ guid is the global unit identifier. ■ lmc is the LMC. ■ priority is the priority of the instance, 0 (low)–13 (high). ■...
Reassigns LIDs to all end nodes. By default, OpenSM attempts to preserve existing LID assignments while resolving multiple use of the same LID. Note - Use of the -r option might disrupt fabric traffic. Sun Datacenter InfiniBand Switch 72 Command Reference • May 2010...
Page 91
Option Purpose Selects the routing algorithm to use. Multiple algorithms can be specified in the order of use upon failure. The list is comma delimited. Algorithms supported are: • minhop – Min Hop. This default algorithm routes through the minimum number of hops with an optimized path.
Page 92
0 through 15. Prevents OpenSM from exiting upon fatal initialization issues. For example, duplicate GUIDS or 12x links with poorly configured lane reversal. Sun Datacenter InfiniBand Switch 72 Command Reference • May 2010...
Option Purpose Runs OpenSM in the background as a daemon. Starts OpenSM in an inactive state. Increases the log verbosity. Sets log verbosity to maximum. The same as -D 0xFF. Sets the log verbosity according to the following bit flags: •...
LMC lmc_esp0 FALSE value is used for enhanced switch port 0. If TRUE, LMC value for subnet is used for ESP0. Otherwise, LMC value for ESP0s is 0. Sun Datacenter InfiniBand Switch 72 Command Reference • May 2010...
Page 95
Parameter Description Default Value Maximum time a packet can live in a packet_life_time 0x12 switch. Actual time is 4.096 usec * 2^packet_life_time. A value of 0x14 disables the mechanism. Number of sequential packets dropped vl_stall_count 0x07 that cause the port to enter the VLStalled state.
Page 96
Use a single thread for handling Subnet single_thread FALSE Administrator queries. Daemon mode. daemon FALSE Deactivate the Subnet Manager. sm_inactive FALSE Babbling Port Policy. babbling_port_policy FALSE Log flags used. log_flags 0x03 Sun Datacenter InfiniBand Switch 72 Command Reference • May 2010...
Parameter Description Default Value Force flush of the log file after each log force_log_flush FALSE message. Log file to be used. log_file /var/log/opensm.log Maximum size of the log file in MB. If log_max_size overrun, log is restarted. If TRUE, accumulates the log over accum_log_file TRUE multiple OpenSM sessions.
OpenSM, you can create the inventory file with the -f c option. At a later time, you can run osmtest -f v to identify where there have been changes. Sun Datacenter InfiniBand Switch 72 Command Reference • May 2010...
The osmtest command conducts the following tests: Multicast compliancy test ■ Event forwarding test ■ Service record registration test ■ RMPP stress test ■ Small Subnet Administrator queries test ■ Options The following table describes the options to the osmtest command and their purposes: Option Purpose...
Uses the port GUID address. Provides help. Loops through all ports. Resets the counters after reading. Resets counters only. Provides verbose output. Displays the version information. Uses the specified channel adapter name. Sun Datacenter InfiniBand Switch 72 Command Reference • May 2010...
Option Purpose Uses the specified channel adapter port. Overrides the default timeout. Example The following example shows how to display all port counters for LID 24, port 8 with the perfquery command. # perfquery 24 8 # Port counters: Lid 24 port 8 PortSelect:......8 CounterSelect:....0x1b01 SymbolErrors:....0...
Options The following table describes the options to the saquery command and their purposes: Option Purpose Provides help. Sets the debug level. Can be used several times to increase the debug level. Displays the PathRecord information. Displays the NodeRecord information. Displays the NodeDescriptions of channel adapters only.
Note – The output in the example is just a portion of the full output. Related Information saquery man page ■ sminfo Command Queries the InfiniBand SMInfo attribute. Sun Datacenter InfiniBand Switch 72 Command Reference • May 2010...
Syntax sminfo [-d][-e] -s state -p priority -a activity [-D][-G][-h][-V][-C ca_name][-P ca_port][-t timeout] smlid|smdr_path where: state is the state for the Subnet Manager. ■ priority is the priority. ■ activity is the activity count. ■ ca_name is the channel adapter name. ■...
25 sm guid 0x21283a8620b0f0, activity count 25950 priority 13 state 3 SMINFO_MASTER Related Information sminfo man page ■ “smpdump Command” on page 92 ■ smpdump Command Dumps the InfiniBand fabric management attributes. Sun Datacenter InfiniBand Switch 72 Command Reference • May 2010...
Syntax smpdump [-s][-D][-h][-V][-C ca_name][-P ca_port][-t timeout] lid|dr_path attr [mod] where: ca_name is the channel adapter name. ■ ca_port is the channel adapter port. ■ timeout is the timeout in milliseconds. ■ lid is the local identifier. ■ dr_path is the directed path. ■...
■ lid is the local identifier. ■ dr_path is the directed path. ■ guid is the global unit identifier. ■ params is the parameter of the operation. ■ Sun Datacenter InfiniBand Switch 72 Command Reference • May 2010...
Description This InfiniBand command permits a subset of the standard SMP queries, including the following: Node information ■ Node description ■ Switch information ■ Port information ■ Output is in human-readable format. Supported operations and parameters are as follows: nodeinfo addr ■...
Need help?
Do you have a question about the Datacenter InfiniBand Switch 72 and is the answer not in the manual?
Questions and answers