Updates or specifies the "to port", "to port list", or remote IP address destination definitions for a named mirroring instance.
| 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. |
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.
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.
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
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.
This command is available on ExtremeSwitching X435, X440-G2, X450-G2, X460-G2, X465, X590, X620, X690, and X695 series switches.