This wiki has been migrated to https://gitlab.com/wireshark/wireshark/-/wikis/home and is now deprecated. Please use that site instead.
Differences between revisions 1 and 2
Revision 1 as of 2010-03-31 10:59:08
Size: 2354
Editor: JeffMorriss
Comment: Initial template version as requested in bug 4026 comment 14
Revision 2 as of 2010-04-01 15:44:30
Size: 3235
Editor: WayneBrassem
Comment:
Deletions are marked like this. Additions are marked like this.
Line 4: Line 4:
This file tries to help you add a new protocol to the wiki. Edit anything as appropriate to the specific protocol and replace any appearance of PROTO/proto/protofirstletter by your protocols name (and remove this text line before saving!). Juniper E Series routers have the ability to perform packet mirroring. Packet mirroring enables you to automatically send a copy of a packet to an external
host for analysis. Packet mirroring has many uses, including traffic debugging and troubleshooting user networking problems.
Line 6: Line 7:
XXX - add a brief PROTO description here The E Series JUNOSe software provides two methods that you can use to configure and manage your packet-mirroring environment — CLI-based and RADIUS-based.
 * CLI-based packet mirroring - An authorized operator uses the router’s CLI commands to configure and manage packet mirroring. You can mirror traffic related to a specific IP, IPv6, or L2TP interface or traffic related to a particular user. You also use CLI commands to create secure policies that identify the traffic to be mirrored and specify how the mirrored traffic is treated.
 * RADIUS-based packet mirroring — A RADIUS administrator uses RADIUS attributes to configure packet mirroring of a particular user’s traffic. The router creates dynamic secure policies for the mirroring operation.
Line 8: Line 11:
Juniper switches can be configured to mirror packets to another endpoint using UDP as a transport. The prepended UDP header
The UDP transport of mirrored packets applies only to the RADIUS-based option.
Juniper E Series router can be configured to mirror packets to another endpoint using UDP as a transport.  

Juniper mirror encapsulation (jmirror)

Juniper E Series routers have the ability to perform packet mirroring. Packet mirroring enables you to automatically send a copy of a packet to an external host for analysis. Packet mirroring has many uses, including traffic debugging and troubleshooting user networking problems.

The E Series JUNOSe software provides two methods that you can use to configure and manage your packet-mirroring environment — CLI-based and RADIUS-based.

  • CLI-based packet mirroring - An authorized operator uses the router’s CLI commands to configure and manage packet mirroring. You can mirror traffic related to a specific IP, IPv6, or L2TP interface or traffic related to a particular user. You also use CLI commands to create secure policies that identify the traffic to be mirrored and specify how the mirrored traffic is treated.
  • RADIUS-based packet mirroring — A RADIUS administrator uses RADIUS attributes to configure packet mirroring of a particular user’s traffic. The router creates dynamic secure policies for the mirroring operation.

The prepended UDP header The UDP transport of mirrored packets applies only to the RADIUS-based option. Juniper E Series router can be configured to mirror packets to another endpoint using UDP as a transport.

XXX - add some details on how this is done?

History

XXX - add a brief description of PROTO history

Protocol dependencies

  • UDP: jmirror is transported over UDP. No specific port number is used nor assigned.

Example traffic

XXX - Add example decoded traffic for this protocol here (as plain text or Wireshark screenshot).

Wireshark

The PROTO dissector is (fully functional, partially functional, not existing, ... whatever the current state is). Also add info of additional Wireshark features where appropriate, like special statistics of this protocol.

Preference Settings

The jmirror dissector has a UDP port number preference to tell it which on which UDP port to listen for jmirror packets.

Example capture file

XXX - Add a simple example capture file to the SampleCaptures page and link from here (see below). Keep this file short, it's also a good idea to gzip it to make it even smaller, as Wireshark can open gzipped files automatically.

Display Filter

A complete list of jmirror display filter fields can be found in the display filter reference

  • Show only the PROTO based traffic:

     jmirror 

Capture Filter

You cannot directly filter jmirror protocols while capturing. However, if you know the UDP port used (see above), you can filter on that one.

  • Capture only the mirror traffic over port (30030):

     udp port 30030 

  • add link to PROTO specification and where to find additional info on the web about it, e.g.:
  • jmirror header - format of jmirror packets

Discussion

jmirror (last edited 2013-02-25 01:51:21 by WayneBrassem)