30. mirror Commands

configure
mirror
— apply-groups reference
— apply-groups-exclude reference
mirror-dest string
admin-state keyword
— apply-groups reference
— apply-groups-exclude reference
description string
encap
— apply-groups reference
— apply-groups-exclude reference
direction-bit boolean
gateway
— apply-groups reference
— apply-groups-exclude reference
destination string
source string
destination number
source number
header-type keyword
router-instance string
endpoint string
— apply-groups reference
— apply-groups-exclude reference
description string
revert-time (number | keyword)
fc keyword
include-port-id boolean
pcap string
— apply-groups reference
— apply-groups-exclude reference
file-url string
far-end string
— apply-groups reference
— apply-groups-exclude reference
icb boolean
ing-vc-label number
label-signaling keyword
vc-id number
spoke-sdp string
admin-state keyword
— apply-groups reference
— apply-groups-exclude reference
control-word boolean
egress
vc-label number
icb boolean
name reference
ingress
l2tpv3
cookie
cookie1 string
cookie2 string
vc-label number
sampling-rate number
sap string
— apply-groups reference
— apply-groups-exclude reference
egress
mac
destination string
source string
qos
policy-name reference
group-name reference
instance number
endpoint reference
service-id number
slice-size number
spoke-sdp string
admin-state keyword
— apply-groups reference
— apply-groups-exclude reference
control-word boolean
egress
l2tpv3
cookie string
vc-label number
icb boolean
name reference
precedence (number | keyword)
ingress
vc-label number
type keyword
mirror-source string
admin-state keyword
— apply-groups reference
— apply-groups-exclude reference
ip-filter reference
— apply-groups reference
— apply-groups-exclude reference
entry number
ipv6-filter reference
— apply-groups reference
— apply-groups-exclude reference
entry number
mac-filter reference
— apply-groups reference
— apply-groups-exclude reference
entry number
port string
— apply-groups reference
— apply-groups-exclude reference
egress boolean
ingress boolean
sap string
— apply-groups reference
— apply-groups-exclude reference
egress boolean
ingress boolean
subscriber string
— apply-groups reference
— apply-groups-exclude reference
egress boolean
fc keyword
host-type keyword
ingress boolean
ip-address string
ip-family keyword
mac-address string
sap-id string
sla-profile string

30.1. mirror Command Descriptions

mirror

Synopsis

Enter the mirror context

Context
Tree
Introduced

16.0.R1

Platforms

All

mirror-dest [service-name] string

Synopsis

Enter the mirror-dest list instance

Context
Max. Elements

255

Introduced

16.0.R1

Platforms

All

[service-name] string

Synopsis

Administrative service name

Context
String Length

1 to 64

Notes

This element is part of a list key.

Introduced

16.0.R1

Platforms

All

admin-state keyword

Synopsis

Administrative state of the mirror destination service

Context
Default

disable

Options

enable, disable

Introduced

16.0.R1

Platforms

All

description string

Synopsis

Text description

Context
String Length

1 to 80

Introduced

16.0.R1

Platforms

All

encap

Synopsis

Enter the encap context

Tree
Introduced

16.0.R1

Platforms

All

layer-3-encap

Synopsis

Enable the layer-3-encap context

Introduced

16.0.R1

Platforms

All

direction-bit boolean

Synopsis

Highest bit in Interception ID of shim header to show direction of mirrored traffic flow

Default

false

Introduced

16.0.R1

Platforms

All

gateway

Synopsis

Enable the gateway context

Tree
Introduced

16.0.R1

Platforms

All

ip-address

Synopsis

Enter the ip-address context

Introduced

16.0.R1

Platforms

All

destination string

Synopsis

IPv4 destination address for the gateway

Introduced

16.0.R1

Platforms

All

source string

Synopsis

IPv4 source address for the gateway

Tree
Introduced

16.0.R1

Platforms

All

udp-port

Synopsis

Enter the udp-port context

Tree
Introduced

16.0.R1

Platforms

All

destination number

Synopsis

UDP destination port to use with this gateway

Range

0 | 1 to 65535

Default

0

Introduced

16.0.R1

Platforms

All

source number

Synopsis

UDP source port with this gateway

Tree
Range

0 | 1 to 65535

Default

0

Introduced

16.0.R1

Platforms

All

header-type keyword

Warning:

