configure mirror to

configure mirror mirror_name {to [port port | port-list port_list | loopback port port] | remote-ip {add} remote_ip_address {{vr} vr_name } {from [source_ip_address | auto-source-ip]} {ping-check [on | off]}] {remote-tag rtag | port none} {priority priority_value}

Description

Updates or specifies the "to port", "to port list", or remote IP address destination definitions for a named mirroring instance.

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 ID used by the mirrored packets when egressing the monitor port.
port Specifies the port definition for the mirroring instance.
none Specifies none for the to port definition.
remote-ip Sends mirrored packets to specified remote destination IP address.
remote_ip_address Specifies the destination remote IP address for mirrored packets.
add Adds a redundant (more than one) remote IP address with a unique priority to a mirror instance.
vr Specifies the 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.
priority Configures a unique priority value for each redundant remote IP address of a mirror instance.
priority_value

Sets a unique priority value for a remote IP address.

The priority value must be unique for each remote IP address in the mirror instance.

The range is from 1 (least preferred) to 100 (most preferred). The default is 50.

Default

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.

The default priority value for multiple redundant IP addresses is 50.

Usage Guidelines

Use this command to update, or specify the "to port", "to port-list", or remote IP address destination definitions for a named mirroring instance.

The none keyword can be used to remove a previously configured port/port-list , or remote IP address on a disabled mirror instance.

For high availability, you can add up to four redundant remote IP addresses. For each mirror instance, the remote IP address with the highest configured priority value that has status “up” is used as the destination IP address for GRE-tunneled mirrored traffic. All other remote IP addresses deemed “up” for that mirror instance are standby—ready to be used in the event the preferred remote IP address becomes “down”. If you are adding another (redundant) remote IP address to an existing mirror that already has a remote IP address configured, you must use the add option.

The remote-ip cannot be the IP from vr-mgmt.

You cannot specify vr-mgmt as VR.

Example

The following example configures a mirror instance to port 3, slot 4:

# configure mirror to port 3:4

The following example configures multiple (redundant) remote IP addresses ("5.1.1.2", "4.1.1.2", "3.1.1.2", "2.1.1.2") for mirror "analytics_chicago_1":

# enable mirror analytics_chicago_1 to remote-ip 5.1.1.2
# configure mirror analytics_chicago_1 to remote-ip add 4.1.1.2 priority 40
# configure mirror analytics_chicago_1 to remote-ip add 3.1.1.2 priority 30
# configure mirror analytics_chicago_1 to remote-ip add 2.1.1.2 priority 20
# configure mirror analytics_chicago_1 add vlan v1

# show mirror
 
analytics_chicago_1   (Enabled)
    Description:   
    Mirror to remote IP: 5.1.1.2            VR        : VR-Default
    From IP            : Auto source IP     Ping check: On
    Priority           : 50
    Status             : Up. Active

    Mirror to remote IP: 4.1.1.2            VR        : VR-Default
    From IP            : Auto source IP     Ping check: On
    Priority           : 40
    Status             : Up. Standby

    Mirror to remote IP: 3.1.1.2            VR        : VR-Default
    From IP            : Auto source IP     Ping check: On
    Priority           : 30
    Status             : Down. Ping timed out

    Mirror to remote IP: 2.1.1.2            VR        : VR-Default
    From IP            : Auto source IP     Ping check: On
    Priority           : 20
    Status             : Up. Standby
    Source filter instances used :  1
        All ports, vlan v1, ingress only

History

This command was first available in ExtremeXOS 15.3.

The remote IP address option was added in ExtremeXOS 22.4.

Redundant remote IP addresses capability was added in ExtremeXOS 30.4.

Platform Availability

This command is available on ExtremeSwitching X435, X440-G2, X450-G2, X460-G2, X465, X590, X620, X690, and X695 series switches.