Ftrace Concepts - Brocade Communications Systems 8 Administrator's Manual

4

FTRACE concepts

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
ge0|ge1
tunnelid
cfg
-a 1|0
-b value
-e 1|0
-i value
-p value
-r value
-s value
-t value
-z value
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
96
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.
The Ethernet port used by the tunnel (ge0 or Ge1).
The tunnel number (0 - 7).
Creates an FTRACE configuration.
Enables or disables auto check out.
Number of buffers (range 0 to 8).
Enable or disable FTRACE.
Display mask value (range 0 to FFFFFFFF).
Default is FFFFFFFF.
Post trigger percentage value (range 0-100). Default is 5.
Number of records (range 0 through 1,677,721). Default us 200000.
Trigger mask value (range 00000000 to FFFFFFFF). Default is 00000003.
Trace mask value (range 00000000 to FFFFFFFF). Default is 80000C7B.
Trace record size (range 80 to 240 bytes). Default is 80 bytes.
Fabric OS FCIP Administrator's Guide
53-1001766-01