Modifying this element recreates the parent element automatically for the new value to take effect.

Synopsis

Header for the Layer 3 encapsulation

Options

ip-udp-shim, ip-gre, ip-udp-shim-sampled

Notes

This element is mandatory.

Introduced

16.0.R1

Platforms

All

router-instance string

Synopsis

Router instance to use with routed encapsulation

Default

Base

Introduced

16.0.R1

Platforms

All

endpoint [name] string

Synopsis

Enter the endpoint list instance

Context
Tree
Max. Elements

2

Introduced

16.0.R1

Platforms

All

[name] string

Synopsis

Service endpoint name

Context
String Length

1 to 32

Notes

This element is part of a list key.

Introduced

16.0.R1

Platforms

All

description string

Synopsis

Text description

Context
String Length

1 to 80

Introduced

16.0.R1

Platforms

All

revert-time (number | keyword)

Synopsis

Time before reverting back to primary spoke SDP defined after failing in backup spoke SDP

Context

configure mirror mirror-dest string endpoint string revert-time (number | keyword)

Range

1 to 600

Default

immediate

Options

never, immediate

Introduced

16.0.R1

Platforms

All

fc keyword

Synopsis

Forwarding class for destination traffic

Context
Tree
Default

be

Options

be, l2, af, l1, h2, ef, h1, nc

Introduced

16.0.R1

Platforms

All

include-port-id boolean

Synopsis

Include port ID of the system in the packet

Default

false

Introduced

16.0.R1

Platforms

All

pcap [session-name] string

Synopsis

Enter the pcap list instance

Context
Tree
Max. Elements

1

Introduced

16.0.R1

Platforms

All

[session-name] string

Synopsis

Packet Capture (PCAP) session name

Context
String Length

1 to 32

Notes

This element is part of a list key.

Introduced

16.0.R1

Platforms

All

file-url string

Synopsis

URL and file name for packet capture transfer

Context
Tree
String Length

1 to 180

Introduced

16.0.R1

Platforms

All

remote-source

Synopsis

Enable the remote-source context

Introduced

16.0.R1

Platforms

All

far-end [far-end-addr] string

Synopsis

Enter the far-end list instance

Tree
Introduced

16.0.R1

Platforms

All

[far-end-addr] string

Synopsis

Far end IP address

Notes

This element is part of a list key.

Introduced

16.0.R1

Platforms

All

icb boolean

Synopsis

Remote source as an inter-chassis backup

Context
Tree
Default

false

Introduced

16.0.R1

Platforms

All

ing-vc-label number

Synopsis

Ingress virtual circuit label

Range

32 to 18431

Notes

The following are part of a choice: ing-vc-label or label-signaling.

Introduced

16.0.R1

Platforms

All

label-signaling keyword

Synopsis

Protocol to obtain the ingress labels

Default

tldp

Options

tldp

Notes

This element is the default part of a choice.

The following are part of a choice: ing-vc-label or label-signaling.

Introduced

16.0.R1

Platforms

All

vc-id number

Synopsis

Virtual circuit identifier associated with the remote source

Context
Tree
Range

1 to max

Notes

This element is mandatory.

Introduced

16.0.R1

Platforms

All

spoke-sdp [sdp-bind-id] string

Synopsis

Enter the spoke-sdp list instance

Tree
Introduced

16.0.R1

Platforms

All

[sdp-bind-id] string

Synopsis

SDP Binding identifier.

String Length

3 to 16

Notes

This element is part of a list key.

Introduced

16.0.R1

Platforms

All

admin-state keyword

Synopsis

Administrative state of this Service SDP binding

Default

enable

Options

enable, disable

Introduced

16.0.R1

Platforms

All

control-word boolean

Synopsis

Enable the PW control word on spoke SDPs

Description

When configured to true, this command enables the PW control word on spoke SDPs that are part of a mirror destination. The control word must be enabled to allow MPLS-TP OAM on spoke SDP and is only valid for spoke SDPs that are part of a mirror service of type ether.

When configured to false, this command disables the PW control word.

Default

false

Introduced

16.0.R1

Platforms

All

egress

Synopsis

Enter the egress context

Tree
Introduced

16.0.R1

Platforms

All

vc-label number

Synopsis

Static MPLS VC label that is used to send packets to the far end device through this SDP

Tree
Range

16 to 1048575

Introduced

16.0.R1

Platforms

