Vyatta Network OS Documentation

Learn how to install, configure and operate the Vyatta NOS, which helps drive our virtual networking & physical platforms portfolio.

service portmonitor session <id> destination <interface>

Specifies the destination interface or tunnel for a port monitoring session.

set service portmonitor session id destination { interface-name | interface-name.vid | erspantunnel-number }
delete service portmonitor session id destination
show service portmonitor session id destination [ interface-name | interface-name.vid | erspantunnel-number ]
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
For an RSPAN-source session only, specifies the data plane interface and VLAN number.
erspantunnel-number
For ERSPAN-source only, specifies the ERSPAN tunnel number.

Configuration mode


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

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

The destination interface is dedicated to monitoring and transmits only mirrored packets.

The destination interface for a SPAN, an RSPAN-destination, or an ERSPAN-destination session is a physical interface.

The destination interface for an RSPAN-source session is a data plane interface with a VLAN number.

Only one destination interface can be configured for SPAN, RSPAN-source, RSPAN-destination, ERSPAN-source, and ERSPAN-destination in a monitoring session.

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

A destination interfaces cannot be a member of more than one monitoring session.

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

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

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