| 1 | = Install OpenFlow Dissector for WireShark = |
| 2 | These instructions are tested on the standard Ubuntu 12.04 image of InstaGENI racks |
| 3 | |
| 4 | == Install necessary Packages == |
| 5 | {{{ |
| 6 | sudo apt-get update; |
| 7 | sudo apt-get install wireshark glib-2.0 gtk+-2.0 libgtk2.0-dev scons |
| 8 | }}} |
| 9 | |
| 10 | |
| 11 | == Download Source Files == |
| 12 | |
| 13 | Download wireshark source: |
| 14 | {{{ |
| 15 | wget http://archive.ubuntu.com/ubuntu/pool/universe/w/wireshark/wireshark_1.6.7.orig.tar.bz2 |
| 16 | tar xvfj wireshark_1.6.7.orig.tar.bz2 |
| 17 | }}} |
| 18 | Download OpenFlow dissector source: |
| 19 | {{{ |
| 20 | wget https://bitbucket.org/barnstorm/of-dissector/get/pre-ws-1.10.0.tar.gz |
| 21 | tar xvfz pre-ws-1.10.0.tar.gz |
| 22 | }}} |
| 23 | |
| 24 | == Configure Wireshark == |
| 25 | {{{ |
| 26 | cd wireshark-1.6.7/; |
| 27 | ./configure |
| 28 | export WIRESHARK=~/wireshark-1.6.7/ |
| 29 | }}} |
| 30 | |
| 31 | == Install Dissector == |
| 32 | {{{ |
| 33 | cd ~/barnstorm-of-dissector-85564cc537d4/ |
| 34 | cd src/ |
| 35 | scons install |
| 36 | }}} |
| 37 | |
| 38 | This will install the plugin at `~/.wireshark/plugins/openflow.so` |
| 39 | |
| 40 | If you want to install the plugin for all users move it to the global plugin place: |
| 41 | {{{ |
| 42 | sudo mv ~/.wireshark/plugins/openflow.so /usr/lib/wireshark/libwireshark1/plugins/ |
| 43 | }}} |
| 44 | |
| 45 | == Verify Installation == |
| 46 | WireShark is a graphical tool, in order to run it from a remote host you need to enable X11 Forwarding. |
| 47 | On a Linux-friendly machine when you ssh to the remote host add the `-X` flag. |
| 48 | |
| 49 | To verify installation: |
| 50 | 1. Run `wireshark` |
| 51 | 2. Open the "Help" --> "About" menu |
| 52 | 3. Select the "Plugins" tab |
| 53 | 4. Click the "Name" header to the plugins by name |
| 54 | 5. Verify that "openflow.so" appears in the list. |