All

endpoint

Synopsis

Enter the endpoint context

Tree
Introduced

16.0.R1

Platforms

All

icb boolean

Synopsis

Bind SDP as type Inter-Chassis Backup (ICB)

Tree
Default

false

Introduced

16.0.R1

Platforms

All

name reference

Synopsis

Name of endpoint where this SDP bind is attached

Tree
Reference
Introduced

16.0.R1

Platforms

All

ingress

Synopsis

Enter the ingress context

Tree
Introduced

16.0.R1

Platforms

All

l2tpv3

Synopsis

Enter the l2tpv3 context

Tree
Introduced

16.0.R1

Platforms

All

cookie

Synopsis

Enter the cookie context

Tree
Introduced

16.0.R1

Platforms

All

cookie1 string

Synopsis

Value of cookie-1 for the tunnel

Tree
String Length

18 to 23

Introduced

16.0.R1

Platforms

All

cookie2 string

Synopsis

Value of cookie-1 for the tunnel

Tree
String Length

18 to 23

Introduced

16.0.R1

Platforms

All

vc-label number

Synopsis

Static MPLS VC label used by the far end device to send packets through this SDP

Tree
Range

32 to 18431

Introduced

16.0.R1

Platforms

All

sampling-rate number

Synopsis

Sampling rate

Description

This command configures the packet sampling rate value for mirrored traffic and is supported with mirror source configurations. The sampling rate is common to all endpoints on a given line card FP per mirror destination service.

Range

256 to 10000

Introduced

20.7.R1

Platforms

All

sap [sap-id] string

Synopsis

Enter the sap list instance

Context
Tree
Max. Elements

1

Introduced

16.0.R1

Platforms

All

[sap-id] string

Synopsis

SAP identifier

Context
String Length

1 to 45

Notes

This element is part of a list key.

Introduced

16.0.R1

Platforms

All

egress

Synopsis

Enter the egress context

Context
Tree
Introduced

16.0.R1

Platforms

All

ip-mirror

Synopsis

Enter the ip-mirror context

Tree
Introduced

16.0.R1

Platforms

All

mac

Synopsis

Enter the mac context

Tree
Introduced

16.0.R1

Platforms

All

destination string

Synopsis

Destination MAC address.

Introduced

16.0.R1

Platforms

All

source string

Synopsis

Source MAC address.

Context
Tree
Introduced

16.0.R1

Platforms

All

qos

Synopsis

Enter the qos context

Context
Tree
Introduced

16.0.R1

Platforms

All

sap-egress

Synopsis

Enter the sap-egress context

Introduced

16.0.R1

Platforms

All

policy-name reference

Synopsis

Policy identifier

Reference
Introduced

16.0.R1

Platforms

All

port-redirect-group

Synopsis

Enter the port-redirect-group context

Introduced

16.0.R1

Platforms

All

group-name reference

Synopsis

Port redirect queue-group policy

Introduced

16.0.R1

Platforms

All

instance number

Synopsis

Port queue-group instance

Tree
Range

1 to 65535

Introduced

16.0.R1

Platforms

All

endpoint reference

Synopsis

Configure name of the service endpoint.

Context

configure mirror mirror-dest string sap string endpoint reference

Tree
Reference
Introduced

16.0.R1

Platforms

All

service-id number

Warning:

Modifying this element recreates the parent element automatically for the new value to take effect.

Synopsis

Unique service ID; cannot be used by any other service, regardless of service type

Context
Range

1 to 2147483647

Introduced

16.0.R1

Platforms

All

slice-size number

Synopsis

Maximum size of a mirrored frame that can be transmitted to the mirror destination

Context
Range

0 | 128 to 9216

Default

0

Introduced

16.0.R1

Platforms

All

spoke-sdp [sdp-bind-id] string

Synopsis

Enter the spoke-sdp list instance

Context
Tree
Introduced

16.0.R1

Platforms

All

[sdp-bind-id] string

Synopsis

SDP Binding identifier.

Context
String Length

3 to 16

Notes

This element is part of a list key.

Introduced

16.0.R1

Platforms

All

admin-state keyword

Synopsis

Administrative state of this Service SDP binding

Context
Default

enable

Options

enable, disable

Introduced

16.0.R1

Platforms

All

control-word boolean

Synopsis

Enable the PW control word on spoke SDPs

Context
Description

