tools system command descriptions

virtual-fabric

Syntax

  • virtual-fabric [control | data] detail [statistics] [vm vm-id]]
  • virtual-fabric override-csf

Context

  • [Tree] tools dump system virtual-fabric

Description

This command displays virtual fabric health-related information.

Parameters

control
specifies to display CSF information
data
specifies to display DSF information
detail
specifies to display more information for the specified VM
Note: The detail keyword can be used with or without the vm parameter.
statistics
requests to display switch fabric statistics for the specified VM, or for all VMs
Note: The statistics keyword must be used with the detail keyword.
vm-id
specifies the ID of the VM for which information is to be displayed
  • Values: 1 to 20 | A | B
Note: The vm parameter can only be used in conjunction with the detail keyword.
override-csf
specifies to display the CSF override status

Output

The following output examples show virtual fabric health information.

Virtual fabric health information

# tools dump system virtual-fabric 

  Data Fabric-1
                         VM-ID TX
       0 0 0 0 0 0 0 0 0 1 1 1 1 1 1 1 1 1 1 2
       1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 A B
       - - - - - - - - - - - - - - - - - - - - - -
   01| - * 3 2 2 1 1 3 2 1 2 1 2 2 2 2 2 2 * * 2 2
   02| * - * * * * * * * * * * * * * * * * * * * *
   03| 2 * - 2 2 1 1 2 2 1 2 1 2 2 2 2 1 2 * * 2 2
   04| 2 * 1 - 2 1 1 2 2 1 2 1 2 2 2 2 2 2 * * 2 2
   05| 2 * 1 2 - 1 1 2 2 1 2 1 2 2 2 1 1 2 * * 2 2
V  06| 2 * 1 2 2 - 1 2 2 1 2 1 2 2 2 2 1 2 * * 2 2
M  07| 2 * 1 2 2 1 - 2 2 1 2 3 2 2 2 1 1 2 * * 2 2
-  08| 2 * 1 2 2 1 1 - 2 1 2 1 2 2 2 1 2 2 * * 2 2
I  09| 2 * 1 2 2 1 1 2 - 1 2 1 2 2 2 2 2 2 * * 2 2
D  10| 2 * 1 2 2 2 1 2 2 - 2 1 2 2 2 1 2 2 * * 2 2
   11| 2 * 1 2 2 1 1 2 2 1 - 1 2 2 3 1 2 2 * * 2 2
R  12| 2 * 1 2 2 1 1 2 2 1 2 - 2 2 2 1 1 2 * * 2 2
X  13| 2 * 1 2 2 1 1 2 2 1 2 1 - 2 2 1 1 2 * * 2 2
   14| 2 * 1 2 2 2 1 2 2 1 2 1 2 - 2 1 1 2 * * 2 2
   15| 2 * 1 2 2 1 1 2 2 1 2 1 2 2 - 1 2 2 * * 2 2
   16| 2 * 1 2 2 2 1 2 2 1 2 1 2 2 2 - 1 2 * * 2 2
   17| 2 * 1 2 2 1 1 2 2 1 2 1 2 2 2 1 - 2 * * 2 2
   18| 2 * 1 2 2 1 1 2 2 1 2 1 2 2 2 1 2 - * * 2 2
   19| * * * * * * * * * * * * * * * * * * - * * *
   20| * * * * * * * * * * * * * * * * * * * - * *
    A| 2 * 2 2 2 1 1 2 2 1 2 1 2 2 2 1 2 2 * * - 2
    B| 2 * 1 2 2 1 1 2 2 2 2 1 2 2 2 2 2 2 * * 2 -
