create mirror

create mirror mirror_name {to [port port | port-list port_list loopback-port port] { remote-tag rtag } | remote-ip remote_ip_address {{ vr } {vr_name } {from [ source_ip_address | auto-source-ip]}{ping-check [on | off]}]} {description mirror-desc}

Description

Creates a named mirror instance with an optional description, and optional "to port" definition, or remote IP address destination.

Syntax Description

mirror_name Specifies the mirror name.
port Specifies the mirror output port.
port_list Specifies the list of ports where traffic is to be mirrored.
loopback-port Specifies an otherwise unused port required when mirroring to a port_list. The loopback-port is not available for switching user data traffic.
port Specifies a single loopback port that is used internally to provide this feature.
remote-tag Specifies the value of the VLAN (Virtual LAN) ID used by the mirrored packets when egressing the monitor port.
description Specifies a description of the named mirror instance.
mirror-desc The specified mirror description.
remote-ip Specifies to send mirrored packets to specified remote destination IP address.
remote_ip_address Specifies the destination remote IP address for mirrored packets.
vr Specifies a virtual router of the remote IP address.
vr_name Specifies the virtual router name. If not specified, VR of current command context is used.
from Configures source IP address of encapsulated mirrored packets.
source_ip_address Specifies the local source IPv4 address for encapsulated mirrored packets.
auto-source-ip Automatically use source IP address of egress VLAN to be used to reach remote IP address.
ping-check Configure ping health check for remote IP address.
on Only send mirrored packets to remote IP address if periodic pings to remote IP address are successful (default).
off Send mirrored packets to remote IP address without any ping health check, assuming MAC address and port of next hop IP address are static or learned.

Default

Disabled.

Ping health check of the remote IP address is enabled unless otherwise specified.

If a VR is not specified, the VR of the current command context is used.

Usage Guidelines

Use this command to create a named mirror instance with an optional description and optional "to port" or remote IP address definitions. You can create 15 named instances (the instance "DefaultMirror" is created automatically).

Example

The following example creates a mirror instance on port 3, slot 4 :

create mirror to port 3:4

History

This command was first available in ExtremeXOS 15.3.

The remote IP address option was added in ExtremeXOS 22.4.

Platform Availability

This command is available on the Summit X450-G2, X460-G2, X670-G2, X770, and ExtremeSwitching X440-G2, X590, X620, X690, X870 series switches.