Next: 7. Troubleshooting Up: IMUNES manual Previous: 5. Advanced Usage
Section 2 of the handbook describes the installation of the FreeBSD operating system:
You can choose to install FreeBSD with two different architectures:
Part Mount Size
ad0s1a / 1024MB
ad0s1b swap 2006MB
ad0s1d /var 5099MB
ad0s1e /tmp 1024MB
ad0s1f /usr 11326MB
Login into the machine as root. Edit the file /etc/rc.conf with an editor e.g. vi and add the following lines at the end of the file:
hald_enable="YES" dbus_enable="YES" zfs_enable="YES"Save changes and exit.
# pkg_add -r xorg bash xpdf vim geany zip unzip xterm firefox
You can choose between multiple desktop environments:
After the installation of one or multiple window manager we need to configure which will be used. Edit the file .xinitrc in the user folder and add a line depending on which window manager you want to use:
Reboot the machine by issuing the reboot command:
# reboot
After the machine has rebooted, log in and issue the startx command to
start the chosen window manager:
# startx
First we need to install the packages needed for IMUNES. To do this execute the following command:
# pkg_add -r tk86 ImageMagick tcllib libimg wireshark
After all the packages are installed we need to use the second partition we prepared during the installation (the one with the size 5GB, probably named ad0s2). This partition will be used to store the data that will be in the virtual nodes. For this purpose we will create a ZFS pool on the second partition with the command zpool create assuming that the second partition is named ad0s2:
# zpool create vroot /dev/ad0s2
Now we need to fetch the IMUNES source/tarball from the official imunes site:
To fetch you can use the firefox browser that we installed earlier or use the fetch command:
# fetch http://imunes.tel.fer.hr/imunes-1.0.tar.gz
To extract the tarball use the following command:
# tar xf imunes-1.0.tar.gz
Enter the extracted directory:
# cd imunes
Now we need to install IMUNES and populate the ZFS file system with predefined and required data. To install imunes on the system execute:
# make install
To setup the ZFS file system execute:
# make vroot
Both of these commands can be executed together by executing:
# make
Now the IMUNES GUI can be ran just by typing the imunes command in the terminal:
# imunes
The GUI allows the specification of network topologies but to execute experiments the FreeBSD kernel must be compiled with a few additional options.
First, the kernel sources need to be fetched, this can be done by using the sysinstall utility:
Now the kernel source is available in the folder /usr/src/sys. Enter that folder:
# cd /usr/src/sys
Depending which distribution architecture you have decided to install, i386 or amd64 the next command differs.
For i386 enter the directory i386/conf:
# cd i386/conf
For amd64 enter the directory amd64/conf:
# cd amd64/conf
With an editor (vi, vim or geany) create a file named VIMAGE:
# vi VIMAGE
Insert the following configuration in the VIMAGE file:
include GENERIC
nooptions FLOWTABLE
options VIMAGE
options VNET_DEBUG
options MROUTING
options DDB
options KDB
Exit and save the file.
Now execute the following commands:
# config VIMAGE # cd ../compile/VIMAGE # make cleandepend && make depend # make # make install
When the last command ends use the reboot command to restart the computer:
# reboot
After login execute the startx command to start the window manager. Open a terminal and start imunes:
# imunes
Now you can create an arbitrary network topology or something like shown in Figure 4.1 and execute the experiment.
Section 2 of the handbook describes the installation of the FreeBSD operating system:
You can choose to install FreeBSD with two different architectures:
Part Type Mount Size ada0p1 freebsd-boot 64kB ada0p2 freebsd-ufs / 2GB ada0p3 freebsd-ufs /var 8GB ada0p4 freebsd-ufs /tmp 4GB ada0p5 freebsd-ufs /usr 24GB ada0p6 freebsd-swap none 2GB
Login into the machine as root. Edit the file /etc/rc.conf with an editor e.g. vi and add the following lines at the end of the file:
hald_enable="YES" dbus_enable="YES"Save changes and exit.
# pkg_add -r xorg bash xpdf vim geany zip unzip xterm firefox subversion
You can choose between multiple desktop environments:
After the installation of one or multiple window manager we need to configure which will be used. Edit the file .xinitrc in the user folder and add a line depending on which window manager you want to use:
Reboot the machine by issuing the reboot command:
# reboot
After the machine has rebooted, log in and issue the startx command to
start the chosen window manager:
# startx
First we need to install the packages needed for IMUNES. To do this execute the following command:
# pkg_add -r tk86 ImageMagick tcllib wireshark socat gmake
Now we need to fetch the IMUNES source/tarball from the official imunes site:
To fetch you can use the firefox browser that we installed earlier or use the fetch command. Then extract the tarball and enter the directory:
# fetch http://imunes.tel.fer.hr/imunes-1.0.tar.gz
# tar xf imunes-1.0.tar.gz
# cd imunes_version
Alternatively, you could checkout the last fresh IMUNES source through the public SVN repository:
# svn co svn://imunes.tel.fer.hr/head/ imunes
# cd imunes
Now we need to install IMUNES and populate the virtual file system with predefined and required data. To install imunes on the system execute:
# make install
To setup the virtual file system execute:
# make vroot
Both of these commands can be executed together by executing:
# make
Now the IMUNES GUI can be ran just by typing the imunes command in the terminal:
# imunes
The GUI allows the specification of network topologies but to execute experiments the FreeBSD kernel must be compiled with a few additional options.
If you didn't include the src option in step 4 while installing FreeBSD, the kernel sources need to be fetched. Use your selected architecture and release combination:
# fetch ftp://ftp.freebsd.org/pub/FreeBSD/releases/arch/release/src.txz
e.g. for FreeBSD 9.2 with amd64 architecture use:
# fetch ftp://ftp.freebsd.org/pub/FreeBSD/releases/amd64/9.2-RELEASE/src.txz
Extract it by using:
# tar xf src.txz -C /
Now the kernel source is available in the folder /usr/src/sys. Enter that folder:
# cd /usr/src/sys
Depending which distribution architecture you have decided to install, i386 or amd64 the next command differs.
For i386 enter the directory i386/conf:
# cd i386/conf
For amd64 enter the directory amd64/conf:
# cd amd64/conf
With an editor (vi, vim or geany) create a file named VIMAGE:
# vi VIMAGE
Insert the following configuration in the VIMAGE file:
include GENERIC
nooptions FLOWTABLE
options VIMAGE
options VNET_DEBUG
options MROUTING
options IPSEC
device crypto
options IPSEC_DEBUG
options DDB
options KDB
Exit and save the file.
Now execute the following commands:
# config VIMAGE # cd ../compile/VIMAGE # make cleandepend && make depend # make # make install
When the last command ends use the reboot command to restart the computer:
# reboot
After login execute the startx command to start the window manager. Open a terminal and start imunes:
# imunes
Now you can create an arbitrary network topology or something like shown in Figure 4.1 and execute the experiment.
Section 2 of the handbook describes the installation of the FreeBSD operating system:
You can choose to install FreeBSD with two different architectures:
Part Type Mount Size ada0p1 freebsd-boot 64kB ada0p2 freebsd-ufs / 4GB ada0p3 freebsd-ufs /var 10GB ada0p4 freebsd-ufs /usr 24GB ada0p5 freebsd-swap none 2GB
Login into the machine as root. Edit the file /etc/rc.conf with an editor e.g. vi and add the following lines at the end of the file:
hald_enable="YES" dbus_enable="YES"Save changes and exit.
If necessary, bootstrap pkg:
# env ASSUME_ALWAYS_YES=YES pkg bootstrap
Install neccessary packages:
# pkg install xorg bash xpdf vim geany zip unzip xterm firefox wget
You can choose between multiple desktop environments:
After the installation of one or multiple window manager we need to configure which will be used. Edit the file .xinitrc in the user folder and add a line depending on which window manager you want to use:
Reboot the machine by issuing the reboot command:
# reboot
After the machine has rebooted, log in and issue the startx command to
start the chosen window manager:
# startx
First we need to install the packages needed for IMUNES. To do this execute the
following command:
# pkg install tk86 ImageMagick tcllib wireshark socat git gmake
Checkout the last fresh IMUNES source through the public github repository:
# git clone https://github.com/imunes/imunes.git
Now we need to install IMUNES and populate the virtual file system with
predefined and required data. To install IMUNES on the system execute:
# cd imunes
# make install
To setup the virtual file system execute:
# imunes -p
Now the IMUNES GUI can be ran just by typing the imunes command in the
terminal:
# imunes
The GUI allows the specification of network topologies but to execute experiments the FreeBSD kernel must be compiled with a few additional options.
If you didn't include the src option in step 4 while installing FreeBSD, the
kernel sources need to be fetched. Use your selected architecture and release combination:
# fetch ftp://ftp.freebsd.org/pub/FreeBSD/releases/arch/release/src.txz
e.g. for FreeBSD 10.1 with amd64 architecture use:
# fetch ftp://ftp.freebsd.org/pub/FreeBSD/releases/amd64/10.1-RELEASE/src.txz
Extract it by using:
# tar xf src.txz -C /
Now the kernel source is available in the folder /usr/src/sys. Enter
that folder:
# cd /usr/src/sys
Depending which distribution architecture you have decided to install, i386 or amd64 the next command differs.
For i386 enter the directory i386/conf:
# cd i386/conf
For amd64 enter the directory amd64/conf:
# cd amd64/conf
With an editor (vi, vim or geany) create a file named VIMAGE:
# vi VIMAGE
Insert the following configuration in the VIMAGE file:
include GENERIC
nooptions FLOWTABLE
nooptions SCTP
options VIMAGE
options VNET_DEBUG
options DDB
options IPSEC
device crypto
options IPSEC_DEBUG
options IPSEC_NAT_T
Exit and save the file.
Now execute the following commands:
# config VIMAGE # cd ../compile/VIMAGE
If your machine has multiple cores, you can use the -j flag to distribute the make process on a number of cores. For example, to use 4 cores, run:
# make -j4 depend # make -j4 # make install
If you're running FreeBSD on a single core machine, just use the standard make commands:
# make depend # make # make install
When the last command ends use the reboot command to restart the
computer:
# reboot
After login execute the startx command to start the window manager. Open a terminal and start imunes:
# imunes
Now you can create an arbitrary network topology or something like shown in Figure 4.1 and execute the experiment.
We also have a VMware image containing the FreeBSD operating system including a complete and working installation of IMUNES.
After a few minutes FreeBSD with the graphical interface will start. On the desktop there is an IMUNES icon to start IMUNES.
The first thing you need to do is install Tcl/Tk. The easiest way to do this is using ActiveState ActiveTcl 8.6. To download the installation files visit:
Download the version 8.6, as IMUNES cannot run on earlier versions. Download the version that is designed for your operating system: x86 if you're using 32bit Linux or x86_64 if you're using 64bit Linux. Select the option AS package.
When the package is downloaded extract it using an archive manager or through the shell with the command:
# tar xzvf filename.tar.gz
Now enter the extracted directory and execute the file install.sh with root permissions. In the shell this is done with the line
# sudo ./install.sh
and provide the superuser password. If you don't have superuser permissions you can install ActiveTcl in your user directory. Make a directory in which ActiveTcl will be installed, and during the installation provide the path to that directory. After the installation you just need to put the ActiveTcl bin directory in the PATH variable.
For a csh or compatible (tcsh) perform:
# setenv PATH "/opt/ActiveTcl/bin:$PATH"
For a sh or similar perform:
# PATH="/opt/ActiveTcl/bin:$PATH"
# export PATH
To make the changes permanent add this lines to your shell rc configuration file (e.g. .bashrc for bash, .cshrc for csh).
To run IMUNES with full functionality you need the imagemagick package. You can install it through package managers or through shell.
On Debian, Ubuntu and other Debian based distributions you will use:
# sudo apt-get install imagemagick
On Fedora, Red Hat and other Red Hat based distributions you will use:
# su
# yum install imagemagick
Now we can fetch the latest version of IMUNES through CVS. To do this you need to have the cvs package installed. This is done the same way as the ImageMagick installation:
# sudo apt-get install cvs
or
# su
# yum install cvs
The line for fetching IMUNES from CVS is as follows:
# cvs -d :pserver:anonymous@imunes.net/usr/local/src/cvsroot co imunes
Now enter the imunes directory and start IMUNES:
# cd imunes
# ./imunes
The first thing you need to do is install Tcl/Tk. The easiest way to do this is using ActiveState ActiveTcl 8.6. To download the installation files visit:
Download the version 8.6, as IMUNES cannot run on earlier versions. Download the package by clicking on the Windows Installer (EXE) option. When the file is downloaded start the installation by double clicking on the file. Follow the installation instructions to the end.
Now, to enable the full functionality of IMUNES you need to download the ImageMagick program from:
Go to the Windows Binary Release section. Select the appropriate file. Download it and install it following the installation instructions.
To start IMUNES you need the latest IMUNES release. If you have access to a Unix/Linux system you can download it like it is shown at the end of the previous section (Section 6.5). Then transfer it on the Windows machine.
Enter the imunes directory and double click the file imunes.tcl to start IMUNES.