Sun Oracle Datacenter InfiniBand Switch 72 Installation manual

Sun Datacenter InfiniBand
Switch 72
Command Reference
Part No. 820-7752-12
May 2010, Revision A

Copyright © 2009, 2010 Oracle and/or its affiliates. All rights reserved.
This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are
protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy,
reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any
means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.
The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report
them to us in writing.
If this is software or related software documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S.
Government, the following notice is applicable:
U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government
customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and
agency-specific supplemental regulations. As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the
restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government
contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007). Oracle America, Inc., 500
Oracle Parkway, Redwood City, CA 94065.
This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for
use in any inherently dangerous applications, including applications which may create a risk of personal injury. If you use this software or
hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to
ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in
dangerous applications.
Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.
AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. Intel and Intel
Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or
registered trademarks of SPARC International, Inc. UNIX is a registered trademark licensed through X/Open Company, Ltd.
This software or hardware and documentation may provide access to or information on content, products, and services from third parties.
Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content,
products, and services. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access
to or use of third-party content, products, or services.
Copyright © 2009, 2010, Oracle et/ou ses affiliés. Tous droits réservés.
Ce logiciel et la documentation qui l’accompagne sont protégés par les lois sur la propriété intellectuelle. Ils sont concédés sous licence et
soumis à des restrictions d’utilisation et de divulgation. Sauf disposition de votre contrat de licence ou de la loi, vous ne pouvez pas copier,
reproduire, traduire, diffuser, modifier, breveter, transmettre, distribuer, exposer, exécuter, publier ou afficher le logiciel, même partiellement,
sous quelque forme et par quelque procédé que ce soit. Par ailleurs, il est interdit de procéder à toute ingénierie inverse du logiciel, de le
désassembler ou de le décompiler, excepté à des fins d’interopérabilité avec des logiciels tiers ou tel que prescrit par la loi.
Les informations fournies dans ce document sont susceptibles de modification sans préavis. Par ailleurs, Oracle Corporation ne garantit pas
qu’elles soient exemptes d’erreurs et vous invite, le cas échéant, à lui en faire part par écrit.
Si ce logiciel, ou la documentation qui l’accompagne, est concédé sous licence au Gouvernement des Etats-Unis, ou à toute entité qui délivre la
licence de ce logiciel ou l’utilise pour le compte du Gouvernement des Etats-Unis, la notice suivante s’applique :
U.S. GOVERNMENT RIGHTS. Programs, software, databases, and related documentation and technical data delivered to U.S. Government
customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and
agency-specific supplemental regulations. As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the
restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government
contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007). Oracle America, Inc., 500
Oracle Parkway, Redwood City, CA 94065.
Ce logiciel ou matériel a été développé pour un usage général dans le cadre d’applications de gestion des informations. Ce logiciel ou matériel
n’est pas conçu ni n’est destiné à être utilisé dans des applications à risque, notamment dans des applications pouvant causer des dommages
corporels. Si vous utilisez ce logiciel ou matériel dans le cadre d’applications dangereuses, il est de votre responsabilité de prendre toutes les
mesures de secours, de sauvegarde, de redondance et autres mesures nécessaires à son utilisation dans des conditions optimales de sécurité.
Oracle Corporation et ses affiliés déclinent toute responsabilité quant aux dommages causés par l’utilisation de ce logiciel ou matériel pour ce
type d’applications.
Oracle et Java sont des marques déposées d’Oracle Corporation et/ou de ses affiliés.Tout autre nom mentionné peut correspondre à des
marques appartenant à d’autres propriétaires qu’Oracle.
AMD, Opteron, le logo AMD et le logo AMD Opteron sont des marques ou des marques déposées d’Advanced Micro Devices. Intel et Intel
Xeon sont des marques ou des marques déposées d’Intel Corporation. Toutes les marques SPARC sont utilisées sous licence et sont des marques
ou des marques déposées de SPARC International, Inc. UNIX est une marque déposée concédée sous licence par X/Open Company, Ltd.
Ce logiciel ou matériel et la documentation qui l’accompagne peuvent fournir des informations ou des liens donnant accès à des contenus, des
produits et des services émanant de tiers. Oracle Corporation et ses affiliés déclinent toute responsabilité ou garantie expresse quant aux
contenus, produits ou services émanant de tiers. En aucun cas, Oracle Corporation et ses affiliés ne sauraient être tenus pour responsables des
pertes subies, des coûts occasionnés ou des dommages causés par l’accès à des contenus, produits ou services tiers, ou à leur utilisation.

