Teledyne IBTracer 4X User Manual Ver.2.30

2403 Walsh Avenue, Santa Clara, CA 95051-1302 Tel: +1/408.727.6600 Fax: +1/408.727.6622

CATC IBTracer 4X

InfiniBand Protocol Analyzer

User’s Manual

™

For Software Version 2.3

Manual Version 2.3

18 April, 2003

IBTracer 4X Protocol Analyzer User’s ManualCATC SW Version 2.3

Document Disclaimer

The information in this document has been carefully checked and is believed to be reliable. However, no responsibility can be assumed for inaccuracies that may not have been detected.

CATC reserves the right to revise the information in this document without notice or penalty.

Trademarks and Servicemarks

CATC, Merlin, Advisor, Chief, FireInspector, IBTracer, USBTracer, SATracer, Traffic Generator, BusEngine, UPT, HPT, and UHT are trademarks of Computer Access Technology Corporation.

Microsoft, Windows, Windows NT, Windows 98SE, Windows ME, and Windows XP are registered trademarks of Microsoft Inc.

All other trademarks are property of their respective companies.

This document may be printed and reproduced without additional permission, but all copies should contain this copyright notice.

FCC CONFORMANCE STATEMENT

This equipment has been tested and found to comply with the limits for a Class A digital device, pursuant to Part 15 of the FCC Rules. These limits are designed to provide reasonable protection against harmful interference when the equipment is operated in a commercial environment. This equipment generates, uses, and can radiate radio frequency energy and, if not installed and used in accordance with the instruction manual, may cause harmful interference to radio communications. Operation of this equipment in a residential area is likely to cause harmful interference in which case the user will be required to correct the interference at his own expense. The end user of this product should be aware that any changes or modifications made to this equipment without the approval of CATC could result in the product not meeting the Class A limits, in which case the FCC could void the user's authority to operate the equipment.

IBTracer Protocol Analyzer User’s ManualCATC SW Version 2.3

EU CONFORMANCE STATEMENT

This equipment complies with the EMC Directive 89/336/EEC and the Low Voltage Directive 73/23/EEC, and their associated amendments for Class A Information Technology Equipment. It has been tested and found to comply with EN55022 and EN55024 (EN61000-4-2, EN61000-4-3, EN61000-4-4, EN61000-4-5, EN61000-4-6, EN61000-4-11, EN61000-3-2, EN61000-3-3), and EN605950.

Part number: 730-0031-00

iii

IBTracer 4X Protocol Analyzer User’s ManualCATC SW Version 2.3

Chapter1 Overview.....................................1

GeneralDescription ...............................................1

Support for the InfiniBand 1.1 Specification . . . ..........................2

IBTracerFeatures .................................................4

General...................................................4

DisplayOptions ............................................5

IBTracerBusEngine.........................................5

Specifications.....................................................6

Package...................................................6

PowerRequirements.........................................6

Environmental Conditions . ...................................6

Switches ..................................................6

LEDs ....................................................6

ProbingCharacteristics.......................................6

RecordingMemorySize .....................................6

BasicTriggerEvents.........................................7

Certification ...............................................7

Chapter2 QuickInstallation..............................9

PCRequirements..................................................9

SettingUptheAnalyzer.............................................9

InstallingtheSoftware.............................................10

YourFirstInfiniBandRecording.....................................10

CapturingYourFirstCATCTrace.............................12

TraceViewFeatures........................................12

Chapter3 DetailedInstallation...........................13

System Components/Packing List . . ..................................13

TheInstalledIBTracer4XUnit......................................13

LEDandButtonDescriptions.................................13

IBTracer4XSystemSetup..........................................15

ACPowerSource.................................................15

PCConnection...................................................16

InfiniBandCableConnection........................................16

ExternalInterfaceBreakoutBoard....................................16

Pin-OutsfortheDataIn/OutConnector.........................16

PrototypeReworkArea......................................18

IBTracerProgramInstallation.......................................18

Loading the IBTracer USBDrivers............................18

Installing the IBTracer ApplicationProgram ....................19

Installing IBTracer Software for the InfiniBand 1.1 Specification. . . . . 19

IBTracerProgramStartup ..........................................20

MakingaRecording...............................................20

Chapter4 Updates.....................................23

iii

IBTracer 4X Protocol Analyzer User’s ManualCATC SW Version 2.3

Software,Firmware,andBusEngineRevisions..........................23

