16.3. ERSPAN TUNNEL Commands

16.3.1. interface

Command Purpose

Using this command to create a new tunnel interface. Use the no form of this command to destroy the tunnel interface.

Prerequisites

Platform

Software

License

Comments

AQ-N3000

7.0

Base

AQ-N5000

7.0

Base

AQ-N6000

7.0

Base

Command Syntax

interface tunnel TUNNEL_ID

no interface tunnel TUNNEL_ID

Parameter

Parameter Description

Parameter Value

TUNNEL_ID

tunnel id

0-1023

Command Mode

Global Config

Default

None

Usage

None

Examples

Switch# configure terminal
Switch(config)# interface tunnel 1

16.3.2. tunnel mode erspan

Command Purpose

This cammad is used for specifying the IPv4 transition tunnel protocol of erspan, and the no form of this command can unset the tunnel protocol.

Prerequisites

Platform

Software

License

Comments

AQ-N3000

7.0

Base

AQ-N5000

7.0

Base

AQ-N6000

7.0

Base

Command Syntax

tunnel mode ( erspan ( ecmp-dst-gre | ) )

no tunnel mode

Parameter

Parameter Description

Parameter Value

erspan

The tunnel mode is erspan, it has only one tunnel destination .Now, it supports IPv4 erspan tunnel, the playload packet should be IPv4 packet.

-

erspan ecmp-dst-gre

The tunnel mode is erspan, it has a certain of tunnel destinations,.Now, it supports IPv4 erspan tunnel, the playload packet should be IPv4 packet.

-

Command Mode

Interface Configuration

Default

None

Usage

When configure the tunnel mode with erspan, and then it is required configure tunnel source and tunnel destination manually.

Examples

When configure the tunnel mode with erspan, and then it is required configure tunnel source and tunnel destination manually. :

Switch# configure terminal
Switch(config)# interface tunnel 1
Switch(config-if)# tunnel mode erspan

Related Commands

tunnel source

tunnel destination

16.3.3. tunnel source

Command Purpose

This command is used to specify the tunnel source. Use the no form of this command to unset the tunnel source.

Prerequisites

Platform

Software

License

Comments

AQ-N3000

7.0

Base

AQ-N5000

7.0

Base

AQ-N6000

7.0

Base

Command Syntax

tunnel source ( IP_ADDR | IFNAME )

no tunnel source

Parameter

Parameter Description

Parameter Value

IP_ADDR

specify a tunnel source in the IPv4 address format

IPv4 Address

IFNAME

specify a tunnel source in the IFNAME format, the IFNAME should be layer3 interface, like routed port, vlan interface, loopback…

Support physical/aggregation/loopback/vlan ports

Command Mode

Interface Configuration

Default

None

Usage

None

Examples

Switch# configure terminal
Switch(config)# interface tunnel 1
Switch(config-if)# tunnel source 3.3.3.3

Related Commands

tunnel mode erspan

tunnel destination

16.3.4. tunnel destination

Command Purpose

Use this command to specify a tunnel destination address in an IPv4 portion. Use the no parameter to un-specify the address.

Prerequisites

Platform

Software

License

Comments

AQ-N3000

7.0

Base

AQ-N5000

7.0

Base

AQ-N6000

7.0

Base

Command Syntax

tunnel destination IP_ADDR

no tunnel destination

Parameter

Parameter Description

Parameter Value

IP_ADDR

Specify the tunnel destination IPv4 address

IPv4 Address

Command Mode

Interface Configuration

Default

None

Usage

None

Examples

Switch# configure terminal
Switch(config)# interface tunnel 1
Switch(config-if)# tunnel mode erspan
Switch(config-if)# tunnel destination 4.4.4.4

Related Commands

tunnel source

tunnel mode erspan

16.3.5. tunnel ecmp-destination

Command Purpose

Use this command to specify tunnel ecmp-destination address in an IPv4 portion. Use the no parameter to un-specify the address.

Prerequisites

Platform

Software

License

Comments

AQ-N3000

7.0

Base

AQ-N5000

7.0

Base

AQ-N6000

7.0

Base

Command Syntax

tunnel ecmp-destination IP_ADDR

no tunnel ecmp-destination IP_ADDR

no tunnel ecmp-destination all

Parameter

Parameter Description

Parameter Value

IP_ADDR

tunnel ecmp-destination address

-

Command Mode

Interface Configuration

Default

None

Usage

None

Examples

This example shows how to set the tunnel ecmp-destination :

Switch# configure terminal
Switch(config)# interface eth-0-1
Switch(config-if)# interface tunnel 1 
Switch(config-if)# tunnel mode erspan ecmp-dst-gre
Switch(config-if)# tunnel ecmp-destination 3.3.3.3
Switch(config-if)# tunnel ecmp-destination 4.4.4.4

Related Commands

tunnel source

tunnel mode erspan ecmp-dst-gre

16.3.6. tunnel gre key

Command Purpose

Use this command to set the key of erspan tunnel. Use the no form of this command to unset the key of erspan tunnel.

