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

Document Information

Preface

Related Documentation

Documentation, Support, and Training

Third-Party Web Sites

Sun Welcomes Your Comments

Administration

Administering the Switch

Understanding Administrative Commands

Monitoring the Switch

Monitoring the InfiniBand Fabric

Controlling the Switch

Controlling the InfiniBand Fabric

Diagnosing a Problem

Identifying the Problem

Troubleshooting the Switch

Understanding Signal Routing Through the Switch

Understanding Switch Startup and Component Addition

Switch GUIDs Overview

Remote Management

Understanding ILOM on the Switch

ILOM Documentation

ILOM Overview

Supported Features

Understanding ILOM Targets

Installing the ILOM Firmware

Firmware Layout

rupgrade_tool Application

Download the ILOM Firmware

Install the ILOM Firmware

Administering ILOM (CLI)

CLI Overview

Access ILOM From the CLI

Switching Between the ILOM Shell and the Linux Shell

Monitoring ILOM Targets (CLI)

Controlling ILOM Targets (CLI)

Upgrading the Switch Firmware Through ILOM (CLI)

Administering ILOM (Web Interface)

Web Interface Overview

Access ILOM From the Web Interface

Monitoring ILOM Targets (Web Interface)

Controlling ILOM Targets (Web Interface)

Upgrading the Switch Firmware Through ILOM (Web Interface)

Understanding ILOM Commands

cd Command

create Command

delete Command

dump Command

exit Command

help Command

load Command

set Command

show Command

version Command

Installation

Preparing the Site

Routing Service Cables

Understanding InfiniBand Cabling

Understanding Switch Specifications

Installing the Switch

Understanding the Installation

Installing the InfiniBand Software Stack

Unpacking the Chassis

Preparing the Chassis

Inspecting the Components

Installing the Components

Powering On the CMCs

Powering On the Fabric Cards

Powering On the Line Cards

Connecting InfiniBand Cables

Verifying the InfiniBand Fabric

Service

Servicing the Switch

Understanding Service Procedures

Servicing the Power Supplies

Servicing the CMCs

Servicing the Fans

Servicing the Fabric Cards and Fabric Card Fillers

Servicing the InfiniBand Cables

Servicing the Line Cards

Doing Supportive Software Tasks

Reference

Command Reference

Understanding Switch-Specific Commands

activate Command

checkfans Command

checklinks Command

checkpowers Command

checkpwrfault Command

checkswitches Command

checkvoltages Command

clearboardstat Command

deactivate Command

disableboard Command

disablepsu Command

disablestby Command

disableswitchport Command

enableboard Command

enablehotinsert Command

enablepsu Command

enablestby Command

enableswitchport Command

env_test Command

findport Command

getbaseguid Command

getboardstat Command

getfwversion Command

getportcounters Command

getportstatus Command

getpsufwver Command

getserialnumbers Command

getsymerr Command

i2ctest Command

m9diag Command

mcmversion Command

psustatus Command

resetswitch Command

selectdebugport Command

setlinkspeed Command

showlogs Command

showpresent Command

showtemps Command

showvoltages Command

Understanding CLIA Commands

activate Command

deactivate Command

exit Command

fru Command

frucontrol Command

fruinfo Command

getfruledstate Command

getipmbstate Command

getlanconfig Command

LAN Configuration Parameters

help Command

ipmc Command

localaddress Command

poll Command

quit Command

sel Command

sensordata Command

session Command

setextracted Command

setfruledstate Command

setipmbstate Command

setlanconfig Command

setlocked Command

shelf Command

shelfaddress Command

shmstatus Command

showunhealthy Command

switchover Command

terminate Command

user [-v] Command

user add Command

user channel Command

user delete Command

user enable Command

user name Command

user passwd Command

version Command

Understanding InfiniBand Software Commands

ib_read_bw Command

ib_read_lat Command

ib_send_bw Command

ib_send_lat Command

ib_write_bw Command

ib_write_lat Command

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

ibnodes Command

ibping Command

ibportstate Command

ibroute Command

ibrouters Command

ibstat Command

ibstatus Command

ibswitches Command

ibsysstat Command

ibtracert Command

ibv_devices Command

ibv_devinfo Command

ibv_rc_pingpong Command

ibv_srq_pingpong Command

ibv_uc_pingpong Command

ibv_ud_pingpong Command

ofed_info Command

opensm Command

opensmd Daemon

osmtest Command

perfquery Command

saquery Command

sminfo Command

smpdump Command

smpquery Command

vendstat Command

Index

saquery Command

Queries InfiniBand fabric administration attributes. Issued on the Linux InfiniBand host.

Syntax

saquery [-h][-d][-p][-N][-D][-S][-I][-L][-l][-G][-O][-U][-c][-s] [-g][-m][-x][-C ca_name][-P ca_port][-t timeout][--src-to-dst source:destination][--sgid-to-dgid source-destination][name|lid|guid]

where:

Description

This InfiniBand software command performs the selected Subnet Administrator query. Node records are queried by default.

Options

The following table describes the options to the saquery command and their purposes:

Option
Purpose
-h
Provides help.
-d
Sets the debug level. Can be used several times to increase the debug level.
-p
Displays the PathRecord information.
-N
Displays the NodeRecord information.
-D
Displays the NodeDescriptions of channel adapters only.
-S
Displays ServiceRecord information.
-I
Displays InformInfoRecord information.
-L
Returns the LIDs of the specified name.
-l
Returns the unique LID of the specified name.
-G
Returns the GUIDs of the specified name.
-O
Returns the name of the specified LID.
-U
Returns the name of the specified GUID.
-G
Uses the port GUID address.
-c
Displays the Subnet Administrator class port information.
-s
Returns the PortInforRecords with the isSM or isSMdisabled capability mask bit enabled.
-g
Displays multicast group information.
-m
Displays multicast member information. If a group is specified, provides only the GUID and node description for each entry.
-x
Displays LinkRecord information.
--src-to-dst
Displays a PathRecord for source:destination, where source and destination are either node names or LIDs.
--sgid-to-dgid
Displays a PathRecord for source-destination, where source and destination are GIDs in an IPv6 format acceptable to inet_pton.
-C
Uses the specified channel adapter name.
-P
Uses the specified channel adapter port.
-t
Overrides the default timeout.
Example

The following example shows how to produce a node record dump of every LID in the InfiniBand fabric with the saquery command.

# saquery
NodeRecord dump:
        lid.....................0x3A
        reserved................0x0
        base_version............0x1
        class_version...........0x1
        node_type...............Channel Adapter
        num_ports...............0x2
        sys_guid................0x0003ba000100c70b
        node_guid...............0x0003ba000100c708
        port_guid...............0x0003ba000100c70a
        partition_cap...........0x80
        device_id...............0x673C
        revision................0xA0
        port_num................0x2
        vendor_id...............0x2C9
        NodeDescription.........nsn34-39 HCA-1
NodeRecord dump:
        lid.....................0x2
        reserved................0x0
.
.
.
#

Note - The output in the example is just a portion of the full output.


Related Information