SoftwareUpdates.................................................24

LicenseInformation...............................................24

UpdatingtheSoftwareLicense................................24

BusEngineandFirmwareUpdates....................................25

UpdatingtheBusEngine.....................................25

UpdatingtheFirmware......................................25

AutomaticUpdates.........................................26

ManualUpdates ...........................................27

ManuallyUpdatingtheFirmware..............................29

ResettingtheAnalyzer.............................................29

Chapter5 SoftwareOverview............................31

TheMainDisplayMenus...........................................31

ViewOptions....................................................33

ResettingtheToolbar .......................................33

ToolBar .................................................35

StatusBar.......................................................36

RecordingProgress.........................................36

RecordingStatus...........................................37

AnalyzerStatus............................................38

SearchStatus..............................................38

ZoomIn..................................................38

ZoomOut ................................................38

ToolTips .......................................................38

IBTracer Analyzer Keyboard Shortcuts. . ..............................39

Chapter6 RecordingOptions............................41

OpeningtheRecordingOptionsDialogBox............................41

RecordingOptions-General........................................42

Recordingtype ............................................42

Options..................................................43

BufferSize ...............................................43

TriggerPosition ...........................................43

RecordingOptions-Miscellaneous...................................44

1x/4xMode...............................................44

PhysicalLaneOrder ........................................45

Resolve Reliable Connections . . ..............................46

RecordingOptions-Events.........................................46

EventsOptions ............................................46

RecordingOptions-Actions........................................57

EventSequences...........................................58

EventCounts..............................................58

ActionsWindowLayout.....................................59

ConnectingEventstoActions .......................................60

TriggeringfromanEventinaSet ....................................63

CreatinganEventSequence.........................................63

IBTracer 4X Protocol Analyzer User’s ManualCATC SW Version 2.3

CountingEvents..................................................64

TriggeringExternalOutput .........................................66

Cabling ..................................................66

SettingExternalOutputOptions...............................67

SpecifyingPulseSignalOutputs...............................68

SettingMultipleConditionswithCounters.............................68

SequencingwithCounters ...................................69

LinkingTwoEventstoTwoorMoreCounters...................70

FilteringTraffic ..................................................70

RestartingSequencesandCounters...................................71

RestartingaSequence.......................................71

RestartingaCount..........................................71

SavingRecordingOptions..........................................72

RecordingInfiniBandTraffic........................................72

TrainingRetry ...................................................73

Chapter7 DisplayOptions ..............................75

GeneralDisplayOptions ...........................................75

SavingandLoadingDisplayOptions .................................76

ColorDisplayOptions.............................................77

FormatsDisplayOptions...........................................79

Hiding..........................................................80

CompoundHiding ................................................81

Headers.........................................................83

Chapter8 ReadingaCATCTrace........................85

TraceViewFeatures ..............................................85

SetMarker ......................................................85

EditorClearMarker ..............................................86

ExpandedandCollapsedFieldFormats................................88

Chapter9 DecodingTraffic..............................91

DecodingandDisplayingTraffic.....................................91

DecodingViatheToolbar....................................91

DecodingViatheDisplayOptionsDialogBox...................92

DecodingAssignments.............................................93

ToolTips .......................................................93

Expanding&CollapsingTraffic.....................................94

MADFormats ...................................................94

MAD,SAandSRPDecoderScriptFiles...............................94

Hiding/DisplayingFieldsviaDecoderScriptFiles ................95

DecodingAssignments.............................................95

ViewingDetailsaboutMAD,SubnetAdministrationandSRPFields........96

ViewingMADorSRPFields.................................96

Viewing Subnet Administration fields . .........................98

ViewingSAAttributes.....................................101

Chapter 10 Other Features . . ...........................103

IBTracer 4X Protocol Analyzer User’s ManualCATC SW Version 2.3

Search.........................................................103

GotoTrigger.............................................103

GotoPacket.............................................103

GotoMarker.............................................104

Goto...................................................104

Find....................................................110

FindNext ...............................................111

DisplayingRaw10bCodes........................................112

EditComment ..................................................114

FileInformation.................................................114

ErrorSummary..................................................115

TimingCalculations..............................................116

TrafficSummary ................................................118

BusUtilization..................................................118

RealTimeStatistics..............................................122

ExportingPacketsandData........................................124

ResolvingReliableConnections ....................................126

Breaking a Connection .....................................127

