To configure local Cisco Fabric Analyzer, use the
fcanalyzer
local
command in EXEC mode.
fcanalyzer | ethanalyzer local [ interface { inband | mgmt } [ capture-filter expression ] [brief] [ [ display-filter expression ] [ [ limit-captured-frames number ] [ [ limit-frame-size bytes ] [ write uri2 ] ] ] ] | [ interface { inband | mgmt } [dump-pkt] ] ]
Syntax Description
interface
|
(Optional) Begins live capture on following interface.
|
inband
|
(Optional) Specifies an inband interface (default interface
to capture on).
|
mgmt
|
(Optional) Specifies an management interface.
|
capture-filter
|
(Optional) Filters frames using a capture filter
expression.
|
expression
|
Specifies capture filter expression.
|
brief
|
(Optional) Displays the protocol summary in a brief.
|
display-filter
|
(Optional) Filters frames using display filter expression.
|
expression
|
Specifies display filter expression.
|
limit-captured-frames
number
|
(Optional) Limits the number of frames captured to 10. The
range is 0 to 2147483647 frames. Use 0 if you do not want to limit the captured
frames.
|
limit-frame-size
bytes
|
(Optional) Limits the size of the frame captures. The range
is 64 to 65536 bytes.
|
write
|
(Optional) Saves the captured frames to a specified file.
|
uri2
|
The filename to be written in (bootflash: or volatile:).
|
dump-pkt
|
Specifies Hex (ASCII) dumps packet, troubleshoot packet
analyzer.
|
Command Default
Number of packets captured by default is changed from 100 to 10.
Command History
Release
|
Modification
|
NX-OS 4.1(1a)
|
Changed the display-filter syntax description.
|
NX-OS 4.2(2)
|
Moved local capture to EXEC mode, added support for
capturing on mgmt interface along with inband (fc-interface). Also addded
capture-filter support and support for hex dump of packets.
|
1.0(2)
|
This command was introduced.
|
Examples
The following example shows how to display only protocol summary on
VSAN1:
switch# fcanalyzer local interface inband brief
Capturing on inband interface
0.000000 ff.fa.01 -> ff.fa.01 FC OHMS(Cisco MDS)
0.001033 ff.fa.04 -> ff.fa.04 FC OHMS(Cisco MDS)
4.996424 ff.fa.01 -> ff.fa.01 FC OHMS(Cisco MDS)
4.997452 ff.fa.04 -> ff.fa.04 FC OHMS(Cisco MDS)
9.996536 ff.fa.01 -> ff.fa.01 FC OHMS(Cisco MDS)
9.997470 ff.fa.04 -> ff.fa.04 FC OHMS(Cisco MDS)
14.996572 ff.fa.01 -> ff.fa.01 FC OHMS(Cisco MDS)
14.997590 ff.fa.04 -> ff.fa.04 FC OHMS(Cisco MDS)
19.996463 ff.fa.01 -> ff.fa.01 FC OHMS(Cisco MDS)
19.997415 ff.fa.04 -> ff.fa.04 FC OHMS(Cisco MDS)
switch#
The following example shows how to display capture on inband
interface:
switch# fcanalyzer local interface inband
Capturing on inband interface
Frame 1 (148 bytes on wire, 148 bytes captured)
Arrival Time: Apr 15, 2010 11:20:47.577355000
Time delta from previous packet: 0.000000000 seconds
Time since reference or first frame: 0.000000000 seconds
Frame Number: 1
Packet Length: 148 bytes
Capture Length: 148 bytes
Ethernet II, Src: 00:00:00:00:00:0a, Dst: 00:00:00:00:ee:00
Destination: 00:00:00:00:ee:00 (00:00:00:00:ee:00)
Source: 00:00:00:00:00:0a (00:00:00:00:00:0a)
Type: Unknown (0xfcfc)
MDS Header(Unknown(0)/Unknown(0))
MDS Header
...0 0000 0111 0110 = Packet Len: 118
.... 0000 0000 00.. = Dst Index: 0x0000
.... ..01 0010 0000 = Src Index: 0x0120
.... 0000 0000 0001 = VSAN: 1
MDS Trailer
EOF: Unknown (0)
CRC: 0xdeadbeef
Fibre Channel
R_CTL: 0x20(Extended Link Services/0x0)
switch#
The following example shows how to display a hex dump of packets:
switch# fcanalyzer local interface inband dump-pkt
Warning: Couldn't obtain netmask info (eth2: no IPv4 address assigned).
Capturing on eth2
0.000000 ff.fa.01 -> ff.fa.01 FC OHMS(Cisco MDS)
0000 00 00 00 00 ee 00 00 00 00 00 00 0a fc fc 81 00 ................
0010 00 72 ff 00 01 20 00 01 00 00 00 10 01 00 20 ff .r... ........ .
0020 fa 01 00 ff fa 01 01 00 00 03 00 00 00 00 ff ff ................
0030 ff ff 00 00 00 00 00 00 00 00 00 00 03 49 00 00 .............I..
0040 00 29 f6 1f 73 d9 00 00 00 00 00 00 00 00 00 00 .)..s...........
0050 00 00 00 00 00 00 00 ff fa 01 00 ff fa 01 00 00 ................
0060 09 96 00 00 00 00 00 00 00 04 00 00 00 02 00 00 ................
0070 00 00 01 00 00 00 ff ff ff ff 00 09 f5 00 2b 99 ..............+.
0080 86 d2 8b df 4e 02 0b aa aa aa 00 00 de ad be ef ....N...........
0.001112 80:57:00:00:cb:07 -> 81:00:00:72:e7:00 LLC I P, N(R) = 127, N(S) = 16
; DSAP NULL LSAP Group, SSAP 68 Command
0000 81 00 00 72 e7 00 80 57 00 00 cb 07 00 10 01 68 ...r...W.......h
0010 20 ff fa 01 00 ff fa 01 01 00 00 03 00 00 00 00 ...............
0020 ff ff ff ff 00 00 00 00 00 00 00 00 00 00 03 49 ...............I
0030 00 00 00 29 f6 1f 73 d9 00 00 00 29 f6 1f d4 00 ...)..s....)....
0040 00 00 00 00 00 00 00 00 00 ff fa 01 00 ff fa 01 ................
0050 00 00 09 96 00 00 00 00 00 00 00 04 00 00 00 02 ................
0060 00 00 00 00 01 00 00 00 ff ff ff ff 00 09 f5 00 ................
0070 2b 99 86 d2 8b df 4e 02 0b aa aa aa 00 00 de ad +.....N.........
0080 4d 94 M.
0.001763 ff.fa.04 -> ff.fa.04 FC OHMS(Cisco MDS)
0000 00 00 00 00 ee 00 00 00 00 00 00 0a fc fc 81 00 ................
0010 00 96 ff 80 81 20 00 01 00 00 00 10 01 00 20 ff ..... ........ .
0020 fa 04 00 ff fa 04 01 00 00 00 00 00 00 00 ff ff ................
0030 ff ff 00 00 00 00 00 00 00 00 00 00 03 49 00 00 .............I..
0040 00 29 f6 1f fc e2 00 00 00 00 00 00 00 00 00 00 .)..............
0050 00 00 00 00 00 00 00 ff fa 04 00 ff fa 04 00 00 ................
0060 09 96 00 00 00 00 00 00 00 00 00 00 00 01 00 00 ................
0070 00 00 06 08 20 00 06 08 20 00 00 30 d1 00 f6 cc .... ... ..0....
0080 99 87 01 c8 72 e1 ad c5 a0 dd 09 c3 d6 2d 56 8b ....r........-V.
0090 18 96 0a 43 2f 90 15 bb 70 63 bd 7b e1 b3 47 7a ...C/...pc.{..Gz
00a0 3a 49 42 ac 2a ef 71 ca cd 7a 8e a3 a7 e4 00 00 :IB.*.q..z......
00b0 de ad be ef ....
0.002248 81:20:00:01:cb:07 -> 81:00:00:96:ff:80 LLC I P, N(R) = 127, N(S) = 16
; DSAP NULL LSAP Group, SSAP NetWare Command
The following example shows how to use a display filter on inband
interface and display its summary:
switch# fcanalyzer local interface inband brief display-filter 'mdshdr.vsan==0x1 && (fc.d_id == "ff.fa.01") || (fc.s_id == "ff.fa.04")'
Capturing on inband interface
0.000000 ff.fa.01 -> ff.fa.01 FC OHMS(Cisco MDS)
0.001782 ff.fa.04 -> ff.fa.04 FC OHMS(Cisco MDS)
4.996741 ff.fa.01 -> ff.fa.01 FC OHMS(Cisco MDS)
4.997725 ff.fa.04 -> ff.fa.04 FC OHMS(Cisco MDS)
9.996670 ff.fa.01 -> ff.fa.01 FC OHMS(Cisco MDS)
9.997483 ff.fa.04 -> ff.fa.04 FC OHMS(Cisco MDS)
14.996623 ff.fa.01 -> ff.fa.01 FC OHMS(Cisco MDS)
14.997642 ff.fa.04 -> ff.fa.04 FC OHMS(Cisco MDS)
19.996739 ff.fa.01 -> ff.fa.01 FC OHMS(Cisco MDS)
19.997554 ff.fa.04 -> ff.fa.04 FC OHMS(Cisco MDS)
switch#
The following example shows how to write captured packets in PCAP
format and display captures on the screen:
switch# fcanalyzer local interface inband display-filter 'mdshdr.vsan==0x1 && (fc.d_id == "ff.fa.01") || (fc.s_id == "ff.fa.04")' limit-captured-frames 2 write bootflash:fc_cap
Frame 2 (160 bytes on wire, 160 bytes captured)
Arrival Time: May 6, 2010 09:53:38.020767000
Time delta from previous packet: 0.000000000 seconds
Time since reference or first frame: 0.000000000 seconds
Frame Number: 2
Packet Length: 160 bytes
Capture Length: 160 bytes
Ethernet II, Src: 00:00:00:00:00:0a, Dst: 00:00:00:00:ee:00
Destination: 00:00:00:00:ee:00 (00:00:00:00:ee:00)
Source: 00:00:00:00:00:0a (00:00:00:00:00:0a)
Type: Unknown (0xfcfc)
MDS Header(Unknown(0)/Unknown(0))
MDS Header
...0 0000 1000 0010 = Packet Len: 130
.... 0000 0000 00.. = Dst Index: 0x0000
.... ..01 0010 0000 = Src Index: 0x0120
.... 0000 0000 0001 = VSAN: 1
MDS Trailer
EOF: Unknown (0)
CRC: 0xdeadbeef
Fibre Channel
R_CTL: 0x20(Extended Link Services/0x0)
Dest Addr: ff.fa.01
CS_CTL: 0x00
Src Addr: ff.fa.01
Type: Ext Link Svc (0x01)
F_CTL: 0x000000 Exchange Originator, Seq Initiator, CS_CTL, Last Data Frame
- No Info, ABTS - Abort/MS,
0... .... .... .... .... .... = ExgRpd: Exchange Originator
.0.. .... .... .... .... .... = SeqRec: Seq Initiator
..0. .... .... .... .... .... = ExgFst: NOT exchg first
...0 .... .... .... .... .... = ExgLst: NOT exchg last
.... 0... .... .... .... .... = SeqLst: NOT seq last
.... ..0. .... .... .... .... = Pri: CS_CTL
.... ...0 .... .... .... .... = TSI: NOT transfer seq initiative
.... .... 00.. .... .... .... = LDF: Last Data Frame - No Info (0x000000
)
.... .... ..00 .... .... .... = A01: no ack required (0x000000)
.... .... .... ..0. .... .... = RetSeq: NOT retransmitted sequence
.... .... .... .... ..00 .... = AA: ABTS - Cont (0x000000)
.... .... .... .... .... 0... = RelOff: rel offset NOT set
SEQ_ID: 0x00
DF_CTL: 0x00
SEQ_CNT: 0
OX_ID: 0xffff
RX_ID: 0xffff
Parameter: 0x00000000
Data (106 bytes)
0000 01 00 00 00 00 00 04 1a 00 00 00 34 19 a0 be 60 ...........4...`
0010 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................
0020 00 ff fa 01 00 ff fa 01 00 00 09 96 00 00 00 00 ................
0030 00 00 00 04 00 00 00 02 00 00 00 00 01 00 00 00 ................
0040 ff ff ff ff 00 1c c0 00 c1 24 50 6e 4d aa 55 a6 .........$PnM.U.
0050 19 81 9c d3 6d b2 58 34 8a 30 6a e6 d6 cf 31 ff ....m.X4.0j...1.
0060 ca cd 83 0e 00 00 de ad be ef ..........
switch#
The following example shows how to use capture filter on the mgmt
interface and redirect the console output to a file:
switch# fcanalyzer local interface mgmt capture-filter "arp" > mgmt_capture.txt
Capturing on mgmt interface
switch#