v
Contents
Using This Documentation xv
Understanding the Commands 1
Understanding Hardware Commands 1
checkboot Command 2
Syntax 2
Description 2
Example 3
checkpower Command 3
Syntax 3
Description 3
Example 3
checkvoltages Command 4
Syntax 4
Description 4
Example 4
connector Command 5
Syntax 5
Description 5
Options 6
Example 7
disablesm Command 7

vi Sun Datacenter InfiniBand Switch 72 Command Reference • May 2010
Syntax 7
Description 7
Example 8
disableswitchport Command 8
Syntax 8
Description 8
Example 8
enablesm Command 9
Syntax 9
Description 9
Example 9
enableswitchport Command 10
Syntax 10
Description 10
Example 10
env_test Command 11
Syntax 11
Description 11
Example 11
getfanspeed Command 12
Syntax 13
Description 13
Example 13
getportstatus Command 13
Syntax 13
Description 14
Example 14
i4reset Command 14

Contents vii
Syntax 14
Description 14
Example 15
listlinkup Command 15
Syntax 15
Description 15
Example 15
managementreset Command 16
Syntax 16
Description 16
Example 17
nm2version Command 17
Syntax 17
Description 17
Example 18
readchfru Command 18
Syntax 18
Description 19
Example 19
setlinkspeed Command 19
Syntax 19
Description 20
Example 20
setsmpriority Command 20
Syntax 20
Description 21
Example 21
showtemps Command 22

viii Sun Datacenter InfiniBand Switch 72 Command Reference • May 2010
Syntax 22
Description 22
Example 22
showunhealthy Command 23
Syntax 23
Description 23
Example 23
Understanding InfiniBand Commands 23
ibaddr Command 26
Syntax 26
Description 26
Options 26
Example 27
ibcheckerrors Command 27
Syntax 27
Description 28
Options 28
Example 28
ibchecknet Command 29
Syntax 29
Description 29
Options 30
Example 30
ibchecknode Command 31
Syntax 31
Description 31
Options 32
Example 32

Contents ix
ibcheckport Command 32
Syntax 32
Description 33
Options 33
Example 34
ibcheckportstate Command 34
Syntax 34
Description 34
Options 35
Example 35
ibcheckportwidth Command 35
Syntax 36
Description 36
Options 36
Example 37
ibcheckstate Command 37
Syntax 37
Description 37
Options 38
Example 38
ibcheckwidth Command 39
Syntax 39
Description 39
Options 39
Example 40
ibclearcounters Command 40
Syntax 40
Description 41

xSun Datacenter InfiniBand Switch 72 Command Reference • May 2010
Options 41
Example 41
ibclearerrors Command 42
Syntax 42
Description 42
Options 42
Example 43
ibdatacounters Command 43
Syntax 43
Description 43
Options 44
Example 44
ibdatacounts Command 45
Syntax 45
Description 45
Options 45
Example 46
ibdiagnet Command 46
Syntax 46
Description 47
Options 48
Example 49
ibdiagpath Command 51
Syntax 51
Description 51
Options 52
Example 53
ibhosts Command 54

Contents xi
Syntax 55
Description 55
Options 55
Example 55
ibnetdiscover Command 56
Syntax 56
Description 56
Options 57
Example 58
ibnodes Command 59
Syntax 59
Description 60
Options 60
Example 60
ibportstate Command 61
Syntax 61
Description 61
Options 62
Example 62
ibroute Command 63
Syntax 63
Description 64
Options 64
Example 65
ibstatus Command 65
Syntax 65
Description 66
Options 66

xii Sun Datacenter InfiniBand Switch 72 Command Reference • May 2010
Example 66
ibswitches Command 67
Syntax 67
Description 67
Options 67
Example 68
ibsysstat Command 68
Syntax 68
Description 69
Options 69
Example 70
ibtracert Command 70
Syntax 71
Description 71
Options 71
Example 72
opensm Command 72
Syntax 72
Description 73
Options 74
Example 77
opensmd Daemon 78
Syntax 78
Description 78
Options 81
Example 82
osmtest Command 82
Syntax 82

Contents xiii
Description 82
Options 83
Example 84
perfquery Command 85
Syntax 85
Description 86
Options 86
Example 87
saquery Command 87
Syntax 88
Description 88
Options 89
Example 90
sminfo Command 90
Syntax 91
Description 91
Options 91
Example 92
smpdump Command 92
Syntax 93
Description 93
Options 93
Example 94
smpquery Command 94
Syntax 94
Description 95
Options 95
Example 96