CreatingaConnection......................................127

VerificationScripts ..............................................127

EditingandCreatingScripts.................................129

Chapter11 HowtoContactCATC.......................131

IBTracer 4X Protocol Analyzer User’s ManualCATC SW Version 2.3

1. Overview

The CATC IBTracer™ 4X Protocol Analyzer is the ideal tool for analyzing InfiniBand link data. Development Engineers will rely on IBTracer 4X Analyzer to resolve software, firmware, and hardware problems encountered in the development of InfiniBand host channel adapters, switches, and other devices. Test and Quality Assurance Engineers will use IBTracer to verify the correct operation of InfiniBand products and compliance to the standard. Anyone involved with InfiniBand can use IBTracer software as a stand-alone viewer to understand the InfiniBand protocol and to facilitate system level discussions and problem resolution of applications employing InfiniBand technology.

Please refer to the InfiniBand Specification, version 1.0 for details on the InfiniBand protocol. The InfiniBand specification is available from the InfiniBand TA at its web site http://www.infinibandta.org/

1.1 General Description

IBTracer 4X hardware module installs into the CATC Universal Protocol Analyzer System (UPAS) 10000. The UPAS 10000 is a base system designed to accommodate different protocol modules.

Together, IBTracer and the UPAS connect to a portable or desktop PC. This PC runs the user interface for administering the Analyzer and displaying traces.

IBTracer 4X Protocol Analyzer User’s ManualCATC SW Version 2.3

IBTracer 4X is a non-intrusive testing tool for the InfiniBand architecture providing traffic capture and analysis. Hardware triggering allows real-time events to be captured. Hardware filtering allows the different types of packets to be filtered in or out of the recording. Filtering allows users to focus recordings on events of interest and to preserve recording memory so that the recording time can be extended.

Recorded data is presented in colored graphics in a trace viewer application. This application has advanced search and viewing capabilities that allow the user to quickly locate specific data, errors, and other desired conditions, thereby focussing the user’s attention on events of interest.

IBTracer 4X Protocol Analyzer functions with any personal computer using the Windows 98SE, Window 2000, Windows ME, or Windows XP operating systems and equipped with a functional USB interface.

IBTracer 4X provides on-the-fly detection of and triggering on such events as Packet Headers and Errors. Whether recording manually or with a specified trigger condition, IBTracer continuously records the link data in a wrap-around fashion until manually stopped or until the Trigger Event is detected and a specified amount of post-Trigger link data is recorded.

Upon detection of a triggering event, the analyzer continues to record data up to a point specified by the user. Real-time detection of events can be individually enabled or disabled to allow triggering on events as they happen. This includes predefined exception or error conditions and a user-defined set of trigger events. The unit can also be triggered by an externally supplied signal. An external DB-25 connector provides a path for externally supplied data or timing data to be recorded along with traffic.

This DB-25 connector also provides a path for IBTracer 4X to transmit externally two control, timing, or recovered signals for purposes of probing and use by other circuitry.

The IBTracer software provides powerful search functions that enable investigation of particular events and allow the software to identify and highlight specific events. In addition to immediate analysis, you can print any part of the data. Use the Save As feature to save the data on disk for later viewing. The program also provides a variety of timing information and data analysis reports.

1.2 Support for the InfiniBand 1.1 Specification

Support for viewing the InfiniBand® specification v1.1 (SPEC 1.1) management datagrams is a special feature that must be purchased separately. This feature is called the IBTracer v2.3 (SPEC 1.1) Software Upgrade. For more

IBTracer 4X Protocol Analyzer User’s ManualCATC SW Version 2.3

information on the IBTracer V2.3 (SPEC 1.1) Software Upgrade, contact your regional CATC Sales Manager: 1 800 909-7211 or 408 653-1262 or sales@catc.com.

Viewing Spec 1.1 Trace Files: The InfiniBand Trade Association Specification, version 1.1, released November 6, 2002 is fully supported in IBTracer v2.3 (SPEC

1.1). InfiniBand traffic recorded with IBTracer v2.3 may be opened with the previous release (see below), IBTracer v2.2. Packet level detail will display correctly in IBTracer v2.2 (SPEC 1.0). However, Management Datagram (MAD) level traffic will display using the InfiniBand Specification 1.0 standard. If the recording contains InfiniBand (SPEC 1.1) traffic, some MAD level fields will appear incorrectly formatted.