Prerequisites

Platform

Software

License

Comments

AQ-N3000

7.0

Base

AQ-N5000

7.0

Base

AQ-N6000

7.0

Base

Command Syntax

tunnel gre key KEY_VALUE

no tunnel gre key

Parameter

Parameter Description

Parameter Value

KEY_VALUE

gre key value

1-4294967295

Command Mode

Interface Configuration

Default

None

Usage

None

Examples

Switch# configure terminal
Switch(config)# interface eth-0-1
Switch(config-if)# interface tunnel 1 
Switch(config-if)# tunnel gre key 666

Related Commands

tunnel source

16.3.7. tunnel dscp

Command Purpose

Use this command to specify a value of Differentiated Services Code Point (DSCP) in the tunnel IPv4 encapsulation header. Use the no parameter to inheriting the underlying physical interface value by default.

Prerequisites

Platform

Software

License

Comments

AQ-N3000

7.0

Base

AQ-N5000

7.0

Base

AQ-N6000

7.0

Base

Command Syntax

tunnel dscp DSCP

no tunnel dscp

Parameter

Parameter Description

Parameter Value

DSCP

The outer IPv4 header DSCP value

0-63

Command Mode

Interface Configuration

Default

None

Usage

None

Examples

Switch# configure terminal
Switch(config)# interface tunnel 1
Switch(config-if)# tunnel dscp 40

Related Commands

interface

16.3.8. tunnel ttl

Command Purpose

set this command to specify a value of time to live (ttl) in the tunnel IPv4 encapsulation header. Use the no parameter to inheriting the underlying physical interface value by default.

Prerequisites

Platform

Software

License

Comments

AQ-N3000

7.0

Base

AQ-N5000

7.0

Base

AQ-N6000

7.0

Base

Command Syntax

tunnel ttl TTL

no tunnel ttl

Parameter

Parameter Description

Parameter Value

TTL

The outer IPv4 header ttl value

1-254

Command Mode

Interface Configuration

Default

64

Usage

None

Examples

This example shows how to set the outer IPv4 header ttl value as 40.:

Switch# configure terminal
Switch(config)# interface tunnel 1
Switch(config-if)# tunnel ttl 40

Related Commands

interface

16.3.9. tunnel extend-header

Command Purpose

Use this command to set the extend-header information in erspan.

Prerequisites

Platform

Software

License

Comments

AQ-N3000

7.0

Base

AQ-N5000

7.0

Base

AQ-N6000

7.0

Base

Command Syntax

tunnel extend-header

no tunnel extend-header

Command Mode

Interface Configuration

Default

None

Usage

None

Examples

This example shows how to set extend-header in erspan mode:

Switch# configure terminal
Switch(config)# interface tunnel 1
Switch(config-if)# tunnel extend-header

Related Commands

tunnel extend-header id

16.3.10. tunnel extend-header id

Command Purpose

Use this command to set the extend-header id in erspan.Use the no form of this command can unset extend-header id in erspan

Prerequisites

Platform

Software

License

Comments

AQ-N3000

7.0

Base

AQ-N5000

7.0

Base

AQ-N6000

7.0

Base

Command Syntax

tunnel extend-header id ID

no tunnel extend-header id

Parameter

Parameter Description

Parameter Value

ID

The extend-header id

1-1023

Command Mode

Interface Configuration

Default

None.

Usage

You must configure the tunnel extend-header before setting the extend-header id.

Examples

This example shows how to set extend-header id in erspan mode:

Switch# configure terminal
Switch(config)# interface tunnel 1
Switch(config-if)# tunnel extend-header
Switch(config-if)# tunnel extend-header id 1

Related Commands

tunnel extend-header

16.3.11. tunnel extend-header dst-load-balance

Command Purpose

Use this command to set the extend-header dst-load-balance in erspan.Use the no form of this command can unset extend-header dst-load-balance in erspan

Prerequisites

Platform

Software

License

Comments

AQ-N3000

7.0

Base

AQ-N5000

7.0

Base

AQ-N6000

7.0

Base

Command Syntax

tunnel extend-header dst-load-balance

no tunnel extend-header dst-load-balance

Command Mode

Interface Configuration

Default

None.

Usage

None

Examples

This example shows how to set extend-header dst-load-balance in erspan mode:

Switch# configure terminal
Switch(config)# interface tunnel 1
Switch(config-if)# tunnel extend-header
Switch(config-if)# tunnel extend-header dst-load-balance

Related Commands

tunnel extend-header

16.3.12. show resource tunnel

Command Purpose

Use this command to show the resource usage of the tunnel.

Prerequisites

Platform

Software

License

Comments

AQ-N3000

7.0

Base

AQ-N5000

7.0

Base

AQ-N6000

7.0

Base

Command Syntax

show resource tunnel

Command Mode

Privileged EXEC

Default

None

Usage

None

Examples

Switch# show resource tunnel

Tunnel
Resource                         Used          Capability
=============================================================
Peers                            3             8

Related Commands

None