IMUNES GUI is a simple Tcl/Tk based management console, allowing for specification and management of virtual network topologies. The emulation execution engine itself operates within the operating system kernel.
Note: Do not use IMUNES with FreeBSD 14.0, as there is a serious bug with UnionFS. FreeBSD 14.1 fixes this issue.
# pkg install git-lite gmake
# pkg install tcl86 tcllib
# pkg install tk86 ImageMagick7 xterm wireshark socat
https://wiki.tcl-lang.org/page/tksvg
# cd /root
# git clone https://github.com/oehhar/tksvg.git
# cd tksvg
# ./configure --with-tcl=/usr/local/lib/tcl8.6 --with-tk=/usr/local/lib/tk8.6 --exec-prefix=/usr/local/lib/tksvg0.14
# make
# make install
NOTE: tksvg0.14 (comes out of the tksvgs package version, if you change the version you must change the line at the end,
depending on the version)
The compilation creates the following tree of directories and files.
:::text
Directory tree inside /usr/local/lib/tksvg0.14
tksvg0.14
│
├── bin
│
├── lib
│ │
│ ├── tksvg0.14
│ │
│ ├── libtksvg0.14.so
│ └── pkgIndex.tcl
├── libtksvg0.14.so
└── pkgIndex.tcl
For some unknown reason the last two lines are not created in some compilations so the tksvg0.14 library is not created.
the tksvg0.14 library does not work.
# cd /usr/local/lib/tksvg0.14/lib/tksvg0.14/
# cp -rf libtksvg0.14.so ../../
# cp -rf pkgIndex.tcl ../../
# apt install tcl tcllib docker.io
# apt install tk imagemagick wireshark socat
# apt install tcl8.6-dev tcl-dev tk8.6-dev tk-dev
# git clone https://github.com/oehhar/tksvg.git
# cd tksvg
# bash configure --with-tcl=/usr/lib/tcl8.6 --with-tk=/usr/lib/tk8.6 --exec-prefix=/usr/lib/tksvg0.14
# make install
# cd /usr/lib/tksvg0.14/lib/tksvg0.14/
# cp -rf libtksvg0.14.so ../../
# cp -rf pkgIndex.tcl ../../
This solves the problem, when the correct directory and file structure is not created during compilation.
When IMUNES is used on top of Linux, a 3.10 Linux kernel is the minimum requirement.
Depending on your platform, packages required to IMUNES in graphical mode are:
# Build requirements:
make (used for installation)
git (used for installation)
# Required packages:
tcl (version 8.6 or greater)
tcllib
Docker (version 1.6 or greater)
iproute2
# Also needed for graphical mode:
tk (version 8.6 or greater)
wireshark (with GUI)
ImageMagick
xterm
socat
To run IMUNES experiments, you must run the Docker daemon (starting this service depends on your Linux distribution).
Note: on some distributions the netem module sch_netem required for link configuration is only available by installing additional kernel packages. Please check the availability of the module:
# modinfo sch_netem
# pacman -S git make
# pacman -S tcl docker
# Package tcllib is available on AUR, e.g.:
# yay -S tcllib
# pacman -S tk imagemagick wireshark-qt xterm socat
# apt install git make
# apt install docker.io
# apt install imagemagick wireshark socat
# apt install git make
# apt install tcl tcllib docker.io
# apt install tk imagemagick xterm wireshark socat
Checkout the last fresh IMUNES source through the public github repository:
# git clone https://github.com/imunes/imunes.git
To open/edit topologies without the need to run the experiments, install IMUNES on the system by executing (as root):
# cd imunes
# make install
Note: check your distribution repository for a pre-packaged version of IMUNES (e.g. imunes-git on AUR for Arch Linux).
In order to run IMUNES experiments on your system, you also need to populate the virtual filesystem with predefined and required data. To create this template filesystem, run the following command (as root):
# imunes -p
Note: internet connection is required.
If graphical mode is installed, open IMUNES GUI by running:
# imunes
To execute experiments, run it as root.
To run experiments without graphical mode, run (as root):
# imunes -b existing_topology.imn
This will create an experiment with a random EID (experiment ID).
To specify a custom EID my_eid, run:
# imunes -b -e my_eid existing_topology.imn
To terminate the experiment with the EID eid, run:
# imunes -b -e eid
Visit our wiki for more:
For additional information visit our web site: https://imunes.net/