Viewing Spec 1.0 Trace Files: The InfiniBand Trade Association Specification, version 1.0, (SPEC 1.0) is fully supported in IBTracer v2.2. InfiniBand traffic recorded with IBTracer v2.2 may be opened with the newer version 2.3 release. IBTracer v2.2. Packet level detail will display correctly in IBTracer v2.3 (SPEC

1.1). However, Management Datagram (MAD) level traffic will display using the InfiniBand Specification 1.1 standard. If the recording contains InfiniBand (SPEC

1.0) traffic, some MAD level fields will appear incorrectly formatted.

The table below outlines the behavior for when viewing traces recorded with IBTracer 2.2 and IBTracer 2.3 (SPEC 1.1):

Software Viewer

IBTracer v2.2 or earlier IBTracer v2.3 (SPEC 1.1)

InfiniBand

1.0 Traffic

Open traces and Decodes IB SPEC 1.0 Mad types

Open traces but does not decode IB SPEC 1.0 Mad types

InfiniBand

1.1 Traffic

Opens traces but does not Decode IB SPEC 1.1 MAD

Opens traces and Decodes IB SPEC 1.1 MAD types

types

Users that wish to record and view trace files that contain traffic conforming to the original InfiniBand 1.0 specification and trace files that contain traffic conforming to the new InfiniBand 1.1 Specification should keep both IBTracer software version 2.2 and 2.3 installed on their system.

IBTracer 4X Protocol Analyzer User’s ManualCATC SW Version 2.3

1.3 IBTracer Features

General

• Upgradeable firmware and recording engine

• Software operates stand-alone on any Microsoft Windows 98SE or later computer as a "Trace Viewer"

• Link and data packets are displayed and fully decoded

• Training sequences are displayed

• Transport level functions are fully decoded with a graphical illustration of the comprised packets and messages

• Errors at the physical, link, and transport levels are highlighted in red

• Online help

Physical Components

•IBTracer 4X plug-in module

•UPAS/IBTracer 4X can be administered by any desktop or portable Microsoft Windows-based computer with USB capability

• Convenient Plug-and-Play USB installation

• Taps non-intrusively between two 10 Gbit/sec InfiniBand ports using two standard cables

• External interface for probing and monitoring auxiliary digital signals and for cross triggering between other test instruments

Recording Options

• Record up to 2 Gbyte of InfiniBand data, timing and control information

• Three recording modes: Snapshot, Manual Trigger, and Event Trigger

• Selectable recording buffer size and trigger position

• Record the full data rate of a single 4X, 10 Gbit/sec InfiniBand link

• Trigger on InfiniBand conditions like link training sequences or power off disconnect events

• Trigger on a comprehensive list of error conditions, such as running disparity, bad packets, or bad variant or invariant CRCs

• Trigger on a sequence of packets to capture messages and transport level events

• Optionally filter captured data

• Breakout board data

• Counters

IBTracer 4X Protocol Analyzer User’s ManualCATC SW Version 2.3

Display Options

• Extensive use of color and graphics within the trace

• Packet errors and protocol violations are highlighted in red

• Packet color clearly indicates position before or after the trigger point

• Packets can be marked with text annotations that become tool-tips for future reference

• Tool-tips with complete definitions of most fields

• Search, show, or hide only the data of interest using InfiniBand-specific criteria

• Packets are accurately time-stamped (1 symbol time or 4 ns resolution)

• Measure time, throughput, or responsiveness between packet markers or relative to the trigger position

IBTracer BusEngine

CATC’s BusEngine™ Technology is at the heart of the new IBTracer 4X Analyzer. The revolutionary BusEngine core uses state-of-the-art Field Programmable Gate Array (FPGA) technology and incorporates both the real-time recording engine and the configurable building blocks that implement data/state/error detection, triggering, capture filtering, external signal monitoring and event counting and sequencing. Like the flash-memory-based firmware that controls its operation, all BusEngine logic is fully field upgradeable, using configuration files that can be downloaded from the CATC website.

IBTracer 4X Protocol Analyzer User’s ManualCATC SW Version 2.3

1.4 Specifications

IBTracer is a hardware module that installs into the Universal Protocol Analyzer System. The following specifications describe a combined IBTracer 4X Universal Protocol Analyzer System.

Package

Connectors: AC power connection

Host connection (USB2.0, type "B") Recording Channel

Power Requirements

90-254 VAC, 47-63 Hz, 165W maximum (universal input)

