configure mirror add

configure mirror { mirror_name} add [ {vlan} vlan_name | vlan vlan_id] {ingress | [port port {ingress}}| ip-fix | port port vlan [vlan_id | vlan_name ] {ingress}]

Description

Specifies mirror source filters for an instance.

Syntax Description

mirror_name Specifies a VLAN.
vlan Specifies a VLAN.
vlan_id Specifies a VLAN ID.
port Specifies a port or slot and port.
port Specifies particular ports or slots and ports.
ingress Specifies packets be mirrored as they are received on a port.
Note: This parameter is available only on BlackDiamond X8 series switches, BlackDiamond 8800 series switches, SummitStack, and Summit family switches. For BlackDiamond X8 series switches, BlackDiamond 8800 series switches, SummitStack, and Summit family switches, it is available only with port-based mirroring.
ip-fix Enables IPFIX flow traffic mirroring.
egress Specifies packets be mirrored as they are sent from a port.
Note: This parameter is available only on BlackDiamond X8 series switches, BlackDiamond 8800 series switches, SummitStack, and the Summit family switches. For BlackDiamond X8 series switches, BlackDiamond 8800 series switches, SummitStack, and Summit family switches, it is available only with port-based mirroring.
ingress-and-egress Specifies all forwarded packets be mirrored. This is the default setting on BlackDiamond 8800 series switches, SummitStack, and Summit family switches for port-based mirroring.
Note: This parameter is available only on BlackDiamond X8 series switches, BlackDiamond 8800 series switches, SummitStack, and Summit family switches. For BlackDiamond X8 series switches, BlackDiamond 8800 series switches, SummitStack, and Summit family switches, it is available only with port-based mirroring.

Default

N/A.

Usage Guidelines

You must enable port-mirroring using the enable mirroring to port command before you can configure the mirroring filter definitions.

Port mirroring configures the switch to copy all traffic associated with one or more ports to a monitor port on the switch. The switch uses a traffic filter that copies a group of traffic to the monitor port.

Up to 128 mirroring filters can be configured with the restriction that a maximum of 16 of these can be configured as VLAN and/or virtual port (port + VLAN) filters.

One monitor port or 1 monitor port list can be configured. A monitor port list may contain up to 16 ports.

Frames that contain errors are not mirrored.

For general guideline information and information for various platforms, see Guidelines for Mirroring in the ExtremeXOS User Guide or the Usage Guidelines of enable mirroring to port command discussion.

Example

The following example sends all traffic coming into a BlackDiamond 8800 series switch on slot 3, port 2 to the mirror port:

configure mirror add port 3:2 ingress

The following example sends all traffic coming into a switch on port 11 and the VLAN default to the mirror port:

configure mirror add port 11 vlan default

History

This command was first available in ExtremeXOS 15.3.

The vlan_id option was added in ExtremeXOS 16.1.

The ip-fix option was added in ExtremeXOS 21.1.

Platform Availability

This command is available on all platforms.