home

Supported platforms

Vyatta documentation

Learn how to install, configure, and operate the Vyatta Network Operating System (Vyatta NOS) and Orchestrator, which help drive our virtual networking and physical platforms portfolio.

service portmonitor session <id> source <interface>

Specifies the source interface for a port monitoring session.

set service portmonitor session id source { interface-name | interface-name.vid | erspantunnel-number }
delete service portmonitor session id source { interface-name | interface-name.vid | erspantunnel-number }
show service portmonitor session id source
id
The number of a port monitoring session.
interface-name
The name of a data plane interface. Following are the supported formats of the interface name:
  • dpxpypz—The name of a data plane interface, where

    • dpx specifies the data plane identifier (ID). Currently, only dp0 is supported.

    • py specifies a physical or virtual PCI slot index

    • pz specifies a port index (for example, p1).

    For example, dp0p1p2, dp0p160p1, and dp0p192p1.

  • dpxemy—The name of a data plane interface on a LAN-on-motherboard (LOM) device that does not have a PCI slot, where emy specifies an embedded network interface number (typically, a small number). For example, dp0em3.

  • dpxsy—The name of a data plane interface on a device that is installed on a virtual PCI slot, where xsy specifies an embedded network interface number (typically, a small number). For example, dp0s2. Currently, this format applies only when using the KVM platform.

  • dpxPnpypz—The name of a data plane interface on a device that is installed on a secondary PCI bus, where Pn specifies the bus number. You can use this format to name data plane interfaces on large physical devices with multiple PCI buses. For these devices, it is possible to have network interface cards installed on different buses with these cards having the same slot ID. The value of n must be an integer greater than 0. For example, dp0P1p162p1 and dp0P2p162p1.

interface-name.vid
Specifies the data plane interface and VLAN number.
erspantunnel-number
For ERSPAN-destination only, specifies the ERSPAN tunnel number.

Configuration mode


service {
    portmonitor {
        session id {
            source interface-name|interface-name.vid|erspantunnel-number 
        }
    }
}

For a SPAN or an RSPAN-source session, you can configure more than one source interface for which ingress or egress mirroring is enabled. The source interface can be a physical or VLAN interface.

For an RSPAN-destination session, you can configure one source VLAN interface from which to receive the mirrored packets. The source VIF for the RSPAN-destination type must be part of a bridge group.

The source interface for an ERSPAN-destination is an ERSPAN GRE tunnel.

An interface cannot be both the source and destination of a monitoring session.

A source interface cannot be a member of more than one monitoring session.

Use the set form of the command to specify the source interface for a port monitoring session.

Use the delete form of the command to remove the source interface for a port monitoring session.

Use the show form of the command to show the source interface for a port monitoring session.