Environmental Conditions

Operating Range: 0 to 40 °C (32 to 104 °F) Storage Range: -20 to 80 °C (-4 to 176 °F) Humidity: 10 to 90%, non-condensing

Switches

Power: On/off Manual Trigger: When pressed forces a trigger event

LEDs

Status: Illuminated when the analyzer is powered on.

Probing Characteristics

Connection: receptacles

Standard cables

Recording Memory Size

2 GBytes for trace capture, timing, and control information.

IBTracer 4X Protocol Analyzer User’s ManualCATC SW Version 2.3

Basic Trigger Events

Conditions: Training sequences, Link Packets, Data Packets

Cable disconnect/connect

Packet Patterns: VLT, LID, Opcode, QP, AETH, LRM, BTM, Data,

Immediate data, Sixteen aligned data bytes, MAD types

Errors: Invalid 10b codes

Wrong running disparity of 10b codes End of bad packet Packet delimiters violations

Certification

FCC (Class A), CE Mark

IBTracer 4X Protocol Analyzer User’s ManualCATC SW Version 2.3

2. Quick Installation

IBTracer 4X is a factory-installed hardware module that is sold as part of the CATC Universal Protocol Analyzer System 10000 (UPAS).

The UPAS 10000 together with the IBTracer 4X module and associated software are easily installed on most Windows-based personal computer systems. You can begin making InfiniBand™ recordings after following these initial steps. However, if you are unsure about what to do after reading the Quick Installation instructions, or if your analyzer does not work after you follow these instructions, read through the sections in this manual.

2.1 PC Requirements

IBTracer 4X is administered by a PC. This PC needs to have the following features in order to be able to communicate with the Analyzer:

• A USB port (USB 2.0 recommended). All communications between the PC and the analyzer pass across a USB cable. If the PC is being used only as a trace viewer, then the USB port is not necessary.

• Microsoft Windows 98SE, Windows ME, Windows 2000, or Windows XP for recording and viewing traffic.

• Physical RAM should be a minimum of 128 MB. The amount you use should be at least equal to the amount of your largest recording. For example, if you plan to make 2-Gbyte recordings, then your PC should have 2048 MB of RAM.

2.2 Setting Up the Analyzer

Step 1 Remove the IBTracer 4X/UPAS from its shipping container.

The IBTracer 4X module will already be installed in the UPAS.

Step 2 Connect the AC power cable to the rear of the UPAS.

Step 3 Connect the USB cable between the USB port on the back of the

Analyzer and a USB port on the PC.

Step 4 Turn on the power switch located on the rear of the Analyzer.

Step 5 Insert the IBTracer 4X CD into the PC that will be controlling the

analyzer.

Step 6 Follow on-screen Plug-and-Play instructions for the automatic

installation of the IBTracer Analyzer as a USB device on your PC (the IBTracer CD includes the required USB files).

IBTracer 4X Protocol Analyzer User’s ManualCATC SW Version 2.3

2.3 Installing the Software

Step 1 Run the setup program (for example,Start>Run>d:\setup)and

follow the on-screen instructions to install the IBTracer application on the analyzing PC hard disk.

Step 2 To start the application, launch the CATC IBTracer 4X program

from the Start Menu: Start>Programs>CATC>IBTracer.

2.4 Your First InfiniBand Recording

After installing and launching the software, you can test IBTracer 4X by following these steps:

Step 1 Plug in a InfiniBand cable to each of the two ports on the IBTracer

4X module, and then connect the other ends to the device under test.

Step 2 Select Recording Options under Setup on the Menu Bar.

Step 3 Select the General tab.

The following dialog box will open showing factory default settings such as “Snapshot” and 16 Mbytes buffer size. For your first recording, you can leave these settings unchanged.

Step 4 Click OK to activate the recording options you selected.

Step 5 Turn on the InfiniBand devices that are to be tested and cause them

to generate InfiniBand traffic.

IBTracer 4X Protocol Analyzer User’s ManualCATC SW Version 2.3

Step 6 Click on the Tool Bar.

IBTracer 4X starts to record the InfiniBand traffic immediately. After 4 Mbytes of traffic is recorded, the analyzer will upload the data and display the packets in the trace window.

Step 7 If you wish to terminate the recording before the snapshot

automatically completes, click on the Tool Bar.

