wiki:WikiStart

Welcome

IMUNES source code and installation instructions on this wiki are outdated. For updates and new information about IMUNES, visit us at Official IMUNES Github.

Also, check the additional IMUNES tools as well as the examples on this page

Welcome to IMUNES's combined bug tracker and wiki website. Register to create a new ticket (a bug report or a feature request) or View Tickets without logging in.

Documentation

Using virtual machine

If you don't want to change your file system, a virtual machine image file is available for download. Using a virtual machine player of your choice (VirtualBox or VMWare Player
are recommended), simply open the downloaded image and the latest version of FreeBSD and IMUNES are installed and working.

For more information and troubleshooting, visit IMUNES Virtual Machine wikipage.

How to install IMUNES

IMUNES GUI can run on Linux, FreeBSD (release 8.2 or later), Windows and OSX, but FreeBSD is required to run IMUNES experiments.
To run IMUNES experiments the FreeBSD kernel must be built with the VIMAGE option enabled.
Example configuration file for building a FreeBSD kernel that can successfully run IMUNES experiments:

include	GENERIC
nooptions FLOWTABLE
options	VIMAGE
options	VNET_DEBUG
options MROUTING

options IPSEC
device crypto
options IPSEC_DEBUG

options	DDB
options	KDB

FreeBSD Handbook: Configuring the FreeBSD Kernel

Prerequisites for IMUNES are installed using the following command:

# pkg_add -r tk86 ImageMagick tcllib wireshark

Installing the GUI from source is simple, just open terminal and in the source folder execute the following command:

# make install

File system for virtual nodes

This step creates a separate file system for IMUNES nodes and is needed for running experiments. To create it just run the following:

# make vroot

The file system will be deployed in the /var/imunes/vroot folder.

We are currently working on IMUNES port for FreeBSD, so there will be an option soon to install it with pkg_add program.

How to run IMUNES

After login execute the startx command to start the window manager. Open a terminal and start IMUNES (with root rights):

# imunes

Examples

Some IMUNES examples and instructions to use them are available on Examples wikipage.

Legal notice

Copyright 2004-2015 University of Zagreb.

Last modified 19 months ago Last modified on Aug 27, 2015 10:43:58 AM