...

  Data Fabric-2
                        VM-ID
       0 0 0 0 0 0 0 0 0 1 1 1 1 1 1 1 1 1 1 2
       1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0
       - - - - - - - - - - - - - - - - - - - -
   01| - * * * * * * * * * * * * * * * * * * *
   02| * - * * * * * * * * * * * * * * * * * *
   03| * * - * * * * * * * * * * * * * * * * *
   04| * * * - * * * * * * * * * * * * * * * *
   05| * * * * - * * * * * * * * * * * * * * *
   06| * * * * * - * * * * * * * * * * * * * *
 V 07| * * * * * * - * * * * * * * * * * * * *
 M 08| * * * * * * * - * * * * * * * * * * * *
 - 09| * * * * * * * * - * * * * * * * * * * *
 I 10| * * * * * * * * * - * * * * * * * * * *
 D 11| * * * * * * * * * * - * * * * * * * * *
   12| * * * * * * * * * * * - * * * * * * * *
   13| * * * * * * * * * * * * - * * * * * * *
   14| * * * * * * * * * * * * * - * * * * * *
   15| * * * * * * * * * * * * * * - * * * * *
   16| * * * * * * * * * * * * * * * - * * * *
   17| * * * * * * * * * * * * * * * * - * * *
   18| * * * * * * * * * * * * * * * * * - * *
   19| * * * * * * * * * * * * * * * * * * - *
   20| * * * * * * * * * * * * * * * * * * * -

  Control Fabric
                          VM-ID
       0 0 0 0 0 0 0 0 0 1 1 1 1 1 1 1 1 1 1 2
       1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 A B
       - - - - - - - - - - - - - - - - - - - - - -
   01| - 2 2 3 * * * * * * * * * * * * * * * * 1 2
   02| 2 - 2 3 * * * * * * * * * * * * * * * * 1 2
   03| 1 2 - 3 * * * * * * * * * * * * * * * * 2 2
   04| 1 2 2 - * * * * * * * * * * * * * * * * 2 2
   05| * * * * - * * * * * * * * * * * * * * * * *
   06| * * * * * - * * * * * * * * * * * * * * * *
   07| * * * * * * - * * * * * * * * * * * * * * *
 V 08| * * * * * * * - * * * * * * * * * * * * * *
 M 09| * * * * * * * * - * * * * * * * * * * * * *
 - 10| * * * * * * * * * - * * * * * * * * * * * *
 I 11| * * * * * * * * * * - * * * * * * * * * * *
 D 12| * * * * * * * * * * * - * * * * * * * * * *
   13| * * * * * * * * * * * * - * * * * * * * * *
   14| * * * * * * * * * * * * * - * * * * * * * *
   15| * * * * * * * * * * * * * * - * * * * * * *
   16| * * * * * * * * * * * * * * * - * * * * * *
   17| * * * * * * * * * * * * * * * * - * * * * *
   18| * * * * * * * * * * * * * * * * * - * * * *
   19| * * * * * * * * * * * * * * * * * * - * * *
   20| * * * * * * * * * * * * * * * * * * * - * *
    A| 1 2 1 3 * * * * * * * * * * * * * * * * - 2
    B| 1 2 1 3 * * * * * * * * * * * * * * * * 1 -

10 s discovery packet RX peak jitter.
  '-'  same vm-id    '*'  no data     '6'  >= 1 s
  '5'  >= 100 ms     '4'  >= 10 ms    '3'  >= 1 ms
  '2'  >= 100 us     '1'  >= 10 us    '0'  >= 1 us
Note:
  • This example shows the virtual fabric connection status after a scale-in operation.
  • Each row of the matrix represents the VM-specific view of the other VMs.
  • An asterisk (*) means that data is not available, including when a card is not present or has failed.

Virtual fabric detail health information

# tools dump system virtual-fabric detail

  10 s discovery packet RX peak jitter, by VM-ID and source VM-ID, us
 
 Data Fabric-1
  01 <==  02----- 03----- 04-----
              292      86    1482
  02 <==  01----- 03----- 04-----
               85      83    1510
  03 <==  01----- 02----- 04-----
               71     279    1551
  04 <==  01----- 02----- 03-----
               51     282      81

  10 s discovery packet RX average jitter, by VM-ID and source VM-ID, us
 
 Data Fabric-1
  01 <==  02----- 03----- 04-----
               44      22      65
  02 <==  01----- 03----- 04-----
               19      27      64
  03 <==  01----- 02----- 04-----
               18      42      67
  04 <==  01----- 02----- 03-----
               18      44      25

  Time since the most recently lost discovery packets
  (as of Thu Apr 11 10:11:36 UTC 2019)

  Control Fabric
VM-ID
01 ->  B:   22:23:30  22:23:30  22:23:30  22:23:30  22:23:30  22:23:30
                       22:23:30  22:23:20  22:23:20  22:23:20
02 ->  B:   22:23:30  22:23:30  22:23:30  22:23:30  22:23:30  22:23:30
                       22:23:30  22:23:20  22:23:20  22:23:20
03 ->  B:   22:23:30  22:23:30  22:23:30  22:23:30  22:23:30  22:23:30
                       22:23:30  22:23:20  22:23:20  22:23:20
04 ->  B:   22:23:30  22:23:30  22:23:30  22:23:30  22:23:30  22:23:30
                       22:23:30  22:23:20  22:23:20  22:23:20
 A ->  B:   22:23:30  22:23:30  22:23:30  22:23:30  22:23:30  22:23:30
                       22:23:30  22:23:30  22:23:20  22:23:20
 
 10 s discovery packet RX peak jitter, by VM-ID and source VM-ID, us

  Control Fabric
  01 <==  02----- 03----- 04-----  A-----  B-----
              320      63    1497      89     146
  02 <==  01----- 03----- 04-----  A-----  B-----
               88      87    1524      90      98
  03 <==  01----- 02----- 04-----  A-----  B-----
               76     292    1498     121     108
  04 <==  01----- 02----- 03-----  A-----  B-----
               87     328      88      89     178
   A <==  01----- 02----- 03----- 04-----  B-----
              391     318      81    1466    1504
   B <==  01----- 02----- 03----- 04-----  A-----
               78     877      96    1461      78
 
 10 s discovery packet RX average jitter, by VM-ID and source VM-ID, us

  Control Fabric
  01 <==  02----- 03----- 04-----  A-----  B-----
               44      22      65      25      29
  02 <==  01----- 03----- 04-----  A-----  B-----
               22      27      70      29      32
  03 <==  01----- 02----- 04-----  A-----  B-----
               26      51      67      28      30
  04 <==  01----- 02----- 03-----  A-----  B-----
               22      44      27      24      33
   A <==  01----- 02----- 03----- 04-----  B-----
               28      45      27      58     115
   B <==  01----- 02----- 03----- 04-----  A-----
               26      66      24      66      21