When the recording session is finished, the traffic is uploaded from the Analyzer to the hard drive on your PC as a file named data.ibt or whatever name you assigned as the default filename. While the file is being uploaded, you should see a white progress bar at the bottom of the screen. When the bar disappears, it indicates that the data has been uploaded to disk.

Step 8 To save a current recording for future reference, select File > Save

As on the Menu Bar.

Click on the Tool Bar.

You see the standard Save As screen.

Step 9 Give the recording a name and save it to the appropriate directory.

IBTracer 4X Protocol Analyzer User’s ManualCATC SW Version 2.3

Capturing Your First CATC Trace

After a few moments, the recording will end and the results will display.

Trace View Features

•TheIBTracer packet view display uses color and graphics extensively to fully document the captured traffic.

• Packets are shown on separate rows, with their individual fields both labeled and color coded.

• Packets are numbered sequentially, as recorded andtime-stamped with a resolution of 1 symbol time or 4 ns.

• Display formats can be named and saved for later use.

• Pop-up Tool Tips annotate packet fields with detailed information about their contents.

• Data fields can be collapsed to occupy minimal space in the display (which can in turn be zoomed in and out to optimize screen utilization).

• The display software can operate independent of the hardware and thus can function as a stand-alone Trace Viewer that can be freely distributed.

IBTracer 4X Protocol Analyzer User’s ManualCATC SW Version 2.3

3. Detailed Installation

3.1 System Components/Packing List

• One stand-alone IBTracer 4X Analyzer module

• One Universal Protocol Analyzer System 10000 Chassis

• One USB cable

• One 6-foot (2-meter) 4x to 4x cable

• Two 6-foot (2-meter) Infiniband 4x to 1x cables

• One DB-25 parallel cable

• One UPAS External Breakout Board

•IBTracer 4X software program installation CD-ROM

• Product documentation

3.2 The Installed IBTracer 4X Unit

If you purchased an IBTracer 4X module with a UPAS, the IBTracer 4X module will arrive inserted into the UPAS. Upon power up, the installed IBTracer 4X Analyzer will activate the user-accessible controls and LEDs on the front and rear panels of the UPAS.

Figure 1: Front Panel

LED and Button Descriptions

If you look at the front panel, you will see LEDs, buttons, and connectors.

Left-most LEDs

•GreenPWR (power) indicator LED for UPAS (lights when the unit power is switched on).

•RedStatus indicator LED for UPAS (lights during the boot up).

IBTracer 4X Protocol Analyzer User’s ManualCATC SW Version 2.3

Center-most LEDs and Button

The LEDs and button on the UPAS enclosure function in conjunction with the IBTracer 4X module inserted above it.

•GreenREC (recording) LED (lights when the unit is recording).

• Orange TRG (triggered) LED (lights when the unit triggers an event).

•GreenUPLD (Upload) (lights when unit is uploading data to PC).

• MANUAL TRG (Manual Trigger) push-button (allows a manual Trace capture).

Right-most LEDs and Button

The LEDs and button under the right module slot are reserved for future releases of hardware modules.

•GreenREC (recording) LED (lights when the unit is recording).

• Orange TRG (triggered) LED (lights when the unit triggers an event TRG also lights during power-on testing and will be turned off at the end of the power on cycle. If the LED blinks at the end of this cycle, the hardware is faulty).

•GreenUPLD (Upload) LED (lights when unit is uploading data to PC).

• MANUAL TRG push-button (allows a manual Trace capture).

Figure 2: Universal Protocol Analyzer Rear Panel and its connectors

• Wide range AC connector module

— Power socket

— Enclosed 5x20 mm 2.0A 250 V fast acting glass fuse

Warning: For continued protection against fire, replace fuse only with the

type and rating specified above.

— Power on/off switch

• Two External Ports marked Ext. In and Ext. Out

• USB 2.0 type B host computer connector

• Data In/Out DB-25 (25-pin) external interface connector

IBTracer 4X Protocol Analyzer User’s ManualCATC SW Version 2.3

Warning: Do not open the UPAS enclosure. There are no user-serviceable parts inside. Refer servicing to CATC.

3.3 IBTracer 4X System Setup

IBTracer 4X and UPAS are connected via USB to a desktop or laptop PC. The PC, in turn, is used to administer the Analyzer and display traces.

To set up the Analyzer and PC,

Step 1 If needed, insert the IBTracer 4X module into the UPAS.

Step 2 Connect the UPAS to an AC power source.