xiv Sun Datacenter InfiniBand Switch 72 Command Reference • May 2010
Index 97

xv
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.
■“Related Documentation” on page xv
■“Documentation, Support, and Training” on page xvi
■“Documentation Feedback” on page xvi
Related Documentation
The documents listed as online are available at:
(http://docs.sun.com/app/docs/prod/ib.switch.72)
Some commands reference the PICMG 3.0 specification, available at:
Application Title Part Number Format Location
Getting started Sun Datacenter InfiniBand Switch 72 Getting Started
Guide
820-7755 Printed
PDF
Shipping
kit
Online
Last-minute
information
Sun Datacenter InfiniBand Switch 72 Product Notes 820-7753 PDF Online
Installation,
administration,
and service
Sun Datacenter InfiniBand Switch 72 User’s Guide 820-7751 PDF
HTML
Online
Command
reference
Sun Datacenter InfiniBand Switch 72 Command
Reference
820-7752 PDF
HTML
Online
Compliance Sun Datacenter InfiniBand Switch 72 Safety and
Compliance Guide
820-7754 PDF Online

xvi Sun Datacenter InfiniBand Switch 72 Command Reference • May 2010
(http://www.picmg.org)
Some commands reference the IPMI specification, available at:
(http://www.intel.com/design/servers/ipmi)
Documentation, Support, and Training
These web sites provide additional resources:
■Documentation (http://docs.sun.com)
■Support (http://www.sun.com/support)
■Training (http://www.sun.com/training)
Documentation Feedback
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.

1
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 Hardware Commands
The hardware commands are a simplified way to direct the Komtron management
controller, internal to the switch, to perform complex tasks. Only the root user of the
management controller can run all of the hardware commands. The format of the
hardware commands is as follows:
#command [arguments][arguments]...
Command Syntax Links
checkboot “checkboot Command” on page 2
checkpower “checkpower Command” on page 3
checkvoltages “checkvoltages Command” on page 4
connector number [present|read reg|write reg data]“connector Command” on page 5
disablesm “disablesm Command” on page 7
disableswitchport switch_chip port “disableswitchport Command” on page 8
enablesm “enablesm Command” on page 9
enableswitchport switch_chip port “enableswitchport Command” on page 10

2Sun Datacenter InfiniBand Switch 72 Command Reference • May 2010
Related Information
■“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.
env_test “env_test Command” on page 11
getfanspeed “getfanspeed Command” on page 12
getportstatus switch_chip port [-v] “getportstatus Command” on page 13
i4reset switch_chip “i4reset Command” on page 14
listlinkup “listlinkup Command” on page 15
managementreset “managementreset Command” on page 16
nm2version “nm2version Command” on page 17
readchfru “readchfru Command” on page 18
setlinkspeed switch_chip port speed “setlinkspeed Command” on page 19
setsmpriority priority “setsmpriority Command” on page 20
showtemps “showtemps Command” on page 22
showunhealthy “showunhealthy Command” on page 23
Command Syntax Links

Understanding the Commands 3
Example
The following example shows how to check the boot status of the switch chips with
the checkboot command.
Related Information
■“i4reset Command” on page 14
■“env_test Command” on page 11
checkpower Command
Displays power supply status.
Syntax
checkpower
Description
This hardware command checks the status of the power supplies. Output is a
simplified OK.
Example
The following example shows how to check the power supply status with the
checkpower command.
#checkboot
I4-A OK
I4-B OK
I4-C OK
I4-D OK
I4-E OK
I4-F OK
#
#checkpower

4Sun Datacenter InfiniBand Switch 72 Command Reference • May 2010
Related Information
■“checkvoltages Command” on page 4
■“env_test Command” on page 11
checkvoltages Command
Verifies voltages.
Syntax
checkvoltages
Description
This hardware command displays the internal voltages for the main board. The left
column displays the expected voltage, and the right column displays the measured
voltage. The command also provides a summary of the voltage conditions.
Example
The following example shows how to check that voltages are at nominal values with
the checkvoltages command.
PSU 0 present status: OK
PSU 1 present status: OK
#
#checkvoltages
Voltage ECB OK
Measured 3.3V Main = 3.28 V
Measured 3.3V Standby = 3.37 V
Measured 12V = 12.00 V
Measured 5V = 5.10 V
Measured VBAT = 3.08 V
Measured 1.8V = 1.77 V
Measured 1.2V Standby = 1.21 V
Measured 1.8V Standby = 1.80 V
Measured 2.5VA = 2.51 V
Measured 2.5VB = 2.51 V