NDN Traffic Generator
C++ Python Shell
Latest commit 6f33e0f Sep 5, 2016 @yoursunny yoursunny add proper #include line for NDNLPv2 tags
refs #3755

Change-Id: Id700ab00722a4e8393ac5013d59f4979086b5064

README.md

Traffic Generator For NDN (ndn-traffic-generator)

This tool is designed to generate Interest and Data traffic in an NDN network. The client and server tool accept traffic configuration files which can be used to specify the pattern of NDN traffic that is required to be generated. Sample configuration files are provided which include instructions on how to configure various parameters.

Prerequisites

Compiling and running ndn-traffic-generator requires the following dependencies:

  1. C++ Boost Libraries version >= 1.48 http://www.boost.org

    On Ubuntu 12.04:

    sudo apt-get install libboost1.48-all-dev
    

    On Ubuntu 13.10 and later

    sudo apt-get install libboost-all-dev
    

    On OSX with macports

    sudo port install boost
    

    On OSX with brew

    brew install boost
    

On other platforms Boost Libraries can be installed from the packaged version for the distribution, if the version matches requirements, or compiled from source

  1. ndn-cxx library https://github.com/named-data/ndn-cxx

    For detailed installation instructions, please refer README file

  2. NDN forwarding daemon https://github.com/named-data/NFD


1. Compile & Installation Instructions:

./waf configure
./waf
sudo ./waf install

2. Tool Run Instructions & Command Line Options:

Usage: ndn-traffic-server [options] <traffic_configuration_file>
Respond to Interest as per provided traffic configuration file
Multiple prefixes can be configured for handling.
Set environment variable NDN_TRAFFIC_LOGFOLDER for redirecting output to a log.
  [-d interval] - set delay before responding to interest in milliseconds
  [-c count]    - specify maximum number of interests to be satisfied
  [-q]          - quiet logging - no interest reception/data generation messages
  [-h]          - print help and exit

Usage: ndn-traffic [options] <traffic_configuration_file>
Generate Interest traffic as per provided traffic configuration file
Interests are continuously generated unless a total number is specified.
Set environment variable NDN_TRAFFIC_LOGFOLDER for redirecting output to a log.
  [-i interval] - set interest generation interval in milliseconds (default 1000 milliseconds)
  [-c count]    - set total number of interests to be generated
  [-q]          - quiet logging - no interest reception/data generation messages
  [-h]          - print help and exit

3. Sample Run Instructions

ON MACHINE #1

(NDN forwarding daemon should be running)

Start traffic server

    ndn-traffic-server ndn-traffic-server.conf

ON MACHINE #2

(NDN forwarding daemon should be running)

Start the traffic client

    ndn-traffic ndn-traffic-client.conf
  • These tools need not be used together and can be used individually as well.
  • Please refer sample configuration files provided for details on how to create your own.
  • Use command line options shown above to adjust traffic configuration.