Step 3 Connect the Analyzer to the analyzing PC via USB.

Step 4 Connect InfiniBand cables to the devices under test.

Step 5 Install IBTracer software.

Step 6 Create a recording.

3.4 AC Power Source

Step 1 Connect the Analyzer box to a 100-volt to 240-volt, 50 Hz to 60 Hz,

165 W power outlet using the provided power cord.

Note The Analyzer is capable of supporting supply voltages between

100-volt and 240-volt, 50 Hz or 60 Hz, thus supporting all known supply voltages around the world.

Step 2 Use the power switch located on the rear panel to turn the analyzer

unit on and off.

Note At power-on, the Analyzer initializes itself in a few seconds and

then performs an exhaustive self-diagnostic that lasts about 20 seconds. The Status LED illuminates during the power-on testing and turns off when testing is finished. If the diagnostics fail, the Status LED blinks, indicating a hardware failure. If this occurs, call CATC Customer Support for assistance.

IBTracer 4X Protocol Analyzer User’s ManualCATC SW Version 2.3

3.5 PC Connection

Use the USB cable provided to connect the host computer to the UPAS.

• At least 20 MB hard disk space is required, plus additional memory for recordings (as much as 2 Gbytes or more when recording a full buffer size).

• Monitor resolution is at least 800x600 with thousands of colors.

3.6 InfiniBand Cable Connection

CATC provides two 1x-to-4x InfiniBand cables and one 4x InfiniBand cable. The 1x-to-4x cables are actually 1x cables with 4x connectors. These cables allow you to connect 1x devices to IBTracer 4x.

3.7 External Interface Breakout Board

The External Interface Breakout Board is an accessory that allows convenient access to several potentially useful standard, LVTTL output and input signals. It also offers a simple way to connect logic analyzers or other tools to the IBTracer 4X Analyzer unit. Six ground pins and one 5-volt pin are provided.

The Breakout Board connects via a cable to the Data In/Out connector located on the rear of the analyzer box. Each signaling pin on the breakout board is isolated by a 100Ω series resistor.

Figure 3: Data In/Out Cable Connector

Pin-Outs for the Data In/Out Connector

The following table lists the pin-out and signal descriptions for the Data In/Out connector. This pin-out is for a cable connector that connects to the

breakout board.

IBTracer 4X Protocol Analyzer User’s ManualCATC SW Version 2.3

Data In/Out Connector – Pin-Out

Pin Signal Name Signal Description

1RSV Reserved

2 GND Ground

3 GP OUT General Purpose Output

4 TRG IN 1 Trigger In 1

5 GND Ground

6 DATA 6 Data 6

7 DATA 4 Data 4

8 DATA 3 Data 3

9 DATA 1 Data 1

10 GND Ground

11 RSV Reserved

12 RSV Reserved

13 +5V +5 Volts, 250 mA DC Source

14 RSV Reserved

15 GND Ground

16 TRG OUT Trigger Out

17 TRGIN0 TriggerIn0

18 DATA 7 Data 7

19 DATA 5 Data 5

20 GND Ground

21 DATA 2 Data 2

22 DATA 0 Data 0

23 GND Ground

24 RSV Reserved

25 RSV Reserved

Note (*) Pins 4 and 17 have the same function: they allow external

signals to be used to cause triggering or recording. Pins 3 and 16 are used to transmit output signals.

IBTracer 4X Protocol Analyzer User’s ManualCATC SW Version 2.3

Figure 4: External Interface Breakout Board

Prototype Rework Area

The Breakout Board contains a prototype rework area for making custom circuits for rapid development. The area consists of plated-through holes, 20 columns wide by 27 rows long. The top row of holes is connected to GND and the bottom row is connected to +5V. The remaining holes are not connected. Use the rework area to insert custom components and wire-wrap their respective signal, power, and ground pins.

3.8 IBTracer Program Installation

The CATC IBTracer software is provided on CD-ROM and requires a Windows 98SE, Windows 2000, Windows ME, or Windows XP operating system.

Note The IBTracer program can be installed on any Windows 98SE

or later operating system as a "Trace Viewer." That is, it may be used to view, analyze, and print data that was collected and saved on another system even if it does not have an Analyzer attached.

Loading the IBTracer USB Drivers

Step 1 Insert the IBTracer program CD-ROM into your PC.

IBTracer 4X Protocol Analyzer User’s ManualCATC SW Version 2.3

