core-extra/wiki/MGEN.wiki
2009-07-15 19:54:23 +00:00

40 lines
No EOL
1.7 KiB
Text

#summary how to get MGEN running in CORE
MGEN is an open source traffic generator developed by NRL, available here: [http://cs.itd.nrl.navy.mil/work/mgen/ MGEN page at NRL]. You can use MGEN to easily create many different types of unicast or multicast IPv4/IPv6 traffic flows. Here is the [http://pf.itd.nrl.navy.mil/mgen/mgen.html MGEN Manual] for usage details.
= FreeBSD =
# Download MGEN source from here:
http://downloads.pf.itd.nrl.navy.mil/mgen/nightly_snapshots/mgen-svnsnap.tgz
# Download Protolib source from here:
http://downloads.pf.itd.nrl.navy.mil/protolib/nightly_snapshots/protolib-svnsnap.tgz
# Unpack the tarballs; this will create `mgen` and `protolib` directories:
{{{
> cd ~
> tar xzf mgen-svnsnap.tgz
> tar xzf protolib-svnsnap.tgz
}}}
# Create a symbolic link to protolib from mgen for building properly (see README.TXT for more information on why you need to do this)
{{{
> cd mgen
> ln -s ../protolib
}}}
# fix the MGEN makefile; edit the file `~/mgen/makefiles/Makefile.freebsd` and change the line `SYSTEM_LIBS = -lc_r` to `SYSTEM_LIBS = -lpthread`
# Build MGEN
{{{
> cd ~/mgen/makefiles
> make -f Makefile.freebsd
}}}
# Install it
{{{
> sudo install -g wheel -o root -m 555 mgen /usr/bin
> sudo install -g wheel -o root -m 555 mpmgr /usr/bin
}}}
= Linux =
MGEN is included in the core-root RPM. You can build it in your own core-root
= Sample Scenario =
There is a `sample5-mgen.imn` scenario file included with CORE that demonstrates how to start a traffic flow from one node to another upon startup. You can find this file in the directory `core/gui/configs/sample5-mgen.imn` from the latest SVN snapshot tarball [http://downloads.pf.itd.nrl.navy.mil/core/source/nightly_snapshots/core-svnsnap.tgz here].