When configured to true, this command enables the PW control word on spoke SDPs that are part of a mirror destination. The control word must be enabled to allow MPLS-TP OAM on spoke SDP and is only valid for spoke SDPs that are part of a mirror service of type ether.

When configured to false, this command disables the PW control word.

Default

false

Introduced

16.0.R1

Platforms

All

egress

Synopsis

Enter the egress context

Tree
Introduced

16.0.R1

Platforms

All

l2tpv3

Synopsis

Enter the l2tpv3 context

Tree
Introduced

16.0.R1

Platforms

All

cookie string

Synopsis

Cookie parameters

Tree
String Length

18 to 23

Introduced

16.0.R1

Platforms

All

vc-label number

Warning:

Modifying this element toggles the admin-state of the parent element automatically for the new value to take effect.

Synopsis

Static MPLS VC label that is used to send packets to the far end device through this SDP

Context
Tree
Range

16 to 1048575

Introduced

16.0.R1

Platforms

All

endpoint

Synopsis

Enter the endpoint context

Tree
Introduced

16.0.R1

Platforms

All

icb boolean

Warning:

Modifying this element toggles the admin-state of the parent element automatically for the new value to take effect.

Synopsis

Bind SDP as type Inter-Chassis Backup (ICB)

Context
Tree
Default

false

Introduced

16.0.R1

Platforms

All

name reference

Synopsis

Name of endpoint where this SDP bind is attached

Context
Tree
Reference
Introduced

16.0.R1

Platforms

All

precedence (number | keyword)

Synopsis

Precedence of this SDP bind when there are multiple SDP binds attached to one service endpoint

Context

configure mirror mirror-dest string spoke-sdp string endpoint precedence (number | keyword)

Range

1 to 4

Default

4

Options

primary

Introduced

16.0.R1

Platforms

All

ingress

Synopsis

Enter the ingress context

Tree
Introduced

16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS

vc-label number

Warning:

Modifying this element toggles the admin-state of the parent element automatically for the new value to take effect.

Synopsis

Static MPLS VC label used by the far end device to send packets through this SDP

Context
Tree
Range

32 to 18431

Introduced

16.0.R1

Platforms

7450 ESS, 7750 SR, 7750 SR-a, 7750 SR-e, 7750 SR-s, 7950 XRS

type keyword

Warning:

Modifying this element recreates the parent element automatically for the new value to take effect.

Synopsis

Mirror type information

Context
Tree
Default

ether

Options

ether, ip-only

Introduced

16.0.R1

Platforms

All

mirror-source [service-name] string

Synopsis

Enter the mirror-source list instance

Introduced

19.10.R1

Platforms

All

[service-name] string

Synopsis

Administrative service name

String Length

1 to 64

Notes

This element is part of a list key.

Introduced

19.10.R1

Platforms

All

admin-state keyword

Synopsis

Enable/disable mirror service.

Context
Default

enable

Options

enable, disable

Introduced

19.10.R1

Platforms

All

ip-filter [filter-name] reference

Synopsis

Enter the ip-filter list instance

Context
Tree
Introduced

19.10.R1

Platforms

All

[filter-name] reference

Synopsis

IP Filter name

Context
Reference
Notes

This element is part of a list key.

Introduced

19.10.R1

Platforms

All

entry [entry-id] number

Synopsis

Add a list entry for entry

Context

configure mirror mirror-source string ip-filter reference entry number

Tree
Min. Elements

1

Introduced

19.10.R1

Platforms

All

[entry-id] number

Synopsis

IP Filter entry identifier

Context

configure mirror mirror-source string ip-filter reference entry number

Range

1 to 2097151

Notes

This element is part of a list key.

Introduced

19.10.R1

Platforms

All

ipv6-filter [filter-name] reference

Synopsis

Enter the ipv6-filter list instance

Context
Introduced

19.10.R1

Platforms

All

[filter-name] reference

Synopsis

IPv6 Filter name

Context
Reference
Notes

This element is part of a list key.

Introduced

19.10.R1

Platforms

All

entry [entry-id] number

Synopsis

Add a list entry for entry

Context
Tree
Min. Elements

1

Introduced

19.10.R1

Platforms

All

[entry-id] number

Synopsis

IPv6 Filter entry identifier

Context
Range

1 to 2097151

Notes

This element is part of a list key.

Introduced

19.10.R1