Virtual fabric detail VM health information (VM 1)

# tools dump system virtual-fabric detail vm 1

  10 s discovery packet RX peak jitter, by VM-ID and source VM-ID, us

  Data Fabric-1
  01 <==  02----- 03----- 04-----
              349     211      76

  10 s discovery packet RX average jitter, by VM-ID and source VM-ID, us

  Data Fabric-1
  01 <==  02----- 03----- 04-----
               42      32      22

  10 s discovery packet RX peak jitter, by VM-ID and source VM-ID, us

  Control Fabric
  01 <==  02----- 03----- 04-----  A-----  B-----
              341     133      90      76     116
 
 10 s discovery packet RX average jitter, by VM-ID and source VM-ID, us

  Control Fabric
  01 <==  02----- 03----- 04-----  A-----  B-----
               45      35      28      23      28

Virtual fabric detail VM health information (VM B)


# tools dump system virtual-fabric detail vm "B"

  10 s discovery packet RX peak jitter, by VM-ID and source VM-ID, us

  10 s discovery packet RX average jitter, by VM-ID and source VM-ID, us

  Control Fabric
VM-ID
01 ->  B:   22:24:20  22:24:20  22:24:20  22:24:20  22:24:20  22:24:20
                       22:24:20  22:24:20  22:24:20  22:24:20
02 ->  B:   22:24:20  22:24:20  22:24:20  22:24:20  22:24:20  22:24:20
                       22:24:20  22:24:20  22:24:20  22:24:20
03 ->  B:   22:24:20  22:24:20  22:24:20  22:24:20  22:24:20  22:24:20
                       22:24:20  22:24:20  22:24:20  22:24:20
04 ->  B:   22:24:20  22:24:20  22:24:20  22:24:20  22:24:20  22:24:20
                       22:24:20  22:24:20  22:24:20  22:24:20
 A ->  B:   22:24:20  22:24:20  22:24:20  22:24:20  22:24:20  22:24:20
                       22:24:20  22:24:20  22:24:20  22:24:20

  10 s discovery packet RX peak jitter, by VM-ID and source VM-ID, us

  Control Fabric
   B <==  01----- 02----- 03----- 04-----  A-----
               86     290      97     128      81

  10 s discovery packet RX average jitter, by VM-ID and source VM-ID, us

  Control Fabric
   B <==  01----- 02----- 03----- 04-----  A-----
               23      41      24      30      25

Virtual fabric detail VM health information (statistics)

# tools dump system virtual-fabric control detail statistics vm 3
...
  Statistics for Control Fabric-1 at VM-ID 03:
      RX error:          0
  RX discarded:        219
       RX ICMP:          0
      TX error:          0
  TX discarded:          0
       TX ICMP:          0
  Breakdown of RX discards by cause:
           0  The packet has an invalid/inconsistent length
           4  The packet has an invalid/unsupported Ethertype
           0  The packet has an invalid 802.1Q TPID
           0  The packet has an invalid 802.1Q VLAN ID
           0  The source slot (VM) in the swFab header is invalid
           0  The length of the swFab message is invalid/inconsistent
           0  The swFab message type is invalid
           0  The CF is down (seen on DF ports)
           0  This VM is not registered with the OAM VM's
           0  The next-hop MAC for the intended destination slot (VM) is unknown
           0  Some value in the IP header is not valid
           0  The destination address in the IP header is not valid
           0  The stated IP protocol is not valid
           0  The L3 swFab packet is an IP fragment
           0  Some value in the UDP header is not valid
         215  The VM is not fully up
           0  The VM has been locked out
           0  The stated destination tap is not valid
           0  Reassembly context not found
           0  Timeout during reassembly
  Discovery packet RX KPIs, current and previous periods
  Control Fabric-1
=========================================================
                     packets lost        peak jitter, us
  VM-ID           current  previous     current  previous
---------------------------------------------------------
  03                    0         0       10857         0
========================================================= 

Control fabric override status

# tools dump system virtual-fabric override-csf
Control fabric override status
==================================================
VM-ID   active fabric   duration, s   remains, s
--------------------------------------------------
01                  2            10            5
02                  2            10            5
03                  2            10            5
04                  2            10            5
 A                  2            10            5
 B                  2            10            5