18.2. EFD Commands

Command Purpose

Use this command to enable EFD detect on interface.Use the no form of this command to disable EFD detect on interface.

Prerequisites

Command Syntax

efd enable

no efd enable

Command Mode

Interface Configuration

Default

EFD detect is disabled

Usage

When the rate of the flow is 60 Mbps, this flow shall be a elephant flow.

Examples

This example shows how to enable EFD on the interface:

Switch# configure terminal
Switch(config)# interface eth-0-1
Switch(config-if)# efd enable

Related Commands

None

Command Purpose

Use this command to enable detect EFD with TCP packet.Use the no form of this command to disable detect EFD with TCP.

Prerequisites

Command Syntax

efd tcp-only enable

no efd tcp-only enable

Command Mode

Global Config

Default

All flow will be detect.

Usage

None

Examples

This example shows how to enable EFD on the interface:

Switch# configure terminal
Switch(config)# efd tcp-only enable

Related Commands

None

Command Purpose

Use this command to set traffic class for flow detected as EFD.Use the no form of this command to unset traffic class for flow detected as EFD.

Prerequisites

Command Syntax

efd flow-traffic-class CLASS

no efd flow-traffic-class

Command Mode

Global Config

Default

Disabled

Usage

None

Examples

This example shows how to set flow-traffic-class as 5 for EFD flow:

Switch# configure terminal
Switch(config)# efd flow-traffic-class 5

Related Commands

None

Command Purpose

Use this command to set flow color for flow detected as EFD. Use the no form of this command to unset flow color for flow detected as EFD.

Prerequisites

Command Syntax

efd flow-color (green|red|yellow)

no efd flow-color

Command Mode

Global Config

Default

Disabled

Usage

None

Examples

This example shows how to set flow color as yellow for EFD flow:

Switch# configure terminal
Switch(config)# efd flow-color yellow

Related Commands

None

Command Purpose

Use this command to set speed for flow detected as EFD.

Prerequisites

Command Syntax

efd detect speed SPEED

efd detect speed

Command Mode

Global Config

Default

50 Mbps

Usage

None

Examples

This example shows how to set 60Mbps detect for EFD flow:

Switch# configure terminal
Switch(config)# efd detect speed 60

Related Commands

None

Command Purpose

Use this command to set the granularity of calculate the detect rate.The greater the granularity, the greater the quantized error.

Prerequisites

Command Syntax

efd detect granularity (4B|8B|16B|32B)

Command Mode

Global Config

Default

16B

Usage

(Rate * Interval) > Granularity, the value’s bit is fixed.

Examples

This example shows how to set 32B granularity:

Switch# configure terminal
Switch(config)# efd detect granularity 32B

Related Commands

None

Command Purpose

Use this command to set the the time interval for flow as detected as EFDs.

Prerequisites

Command Syntax

efd detect time-interval INTERVAL

Command Mode

Global Config

Default

30 ms

Usage

None

Examples

This example shows how to set time interval to 100ms:

Switch# configure terminal
Switch(config)# efd detect time-interval 100

Related Commands

None

Command Purpose

Use this command to set flow color for flow detected as EFD. Use the no form of this command to unset flow color for flow detected as EFD.

Prerequisites

Command Syntax

efd detect min-pkt-size SIZE

no efd detect min-pkt-size

Command Mode

Global Config

Default

Disabled

Usage

Unit is byte.

Examples

This example shows how to set elephant flowminimum packet size with 300:

Switch# configure terminal
Switch(config)# efd detect min-pkt-size 300

Related Commands

show efd configuration

Command Purpose

Use this command to set flows detected as EFDs aging period.

Prerequisites

Command Syntax

efd aging-period PERIOD

Command Mode

Global Config

Default

4

Usage

The aging time is the detect rate multiple aging period.

Examples

This example shows how to set aging period to 3:

Switch# configure terminal
Switch(config)# efd aging-period 3

Related Commands

None

Command Purpose

Use this command to redirect the flows detected as EFD to the specified interface.

Prerequisites

Command Syntax

efd redirect to interface IFNAME

Command Mode

Global Config

Default

Disable

Usage

None

Examples

This example shows how to redirect the flows to interface eth-0-2:

Switch# configure terminal
Switch(config)# efd redirect to interface eth-0-2

Related Commands

None

Command Purpose

Use this command to set calculate the detect rate whether use the packet’s ipg.Use the no form of this command to unset calculate the detect rate whether use the packet’s ipg.

Prerequisites

Command Syntax

efd ipg enable

no efd ipg enable

Command Mode

Global Config

Default

Disable

Usage

None

Examples

This example shows how to enable the calculate the detect rate with ipg:

Switch# configure terminal
Switch(config)# efd ipg enable

Related Commands

None

Command Purpose

Use this command to configure EFD notify function.Use the no form of this command to unconfigure EFD notify function.

Prerequisites

Command Syntax

efd notify enable IP_ADDR (PORT | )

no efd notify enable

Command Mode

Global Config

Default

The feature is disabled.

The default UDP port is 20007 if not specifed.

Usage

After EFD notify enabled, the new elephant flow will be notified to server, the format of the data in the UDP packet is:

|—-rsv—- | ver| code|

|———length———–|

|—type—-|——len—-|