Platforms

All

mac-filter [filter-name] reference

Synopsis

Enter the mac-filter list instance

Context
Introduced

19.10.R1

Platforms

All

[filter-name] reference

Synopsis

MAC Filter name

Context
Reference
Notes

This element is part of a list key.

Introduced

19.10.R1

Platforms

All

entry [entry-id] number

Synopsis

Add a list entry for entry

Context

configure mirror mirror-source string mac-filter reference entry number

Tree
Min. Elements

1

Introduced

19.10.R1

Platforms

All

[entry-id] number

Synopsis

MAC Filter entry identifier

Context

configure mirror mirror-source string mac-filter reference entry number

Range

1 to 2097151

Notes

This element is part of a list key.

Introduced

19.10.R1

Platforms

All

port [port-id] string

Synopsis

Enter the port list instance

Context
Tree
Introduced

19.10.R1

Platforms

All

[port-id] string

Synopsis

Port identifier.

Context
Notes

This element is part of a list key.

Introduced

19.10.R1

Platforms

All

egress boolean

Synopsis

Whether egress packets will be mirrored or not.

Context

configure mirror mirror-source string port string egress boolean

Tree
Default

false

Introduced

19.10.R1

Platforms

All

ingress boolean

Synopsis

Whether ingress packets will be mirrored or not.

Context

configure mirror mirror-source string port string ingress boolean

Tree
Default

false

Introduced

19.10.R1

Platforms

All

sap [sap-id] string

Synopsis

Enter the sap list instance

Context
Tree
Introduced

19.10.R1

Platforms

All

[sap-id] string

Synopsis

SAP identifier.

Context
String Length

1 to 45

Notes

This element is part of a list key.

Introduced

19.10.R1

Platforms

All

egress boolean

Synopsis

Whether egress packets will be mirrored or not.

Context

configure mirror mirror-source string sap string egress boolean

Tree
Default

false

Introduced

19.10.R1

Platforms

All

ingress boolean

Synopsis

Whether ingress packets will be mirrored or not.

Context

configure mirror mirror-source string sap string ingress boolean

Tree
Default

false

Introduced

19.10.R1

Platforms

All

subscriber [subscriber-id] string

Synopsis

Enter the subscriber list instance

Context
Introduced

19.10.R1

Platforms

All

[subscriber-id] string

Synopsis

Subscriber Identifier

Context
String Length

1 to 64

Notes

This element is part of a list key.

Introduced

19.10.R1

Platforms

All

egress boolean

Synopsis

Whether egress packets will be mirrored or not.

Context
Tree
Default

false

Introduced

19.10.R1

Platforms

All

fc keyword

Synopsis

The forwarding classes traffic which should be mirrored

Context
Tree
Options

be, l2, af, l1, h2, ef, h1, nc

Max. Elements

8

Introduced

19.10.R1

Platforms

All

host-type keyword

Synopsis

The host type to be mirrored.

Context
Tree
Options

ipoe, ppp

Introduced

19.10.R1

Platforms

All

ingress boolean

Synopsis

Whether ingress packets will be mirrored or not.

Context
Tree
Default

false

Introduced

19.10.R1

Platforms

All

ip-address string

Synopsis

The IP address of the remote source or the far-end ESR which is allowed to be a source of packets.

Context
Notes

The following are part of a choice: (ip-address, mac-address, and sap-id) or sla-profile.

Introduced

19.10.R1

Platforms

All

ip-family keyword

Synopsis

The family of IP flows to be monitored for an IPoE type of host.

Context
Tree
Options

ipv4, ipv6

Introduced

19.10.R1

Platforms

All

mac-address string

Synopsis

The MAC address to be used to match the packets for the subscriber on the mirror source.

Context
Notes

The following are part of a choice: (ip-address, mac-address, and sap-id) or sla-profile.

Introduced

19.10.R1

Platforms

All

sap-id string

Synopsis

Subscriber SAP identifier

Context
Tree
String Length

1 to 45

Notes

The following are part of a choice: (ip-address, mac-address, and sap-id) or sla-profile.

Introduced

19.10.R1

Platforms

All

sla-profile string

Synopsis

The SLA profile Name

Context
String Length

1 to 32

Notes

The following are part of a choice: (ip-address, mac-address, and sap-id) or sla-profile.

Introduced

19.10.R1

Platforms

All