wiki:GeniTmixSoftware

Version 23 (modified by Ben Newton, 11 years ago) (diff)

--

Tmix Software

This page describes how to install and use the Tmix software for generating Tmix input files from a network traffic trace.

Tmix generates traffic based on traffic measured on a real link. This measurement is made by recording the headers of packets flowing over a link. The Tmix software described here converts a network trace into a pair of Tmix input files which are then used by another piece of software to replay the traffic.

Software Package

Those desiring to generate their own Tmix input files can obtain a copy of the Tmix software package by sending an email to Jay Aikat (aikat AT cs DOT unc DOT edu)

Software Dependencies

The Tmix software runs on modern Linux distributions, and depends on the following readily available software packages:

  • libpcap
  • wireshark-common (for capinfos)
  • tcpdump

To Install the dependencies on Ubuntu issue the following commands:

sudo apt-get install libpcap
sudo apt-get install wireshark-common
sudo apt-get install tcpdump

Install

Follow these instructions to build and install the Tmix software. The following assumes version 1.0 of the software, if installing a different version, replace tmix.1.0 with the correct version number.

  1. Copy the tmix software tarball to a directory where it can be uncompressed and untarred, change to that directory, then issue the following command:
    tar -zxvf tmix.1.0
    
  1. Issue the following commands to configure, build the software:
    cd tmix.1.0
    ./configure
    make
    
  1. (Optional) To test the software build, issue the following command:
    make check
    
  1. (Optional) The binaries are now available in the src directory. To install the binaries, issue the following command:
    sudo make install
    

Run

Tmix generates traffic based on traffic measured on a real link. This measurement is made by recording the headers of packets flowing over a link in either direction. This protion of the Tmix software converts a network trace into a pair of Tmix input files which are then used to replay the traffic in GENI. Currently only pcap format files are supported. Pcap is a standard format, and most network traces should be easily output in or converted to the pcap format. The Tmix software requires that packets be identified as incoming packets or outgoing packets. Incoming packets are those entering an institution or machine over a link, and likewise outgoing packets are those leaving an institution or machine. For an internal host surfing the web, the packets making up an HTTP request are outgoing packets, and

Follow these steps to obtain a set of Tmix input files. These instructions assume you have installed binaries, and they are in your path, if not, augment the program names below with the paths to those binaries.

  1. Identify a pcap file you wish to process into a pair of Tmix input files.
  1. Change to a directory in which your input files will be created (they will be put in a tmix-results sub-directory)
  1. Issue the foll