|
Packit |
13e616 |
OpenSM Release Notes
|
|
Packit |
13e616 |
======================
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
Version: OpenFabric Enterprise Distribution (OFED) 1.0
|
|
Packit |
13e616 |
Repo: https://openib.org/svn/gen2/branches/1.0/src/userspace/management/osm
|
|
Packit |
13e616 |
Version: 7992
|
|
Packit |
13e616 |
Date: Jun 2006
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
1 Overview
|
|
Packit |
13e616 |
----------
|
|
Packit |
13e616 |
This document describes the contents of the OpenSM OFED 1.0 release.
|
|
Packit |
13e616 |
OpenSM is an InfiniBand compliant Subnet Manager and Administrator,
|
|
Packit |
13e616 |
and runs on top of OpenIB. The OpenSM version for this release
|
|
Packit |
13e616 |
is openib-1.2.1
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
This document includes the following sections:
|
|
Packit |
13e616 |
1 This Overview section (describing new features and software
|
|
Packit |
13e616 |
dependencies)
|
|
Packit |
13e616 |
2 Known Issues And Limitations
|
|
Packit |
13e616 |
3 Unsupported IB compliance statements
|
|
Packit |
13e616 |
4 Major Bug Fixes
|
|
Packit |
13e616 |
5 Main Verification Flows
|
|
Packit |
13e616 |
6 Qualified software stacks and devices
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
1.1 New Features
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* SA GuidInfoRecord support
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* Default for maxsmps changed:
|
|
Packit |
13e616 |
Control the number of SMP sent in parallel and thus shorten the
|
|
Packit |
13e616 |
fabric initialization time.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* osmtest/osmt_slvl_vl_arb.c:
|
|
Packit |
13e616 |
Output file name changed from vl_arbs.txt to qos.txt
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* Support new IBTA Errata IsPortInfoCapMaskMatchSupported:
|
|
Packit |
13e616 |
This new capability of the SA enables matching of individual port
|
|
Packit |
13e616 |
capability bits dramatically reducing the query size for agents like
|
|
Packit |
13e616 |
the SRP initiator query for finding SRP targets.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* Honor guid2lid when coming out of standby:
|
|
Packit |
13e616 |
This change adds an option to the opensm that forces it to honor the
|
|
Packit |
13e616 |
guid2lid file given when it comes out of Standby state. Currently,
|
|
Packit |
13e616 |
when opensm comes out of Standby state, it ignores the guid2lid file
|
|
Packit |
13e616 |
it read, and honors only the lids defined on the ports themselves.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* Add guid to opensm opts
|
|
Packit |
13e616 |
This enables the port on which to run the SM to be defined through
|
|
Packit |
13e616 |
the configuration file as well as through the command line.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* PPC support:
|
|
Packit |
13e616 |
No PPC QA was performed.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
1.2 Software Dependencies
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
OpenSM depends on the installation of either OFED 1.0,
|
|
Packit |
13e616 |
OpenIB gen2 (e.g. IBG2 distribution), OpenIB gen1 (e.g. IBGD
|
|
Packit |
13e616 |
distribution) or Mellanox VAPI stacks. The qualified driver versions
|
|
Packit |
13e616 |
are provided in Table 2, "Qualified IB Stacks".
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
1.4 Supported Devices Firmware
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
The main task of OpenSM is to initialize InfiniBand devices. The
|
|
Packit |
13e616 |
qualified devices and their corresponding firmware versions
|
|
Packit |
13e616 |
are listed in Table 3.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
2 Known Issues And Limitations
|
|
Packit |
13e616 |
------------------------------
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* No Partition/Pkey policy support:
|
|
Packit |
13e616 |
OpenSM does not provide means to set partitions.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* No Service / Key associations:
|
|
Packit |
13e616 |
There is no way to manage Service access by Keys.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* No SM to SM SMDB synchronization:
|
|
Packit |
13e616 |
Puts the burden of re-registering services, multicast groups, and
|
|
Packit |
13e616 |
inform-info on the client application (or IB access layer core).
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* No "port down" event handling:
|
|
Packit |
13e616 |
Changing the switch port through which OpenSM connects to the IB
|
|
Packit |
13e616 |
fabric may cause incorrect operation. Please restart OpenSM whenever
|
|
Packit |
13e616 |
such a connectivity change is made.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* Changing connections during SM operation:
|
|
Packit |
13e616 |
Under some conditions the SM can get confused by a change in
|
|
Packit |
13e616 |
cabling (moving a cable from one switch port to the other) and
|
|
Packit |
13e616 |
momentarily see this as having the same GUID appear connected
|
|
Packit |
13e616 |
to two different IB ports. Under some conditions, when the SM fails to
|
|
Packit |
13e616 |
get the corresponding change event it might mistakenly report this case
|
|
Packit |
13e616 |
as a "duplicated GUID" case and abort. It is advisable to double-check
|
|
Packit |
13e616 |
the syslog after each such change in connectivity and restart
|
|
Packit |
13e616 |
OpenSM if it has exited.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* No QoS support:
|
|
Packit |
13e616 |
No SL2VL and VLArbitration setting is performed by the SM.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
3 Unsupported IB Compliance Statements
|
|
Packit |
13e616 |
--------------------------------------
|
|
Packit |
13e616 |
The following section lists all the IB compliance statements which
|
|
Packit |
13e616 |
OpenSM does not support. Please refer to the IB specification for detailed
|
|
Packit |
13e616 |
information regarding each compliance statement.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* C14-22 (Authentication):
|
|
Packit |
13e616 |
M_Key M_KeyProtectBits and M_KeyLeasePeriod shall be set in one
|
|
Packit |
13e616 |
SubnSet method. As a work-around, an OpenSM option is provided for
|
|
Packit |
13e616 |
defining the protect bits.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* C14-67 (Authentication):
|
|
Packit |
13e616 |
On SubnGet(SMInfo) and SubnSet(SMInfo) - if M_Key is not zero then
|
|
Packit |
13e616 |
the SM shall generate a SubnGetResp if the M_Key matches, or
|
|
Packit |
13e616 |
silently drop the packet if M_Key does not match.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* C15-0.1.23.4 (Authentication):
|
|
Packit |
13e616 |
InformInfoRecords shall always be provided with the QPN set to 0,
|
|
Packit |
13e616 |
except for the case of a trusted request, in which case the actual
|
|
Packit |
13e616 |
subscriber QPN shall be returned.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* o13-17.1.2 (Event-FWD):
|
|
Packit |
13e616 |
If no permission to forward, the subscription should be removed and
|
|
Packit |
13e616 |
no further forwarding should occur.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* C14-37.1.2 (Handover):
|
|
Packit |
13e616 |
Priority should be kept in non-volatile memory.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* C14-24.1.1.5 and C14-62.1.1.22 (Initialization):
|
|
Packit |
13e616 |
GUIDInfo - SM should enable assigning Port GUIDInfo.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* C14-44 (Initialization):
|
|
Packit |
13e616 |
If the SM discovers that it is missing an M_Key to update CA/RT/SW,
|
|
Packit |
13e616 |
it should notify the higher level.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* C14-62.1.1.11 (Initialization):
|
|
Packit |
13e616 |
PortInfo:VLHighLimit should match the configured VLArb on the port.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* C14-62.1.1.12 (Initialization):
|
|
Packit |
13e616 |
PortInfo:M_Key - Set the M_Key to a node based random value.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* C14-62.1.1.13 (Initialization):
|
|
Packit |
13e616 |
PortInfo:P_KeyProtectBits - set according to an optional policy.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* C14-62.1.1.24 (Initialization):
|
|
Packit |
13e616 |
SwitchInfo:DefaultPort - should be configured for random FDB.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* C14-62.1.1.32 (Initialization):
|
|
Packit |
13e616 |
RandomForwardingTable should be configured.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* o15-0.1.12 (Multicast):
|
|
Packit |
13e616 |
If the JoinState is SendOnlyNonMember = 1 (only), then the endport
|
|
Packit |
13e616 |
should join as sender only.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* o15-0.1.13 (Multicast):
|
|
Packit |
13e616 |
If a Join request using unrealistic parameters is received, return
|
|
Packit |
13e616 |
ERR_REQ_INVALID.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* o15-0.1.8 (Multicast):
|
|
Packit |
13e616 |
If a request for creating an MCG with fields that cannot be met,
|
|
Packit |
13e616 |
return ERR_REQ_INVALID (currently ignoring SL and FlowLabelTclass).
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* C15-0.1.11 (SA-Query):
|
|
Packit |
13e616 |
Query response should use only base LIDs (as the feature has not
|
|
Packit |
13e616 |
been qualified yet).
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* C15-0.1.19 (SA-Query):
|
|
Packit |
13e616 |
Respond to SubnGetMulti(MultiPathRec)
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* C15-0.1.8.6 (SA-Query):
|
|
Packit |
13e616 |
Respond to SubnAdmGetTraceTable - this is an optional attribute.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* C15-0.1.8.7 (SA-Query):
|
|
Packit |
13e616 |
SubnAdmGetMulti SubnAdmGetMultiResp - Only in case of a MultiPath.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* C15-0.1.13 Services:
|
|
Packit |
13e616 |
Reject ServiceRecord create, modify or delete if the given
|
|
Packit |
13e616 |
ServiceP_Key does not match the one included in the ServiceGID port
|
|
Packit |
13e616 |
and the port that sent the request.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* C15-0.1.14 (Services):
|
|
Packit |
13e616 |
Provide means to associate service name and ServiceKeys.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
4 Major Bug Fixes
|
|
Packit |
13e616 |
-----------------
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
The following is a list of bugs that were fixed. Note that other less critical
|
|
Packit |
13e616 |
or visible bugs were also fixed.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* Eliminate error on active -> active port state transition
|
|
Packit |
13e616 |
SM may transition port from armed to active but in the meantime, due
|
|
Packit |
13e616 |
to passing a data packet with active enable set, the port may
|
|
Packit |
13e616 |
already have transitioned to active. Active -> active port state
|
|
Packit |
13e616 |
transition is indicated as an error but it isn't really an error so
|
|
Packit |
13e616 |
don't indicate error in the osm log.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* Routing not set for the first LID in the last LFT block:
|
|
Packit |
13e616 |
Fix: osm_switch.c: In osm_switch_get_fwd_tbl_block last block calculation
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* Corrupted guid2lid file causes OpenSM exit
|
|
Packit |
13e616 |
Fix: exit only if exit_on_fatal option is set (the default)
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* OpenSM was causing Client-Re-Registration continuously:
|
|
Packit |
13e616 |
The SM was storing the response PortInfo.ClientReRegstration
|
|
Packit |
13e616 |
bit and using it during next Set(PortInfo). Fix: clear the bit on
|
|
Packit |
13e616 |
receive.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* Multicast Query Selectors MTU, rate, and PacketLifeTime were not exact
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* Try not to recognize port change as duplicated GUID
|
|
Packit |
13e616 |
This fix solves the issue of a port move during heavy sweep
|
|
Packit |
13e616 |
being recognized as a duplicated guid. Fix: If the SM sees what
|
|
Packit |
13e616 |
seems to be a duplicated guid, but it also received an indication
|
|
Packit |
13e616 |
for immediately forcing another heavy sweep (for example, as a
|
|
Packit |
13e616 |
result of receiving trap 128) then it shouldn't issue a duplicated
|
|
Packit |
13e616 |
guid error (and possibly exit), but should just ignore this and
|
|
Packit |
13e616 |
continue. This means that only if the SM recognizes such a
|
|
Packit |
13e616 |
duplication in a stable subnet that it'll issue the error (and
|
|
Packit |
13e616 |
possibly exit).
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* Set PKey table on switch ports not supporting it:
|
|
Packit |
13e616 |
OpenSM attempts to set pkey table entries on external switch ports
|
|
Packit |
13e616 |
even if the switch declares a PartitionEnforcementCap of zero. The
|
|
Packit |
13e616 |
consequence is ERR 4108. Fix: Observe PartitionEnforcementCap of zero.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* Incorrect MCMemberRecord Get/GetTable in trusted mode:
|
|
Packit |
13e616 |
This change fixes the retrieval of the MCMember records according to
|
|
Packit |
13e616 |
Errata MGTWG3280. This fix provide means to obtain all the group
|
|
Packit |
13e616 |
members by issuing a trusted GetTable query.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* Trusted MCMemberRecord query was not recognized as trusted:
|
|
Packit |
13e616 |
Trust is checked by comparing the request SM_Key field to the SM
|
|
Packit |
13e616 |
SM_Key. The bug was in looking up the SM_Key from the response not
|
|
Packit |
13e616 |
the request.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* Port left in down state after setting MTU or OpVLs on its neighbor:
|
|
Packit |
13e616 |
In case of a difference between the MTU of two ports, only the port
|
|
Packit |
13e616 |
with the higher MTU was set to down. Its remote port was written in
|
|
Packit |
13e616 |
the DB as in the ACTIVE state although its real status was INIT.
|
|
Packit |
13e616 |
Because of this, the SM didn't try to move the remote port to
|
|
Packit |
13e616 |
ACTIVE.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* Atomic counters used throughout the code were broken:
|
|
Packit |
13e616 |
A new implementation has been provided.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* MC Group creation with "less than" MTU ignores the requester MTU:
|
|
Packit |
13e616 |
When requesting to create an MC group with MTU(rate) selector 1
|
|
Packit |
13e616 |
(meaning less than rate specified), the MC group is created with
|
|
Packit |
13e616 |
MTU(rate) requested - 1. This is without checking the MTU(rate) of
|
|
Packit |
13e616 |
the port requesting the creation of the multicast group. This means
|
|
Packit |
13e616 |
that if, for example, port with MTU=2 sends a request for MC group
|
|
Packit |
13e616 |
creation with MTU selector=1 and MTU=5, Opensm will try to create a
|
|
Packit |
13e616 |
MC group with MTU=4, and fail, since the port capabilities are not
|
|
Packit |
13e616 |
realizable. Fix: creation of the MC group with MTU(rate) also takes
|
|
Packit |
13e616 |
into account the MTU(rate) of the port requesting the creation.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* MC Group join does not validate that the joining port's capabilities
|
|
Packit |
13e616 |
match those of the MC. Fix: Add verification of endport physical
|
|
Packit |
13e616 |
capability to join MC group.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* ClientReRegistration not sent to ports discovered after first sweep:
|
|
Packit |
13e616 |
PortInfo sent with ClientReRegistration bit turned on only during
|
|
Packit |
13e616 |
the first sweep after becoming Master. This doesn't cover all cases
|
|
Packit |
13e616 |
where ClientReRegistration should be turned on. Fix: turn on this
|
|
Packit |
13e616 |
bit also on new ports it discovers (in cases of subnet merging, for
|
|
Packit |
13e616 |
example).
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* segfault during a report on deleted multicast group:
|
|
Packit |
13e616 |
osm_mcast_mgr.c, executing the line of code:
|
|
Packit |
13e616 |
osm_mgrp_send_delete_notice( p_mgr->p_subn, p_mgr->p_log, p_mgrp );
|
|
Packit |
13e616 |
caused segmentation fault since the handle p_mgrp was already
|
|
Packit |
13e616 |
deleted while the function was called. Fix: inserted the line above
|
|
Packit |
13e616 |
into the protected section.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* segfault in osm_get_gid_by_mad_addr:
|
|
Packit |
13e616 |
The affected flows are ports and multicast joins.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* segfault in LID manager:
|
|
Packit |
13e616 |
Handle NULL p_rem_physp can validly be NULL when the remote SMA is
|
|
Packit |
13e616 |
not responding (but physical link is up).
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* segfault in Up/Down routing engine
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
5 Main Verification Flows
|
|
Packit |
13e616 |
-------------------------
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
OpenSM verification is run using the following activities:
|
|
Packit |
13e616 |
* osmtest - a stand-alone program
|
|
Packit |
13e616 |
* ibmgtsim (IB management simulator) based - a set of flows that
|
|
Packit |
13e616 |
simulate clusters, inject errors and verify OpenSM capability to
|
|
Packit |
13e616 |
respond and bring up the network correctly.
|
|
Packit |
13e616 |
* small cluster regression testing - where the SM is used on back to
|
|
Packit |
13e616 |
back or single switch configurations. The regression includes
|
|
Packit |
13e616 |
multiple OpenSM dedicated tests.
|
|
Packit |
13e616 |
* cluster testing - when we run OpenSM to setup a large cluster, perform
|
|
Packit |
13e616 |
hand-off, reboots and reconnects, verify routing correctness and SA
|
|
Packit |
13e616 |
responsiveness at the ULP level (IPoIB and SDP).
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
5.1 osmtest
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
osmtest is an automated verification tool used for OpenSM
|
|
Packit |
13e616 |
testing. Its verification flows are described by list below.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* Inventory File: Obtain and verify all port info, node info, and path
|
|
Packit |
13e616 |
records parameters.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* Service Record:
|
|
Packit |
13e616 |
- Register new service
|
|
Packit |
13e616 |
- Register another service (with a lease period)
|
|
Packit |
13e616 |
- Register another service (with service p_key set to zero)
|
|
Packit |
13e616 |
- Get all services by name
|
|
Packit |
13e616 |
- Delete the first service
|
|
Packit |
13e616 |
- Delete the third service.
|
|
Packit |
13e616 |
- Added bad flows of get/delete non valid service
|
|
Packit |
13e616 |
- Add / Get same service with different data
|
|
Packit |
13e616 |
- Add / Get / Delete by different component mask values (services
|
|
Packit |
13e616 |
by Name & Key / Name & Data / Name & Id / Id only )
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* Multicast Member Record:
|
|
Packit |
13e616 |
- Query of existing Groups (IPoIB)
|
|
Packit |
13e616 |
- BAD Join with insufficient comp mask (o15.0.1.3)
|
|
Packit |
13e616 |
- Create given MGID=0 (o15.0.1.4)
|
|
Packit |
13e616 |
- Create given MGID=0xFF12A01C,FE800000,00000000,12345678 (o15.0.1.4)
|
|
Packit |
13e616 |
- Create BAD MGID=0xFA. (o15.0.1.6)
|
|
Packit |
13e616 |
- Create BAD MGID=0xFF12A01B w/ link-local not set (o15.0.1.6)
|
|
Packit |
13e616 |
- New MGID with invalid join state (o15.0.1.9)
|
|
Packit |
13e616 |
- Retry of existing MGID - See JoinState update (o15.0.1.11)
|
|
Packit |
13e616 |
- BAD RATE when connecting to existing MGID (o15.0.1.13)
|
|
Packit |
13e616 |
- Partial JoinState delete request - removing FullMember (o15.0.1.14)
|
|
Packit |
13e616 |
- Full Delete of a group (o15.0.1.14)
|
|
Packit |
13e616 |
- Verify Delete by trying to Join deleted group (o15.0.1.14)
|
|
Packit |
13e616 |
- BAD Delete of IPoIB membership (no prev join) (o15.0.1.15)
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* GUIDInfo Record:
|
|
Packit |
13e616 |
- All GUIDInfoRecords in subnet are obtained
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* Event Forwarding: Register for trap forwarding using reports
|
|
Packit |
13e616 |
- Send a trap and wait for report
|
|
Packit |
13e616 |
- Unregister non-existing
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* Trap 64/65 Flow: Register to Trap 64-65, create traps (by
|
|
Packit |
13e616 |
disconnecting/connecting ports) and wait for report, then unregister.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* Stress Test: send PortInfoRecord queries, both single and RMPP and
|
|
Packit |
13e616 |
check for the rate of responses as well as their validity.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
5.2 IB Management Simulator OpenSM Test Flows:
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
The simulator provides ability to simulate the SM handling of virtual
|
|
Packit |
13e616 |
topologies that are not limited to actual lab equipment availability.
|
|
Packit |
13e616 |
OpenSM was simulated to bring up clusters of up to 10,000 nodes. Daily
|
|
Packit |
13e616 |
regressions use smaller (16 and 128 nodes clusters).
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
The following test flows are run on the IB management simulator:
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* Stability:
|
|
Packit |
13e616 |
Up to 12 links from the fabric are randomly selected to drop packets
|
|
Packit |
13e616 |
at drop rates up to 90%. The SM is required to succeed in bringing the
|
|
Packit |
13e616 |
fabric up. The resulting routing is verified to be correct, too.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* LID Manager:
|
|
Packit |
13e616 |
Using LMC = 2 the fabric is initialized with LIDs. Faults such as
|
|
Packit |
13e616 |
zero LID, Duplicated LID, non-aligned (to LMC) LIDs are
|
|
Packit |
13e616 |
randomly assigned to various nodes and other errors are randomly
|
|
Packit |
13e616 |
output to the guid2lid cache file. The SM sweep is run 5 times and
|
|
Packit |
13e616 |
after each iteration a complete verification is made to ensure that all
|
|
Packit |
13e616 |
LIDs that could possibly be maintained are kept, as well as that all nodes
|
|
Packit |
13e616 |
were assigned a legal LID range.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* Multicast Routing:
|
|
Packit |
13e616 |
Nodes randomly join the 0xc000 group and eventually the
|
|
Packit |
13e616 |
resulting routing is verified for completeness and adherence to
|
|
Packit |
13e616 |
Up/Down routing rules.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* osmtest:
|
|
Packit |
13e616 |
The complete osmtest flow as described in the previous table is run on
|
|
Packit |
13e616 |
the simulated fabrics.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* Stress Test:
|
|
Packit |
13e616 |
This flow merges fabric, LID and stability issues with continuous
|
|
Packit |
13e616 |
PathRecord, ServiceRecord and Multicast Join/Leave activity to
|
|
Packit |
13e616 |
stress the SM/SA during continuous sweeps.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
5.3 OpenSM Regression
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
Using a back-to-back or single switch connection, the following set of
|
|
Packit |
13e616 |
tests is run nightly on the stacks described in table 2. The included
|
|
Packit |
13e616 |
tests are:
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* Stress Testing: Flood the SA with queries from multiple channel
|
|
Packit |
13e616 |
adapters to check the robustness of the entire stack up to the SA.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* Dynamic Changes: Dynamic Topology changes, through randomly
|
|
Packit |
13e616 |
dropping SMP packets, used to test OpenSM adaptation to an unstable
|
|
Packit |
13e616 |
network & verify DB correctness.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* Trap Injection: This flow injects traps to the SM and verifies that it
|
|
Packit |
13e616 |
handles them gracefully.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* SA Query Test: This test exhaustively checks the SA responses to all
|
|
Packit |
13e616 |
possible single component mask. To do that the test examines the
|
|
Packit |
13e616 |
entire set of records the SA can provide, classifies them by their
|
|
Packit |
13e616 |
field values and then selects every field (using component mask and a
|
|
Packit |
13e616 |
value) and verifies that the response matches the expected set of records.
|
|
Packit |
13e616 |
A random selection using multiple component mask bits is also performed.
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
5.4 Cluster testing:
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
Cluster testing is usually run before a distribution release. It
|
|
Packit |
13e616 |
involves real hardware setups of 16 to 32 nodes (or more if a beta site
|
|
Packit |
13e616 |
is available). Each test is validated by running all-to-all ping through the IB
|
|
Packit |
13e616 |
interface. The test procedure includes:
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* Cluster bringup
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* Hand-off between 2 or 3 SM's while performing
|
|
Packit |
13e616 |
- Node reboots
|
|
Packit |
13e616 |
- Switch power cycles (disconnecting the SM's)
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* Unresponsive port detection and recovery
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* osmtest from multiple nodes
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
* Trap injection and recovery
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
6 Qualification
|
|
Packit |
13e616 |
----------------
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
Table 2 - Qualified IB Stacks
|
|
Packit |
13e616 |
=============================
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
Stack | Version
|
|
Packit |
13e616 |
-----------------------------------------|--------------------------
|
|
Packit |
13e616 |
OFED | 1.0
|
|
Packit |
13e616 |
OpenIB Gen2 (IBG2 distribution) | 1.0
|
|
Packit |
13e616 |
OpenIB Gen1 (IBGD distribution) | 1.8.0
|
|
Packit |
13e616 |
VAPI (Mellanox InfiniBand HCA Driver) | 3.2 and later
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
Table 3 - Qualified Devices and Corresponding Firmware
|
|
Packit |
13e616 |
======================================================
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
Mellanox
|
|
Packit |
13e616 |
Device | FW versions
|
|
Packit |
13e616 |
--------|-----------------------------------------------------------
|
|
Packit |
13e616 |
MT43132 | InfiniScale - fw-43132 5.2.0 (and later)
|
|
Packit |
13e616 |
MT47396 | InfiniScale III - fw-47396 0.5.0 (and later)
|
|
Packit |
13e616 |
MT23108 | InfiniHost - fw-23108 3.3.2
|
|
Packit |
13e616 |
MT25204 | InfiniHost III Lx - fw-25204 1.0.1
|
|
Packit |
13e616 |
MT25208 | InfiniHost III Ex (InfiniHost Mode) - fw-25208 4.6.2 (and later)
|
|
Packit |
13e616 |
MT25208 | InfiniHost III Ex (MemFree Mode) - fw-25218 5.0.1 (and later)
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
QLogic/PathScale
|
|
Packit |
13e616 |
Device | Note
|
|
Packit |
13e616 |
--------|-----------------------------------------------------------
|
|
Packit |
13e616 |
iPath | QHT6040 (PathScale InfiniPath HT-460)
|
|
Packit |
13e616 |
iPath | QHT6140 (PathScale InfiniPath HT-465)
|
|
Packit |
13e616 |
iPath | QLE6140 (PathScale InfiniPath PE-880)
|
|
Packit |
13e616 |
|
|
Packit |
13e616 |
Note: OpenSM does not run on an IBM Galaxy (eHCA) as it does not expose
|
|
Packit |
13e616 |
QP0 and QP1. However, it does support it as a device on the subnet.
|