|———-value———–|

…

Examples

This example shows how to configure EFD notify:

Switch# configure terminal
Switch(config)# efd notify enable 10.10.10.1

Related Commands

efd enable

efd notify packet

Command Purpose

Use this command to configure EFD notify carry original packet. Use the no form of this command to unconfigure EFD notify carry original packet.

Prerequisites

Command Syntax

efd notify packet

no efd notify packet

Command Mode

Global Config

Default

Disabled

Usage

None

Examples

This example shows how to configure EFD notify carry original packet:

Switch# configure terminal
Switch(config)# efd notify packet

Related Commands

efd enable

efd notify enable

Command Purpose

Use this command to enable EFD black hole route, specify the gateway address and route tag. Use the no form of this command to disable EFD black hole route, unspecify the gateway address and route tag.

Prerequisites

Command Syntax

efd black-hole-route gw IP_ADDR ( |tag TAG_VALUE)

no efd black-hole-route

Command Mode

Global Config

Default

None

Usage

Enable EFD black hole route feature, a black hole route would be created for it when a flow.

is detected as elephant flow, it’s next-hop would be pointed to the configured gateway address.

Examples

This example shows how to enable EFD black hole route:

Switch# efd black-hole-route gw 1.2.3.4 tag 876

Related Commands

show efd bhr information detail

Command Purpose

Use this command to set black hole route aging time. Use the no form fo this command to unset black hole route aging time.

Prerequisites

Command Syntax

efd black-hole-route aging-timer (0|value)

no efd black-hole-route aging-timer (0|VALUE)

Command Mode

Global Config

Default

300

Usage

None

Examples

This example shows how to set aging time:

Switch# efd black-hole-route aging-timer 1000

Related Commands

None

Command Purpose

Use this command to set the efd detect information. Use the no form of this command to unset the efd detect information.

Prerequisites

Command Syntax

efd syslog enable

no efd syslog enable

Command Mode

Global Config

Default

Enable

Usage

None

Examples

This example shows how to set the efd detect information:

Switch# efd syslog enable

Related Commands

None

Command Purpose

Use this command to display the information about efd black hole route.

Prerequisites

Command Syntax

show efd bhr information (detail| )

Command Mode

Privileged EXEC

Default

None

Usage

None

Examples

This example shows how to display the information about efd black hole route:

Switch# show efd bhr information detail 

Elephant flow detection BHR configuration information:
 * BHR - Black Hole Route
--------------------------------------------------
Auto install BHR       : Enabled
BHR gateway            : 1.2.3.4
BHR count              : 1
BHR aging timer        : 300
BHR route tag          : 876
--------------------------
BHR Prefix, Age Time    : 
--------------------------
  12.12.12.2/32, 1 min

Related Commands

efd black-hole-route gw

efd black-hole-route aging-timer

Command Purpose

Use this command to display the configuration of EFD.

Prerequisites

Command Syntax

show efd configuration

Command Mode

Privileged EXEC

Default

None

Usage

None

Examples

This example shows how to display the configuration of EFD:

Switch# show efd configuration 

Elephant flow detection configuration information:
---------------------------------------------------
Detect rate                : 50 Mbps
Detect granularity         : 16B
Detect time interval       : 30 ms
Black-hole-route gateway   : 0.0.0.0
Black-hole-route tag       : 0
Black-hole-route aging time: 0
EFD syslog                 : Enable
EFD aging period           : 4 times
EFD aging time             : 120 ms ~ 150 ms
EFD detect packet type     : All IP packets
EFD IPG                    : disable
EFD redirect interface     : N/A
EFD flow-traffic-class     : N/A
EFD flow-color             : N/A
EFD notify                 : 1.2.3.4 20007
EFD notify packet          : disable
EFD min-pkt-size           : disable
EFD flow hash fields       : source-ip
                             destination-ip
                             ip-protocol
                             layer4-source-port
                             layer4-destination-port
EFD enabled interface     : 
--------------------------- ---------------------------
eth-0-1                   eth-0-9                   
eth-0-10                  agg5        

Related Commands

None

Command Purpose

Use this command to display the EFD flow hardware information.

Prerequisites

Command Syntax

show efd flow table

Command Mode

Privileged EXEC

Default

None

Usage

None

Examples

This example shows how to display the EFD flow hardware information:

Switch# show efd flow table 

Current elelphant flow number is 0, valid bit count is 0
Flow Entry Status:    'V'  --- Valid,      '.'  ---  Not Valid
FlowId        - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
(00)0000~0031 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 
(01)0032~0063 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 
(02)0064~0095 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 
(03)0096~0127 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 
(04)0128~0159 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 
(05)0160~0191 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 
(06)0192~0223 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Related Commands

None

Command Purpose

Use this command to display EFD flow information.

Prerequisites

Command Syntax

show efd flow information

Command Mode

Privileged EXEC

Default

None

Usage

None

Examples

This example shows how to display EFD flow information:

Switch# show efd flow information

Related Commands

None

Command Purpose

Use this command to clear EFD flow information.

Prerequisites

Command Syntax

clear efd flow information

Command Mode

Privileged EXEC

Default

None

Usage

None

Examples

This example shows how to clear EFD flow information:

Switch# clear efd flow information

Related Commands

None