Fabric OS FCIP Administrators Guide v6.4.0 (53-1001766-01, November 2010)

96 Fabric OS FCIP Administrator’s Guide

53-1001766-01

FTRACE concepts

FTRACE is a support tool used primarily by your switch support provider. FTRACE can be used in a

manner similar to that of a channel protocol analyzer. FTRACE may be used to troubleshoot

problems using a Telnet session rather than sending an analyzer or technical support personnel to

the site.

CAUTION

FTRACE is meant to be used solely as a support tool and should be used only by Brocade support

personnel, or at the request of Brocade support personnel.

For the 7800 switch and the FX8-24 blade, FTRACE is always enabled, and the trace data is

automatically captured.

For the 7500 switch and FR4-18i blade, FTRACE must be manually configured and enabled using

the portCfg ftrace command. Root access is required. The syntax for the portCfg ftrace command is

as follows:

portCfg ftrace [slot/]ge0|ge1 tunnel_Id cfg [-a 1|0] [-b value] [-e 1|0] [-i value] [-p value] [-r value]

[-s value] [-t value] [-z value]

Where:

slot The number of a slot in a 48000 or DCX director chassis that contains an

FR4-18i blade. This parameter does not apply to the stand-alone 7500.

ge0|ge1 The Ethernet port used by the tunnel (ge0 or Ge1).

tunnelid The tunnel number (0 - 7).

cfg Creates an FTRACE configuration.

-a 1|0 Enables or disables auto check out.

-b value Number of buffers (range 0 to 8).

-e 1|0 Enable or disable FTRACE.

-i value Display mask value (range 0 to FFFFFFFF).

Default is FFFFFFFF.

-p value Post trigger percentage value (range 0-100). Default is 5.

-r value Number of records (range 0 through 1,677,721). Default us 200000.

-s value Trigger mask value (range 00000000 to FFFFFFFF). Default is 00000003.

-t value Trace mask value (range 00000000 to FFFFFFFF). Default is 80000C7B.

-z value Trace record size (range 80 to 240 bytes). Default is 80 bytes.

The following example configures FTRACE with ACO disabled, and FTRACE enabled with a trigger

mask value of 00000003, and a trace mask value of ffffffff.

root:admin> portcfg ftrace ge0 3 cfg -a 0 -e 1 -p 5 -s 00000003 -t ffffffff