Port mirroring configuration commands 1

display mirroring-group· 1

mirroring-group· 2

mirroring-group mirroring-port 2

mirroring-group monitor-port 3

mirroring-port 4

monitor-port 5

 

display mirroring-group

Syntax

display mirroring-group { group-id | all | local } [ | { begin | exclude | include } regular-expression ]

View

Any view

Default level

2: System level

Parameters

group-id: Number of the mirroring group to be displayed. The value is in the range of 1 to 5.

all: Displays all mirroring groups.

local: Displays local mirroring groups.

|: Filters command output by specifying a regular expression. For more information about regular expressions, see the Fundamentals Configuration Guide.

begin: Displays the first line that matches the specified regular expression and all lines that follow.

exclude: Displays all lines that do not match the specified regular expression.

include: Displays all lines that match the specified regular expression.

regular-expression: Specifies a regular expression, which is a case sensitive string of 1 to 256 characters.

Description

Use the display mirroring-group command to display information about the specified mirroring group or groups.

The output varies by mirroring group types and is sorted by mirroring group numbers.

Examples

# Display information about all the mirroring groups.

<Sysname> display mirroring-group all

mirroring-group 1:

    type: local

    status: active

    mirroring port:

        GigabitEthernet1/0/1  both

    monitor port: GigabitEthernet1/0/2

Table 1 Output description

Field	Description
mirroring-group	Number of the mirroring group
type	Type of the mirroring group
status	Status of the mirroring group, which can be active or inactive
mirroring port	Source port
monitor port	Destination port

 

mirroring-group

Syntax

mirroring-group group-id local

undo mirroring-group { group-id | all | local  }

View

System view

Default level

2: System level

Parameters

group-id: Specifies the number of the mirroring group to be created or removed. The value is in the range of 1 to 5.

all: Removes all mirroring groups by using the undo command.

local: Creates a local mirroring group or removes all local mirroring groups with the undo command.

Description

Use the mirroring-group command to create a mirroring group.

Use the undo mirroring-group command to remove the specified mirroring group or groups.

By default, no mirroring group exists on a device.

Examples

# Create a local mirroring group numbered 1.

<Sysname> system-view

[Sysname] mirroring-group 1 local

mirroring-group mirroring-port

Syntax

mirroring-group group-id mirroring-port mirroring-port-list { both | inbound | outbound }

undo mirroring-group group-id mirroring-port mirroring-port-list { both | inbound | outbound }

View

System view

Default level

2: System level

Parameters

group-id: Number of a local group. The mirroring group specified by the group-id argument must already exist. The value is in the range of 1 to 5.

mirroring-port-list: A list of source ports/port ranges to be assigned to or removed from the mirroring group specified by group-id. You can specify up to eight single ports, port ranges, or combinations of both for the list.

both: Mirrors both inbound and outbound packets on the specified port(s).

inbound: Mirrors only inbound packets on the specified port(s).

outbound: Mirrors only outbound packets on the specified port(s).

Description

Use the mirroring-group mirroring-port command to assign ports to a local group as source ports.

Use the undo mirroring-group mirroring-port command to remove source ports from the mirroring group.

By default, no source port is configured for any mirroring group.

When removing a source port from a mirroring group, make sure the traffic direction you specified in the undo mirroring-group mirroring-port command matches the actual monitored direction specified earlier in the mirroring-group mirroring-port command.

Related commands: mirroring-group.

Examples

# Create local mirroring group 1, configure GigabitEthernet 1/0/1 as a source port of the mirroring group, and specify that the mirroring group monitor the bidirectional traffic of the port.

<Sysname> system-view

[Sysname] mirroring-group 1 local

[Sysname] mirroring-group 1 mirroring-port gigabitethernet 1/0/1 both

# Remove GigabitEthernet 1/0/1 from mirroring group 1.

<Sysname> system-view

[Sysname] undo mirroring-group 1 mirroring-port gigabitethernet 1/0/1 both

mirroring-group monitor-port

Syntax

mirroring-group group-id monitor-port monitor-port-id

undo mirroring-group group-id monitor-port monitor-port-id

View

System view

Default level

2: System level

Parameters

group-id: Number of a local group. The mirroring group specified by group-id must already exist. The value is in the range of 1 to 5.

monitor-port-id: Port to be assigned to the specified mirroring group as the monitor port. The argument takes the form of interface-type interface-number, where interface-type specifies the port type and interface-number specifies the port number.

Description

Use the mirroring-group monitor-port command to assign a port to a local group as the monitor port.

Use the undo mirroring-group monitor-port command to remove the monitor port from the local group.

By default, no monitor port is configured for a mirroring group.

You cannot assign a source port in an existing mirroring group to another mirroring group as the monitor port.

Related commands: mirroring-group.

Examples

# Create local mirroring group 1, and configure port GigabitEthernet 1/0/1 as its monitor port.

<Sysname> system-view

[Sysname] mirroring-group 1 local

[Sysname] mirroring-group 1 monitor-port gigabitethernet 1/0/1

mirroring-port

Syntax

[ mirroring-group group-id ] mirroring-port { inbound | outbound | both }

undo [ mirroring-group group-id ] mirroring-port { inbound | outbound | both }

View

Interface view

Default level

2: System level

Parameters

mirroring-group group-id: Specifies a local group by its number. The mirroring group specified by group-id must already exist. The value is in the range of 1 to 5, and the default value is 1.

both: Mirrors both inbound and outbound packets on the current port.

inbound: Mirrors only inbound packets on the current port.

outbound: Mirrors only outbound packets on the current port.

Description

Use the mirroring-port command to assign the current port to a local group as a source port.

Use the undo mirroring-port command to remove the current port from the mirroring group.

By default, a port does not serve as a source port for any mirroring group.

When removing a source port from a mirroring group, make sure the traffic direction you specified in the undo mirroring-group command matches the actual monitored direction of the port specified earlier in the mirroring-port command.

Examples

# Create local mirroring group 1, configure GigabitEthernet 1/0/1 as a source port of the mirroring group, and specify that the mirroring group monitor the bidirectional traffic of the port.

<Sysname> system-view

[Sysname] mirroring-group 1 local

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] mirroring-group 1 mirroring-port both

monitor-port

Syntax

[ mirroring-group group-id ] monitor-port

undo [ mirroring-group group-id ] monitor-port

View

Interface view

Default level

2: System level

Parameters

mirroring-group group-id: Specifies a local group by its number. The mirroring group specified by group-id must already exist. The value is in the range of 1 to 5, and the default value is 1.

Description

Use the monitor-port command to assign the current port to a local group as the monitor port.

Use the undo monitor-port command to remove the current port from the mirroring group.

By default, a port does not serve any mirroring group as the monitor port.

You cannot configure a source port of an existing mirroring group as a monitor port.

Related commands: mirroring-group.

Examples

# Create local mirroring group 1, and configure GigabitEthernet 1/0/1 as its monitor port.

<Sysname> system-view

[Sysname] mirroring-group 1 local

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] monitor-port