Step 2 Power-on the IBTracer Analyzer.

Step 3 Connect the USB cable to the rear of the analyzer and to the personal

computer.

The host operating system detects the Analyzer and begins to install the USB driver.

Note When Windows prompts you for a file, browse to the CATC CD.

If this is a first time installation, the ctcupa10.sys (UPAS) and ib4trcer.sys (USB) drivers must also be installed.

Installing the IBTracer Application Program

Run setup.exe from the IBTracer CD-ROM.

The CATC IBTracer Install Wizard automatically installs the necessary files to the computer’s hard drive. IBTracer software is installed in the

C:\Program Files\CATC\IBTracer directory unless you specify otherwise.

Follow the installation instructions on your screen.

Installing IBTracer Software for the InfiniBand 1.1 Specification

IBTracer version 2.3 supports the new InfiniBand 1.1 specification. This version is available for purchase as a special feature from CATC. Consult the CATC website for further details.

www.catc.com

Both IBTracer 2.3 and IBTracer 2.2 can be installed on the same PC. If you plan to install two version, install the version 2.2 first, then install version

2.3.

Version 2.3 will be installed in a separate directory called IBTracer (spec1.1).

Either version can be run from the start menu, but only one version should be run at a time.

To distinguish which version you are running, look at the titlebar at the top of the window. The titlebar will show (spec 1.1) in version 2.3.

You can also see what version of software is running by opening the "Help-About" box by selecting Help > About IBTracer.

IBTracer 4X Protocol Analyzer User’s ManualCATC SW Version 2.3

3.9 IBTracer Program Startup

You can start the IBTracer program from the desktop or from the installed directory. The program always begins with its main screen active:

When the program is used with the IBTracer Protocol Analyzer attached to the computer, you can set trigger conditions, record, monitor, and analyze the activity of your InfiniBand device or fabric. When used without the Analyzer, the software serves as a Trace Viewer for viewing traces made on other systems.

3.10 Making a Recording

After installation, the software is configured to make a Snapshot recording of InfiniBand traffic.

To make your first recording of this traffic,

Step 1 Connect InfiniBand cables to both InfiniBand connectors on the

front panel of the IBTracer 4X module and plug the other ends into the device under test.

IBTracer 4X Protocol Analyzer User’s ManualCATC SW Version 2.3

Step 2 Cause the device under test to generate InfiniBand traffic.

Step 3 Click on the Tool Bar.

After 16 Mbytes of traffic is recorded, the analyzer will upload the data and display the packets.

To terminate the recording before Inquiry timeout occurs,

Step 4 Click on the Tool Bar at any time before recording

automatically terminates.

When the recording session is finished, the traffic is saved to the hard drive as a file named data.ibt or whatever name you assign as the default filename.

To save a current recording for future reference,

Step 5 Select Save As under File on the Menu Bar.

Click on the Tool Bar.

You see the standard Save As screen.

Step 6 Give the recording a unique name and save it to the appropriate

directory.

IBTracer 4X Protocol Analyzer User’s ManualCATC SW Version 2.3

+ 116 hidden pages

Teledyne IBTracer 4X User Manual Ver.2.30

Specifications and Main Features

Frequently Asked Questions

User Manual

CONTENTS

1. Overview

1.1 General Description

1.2 Support for the InfiniBand 1.1 Specification

1.3 IBTracer Features

General

Display Options

IBTracer BusEngine

1.4 Specifications

Package

Power Requirements

Environmental Conditions

Switches

LEDs

Probing Characteristics

Recording Memory Size

Basic Trigger Events

Certification

2. Quick Installation

2.1 PC Requirements

2.2 Setting Up the Analyzer

2.3 Installing the Software

2.4 Your First InfiniBand Recording

Capturing Your First CATC Trace

Trace View Features

3. Detailed Installation

3.1 System Components/Packing List

3.2 The Installed IBTracer 4X Unit

LED and Button Descriptions

3.3 IBTracer 4X System Setup

3.4 AC Power Source

3.5 PC Connection

3.6 InfiniBand Cable Connection

3.7 External Interface Breakout Board

Pin-Outs for the Data In/Out Connector

Prototype Rework Area

3.8 IBTracer Program Installation

Loading the IBTracer USB Drivers

Installing the IBTracer Application Program

Installing IBTracer Software for the InfiniBand 1.1 Specification

3.9 IBTracer Program Startup

3.10 Making a Recording