Installing VNUML 1.7.0 over a fresh Ubuntu 6.02 LTS distribution
----------------------------------------------------------------
David Fernndez (david@dit.upm.es)
Dpto. Ingeniera de Sistemas Telemticos
Universidad Politécnica de Madrid
version 1 - July 26th, 2006
Installation using debian package and vnuml repository:
1 - Do the normal installation from Ubuntu CD.
2 - Activate Ubuntu community package sources (universe). They are necesary to install some of the packages VNUML depends on. You can do it by one of two methods:
* Editing /etc/apt/sources.list and uncommenting the "deb ..." lines that end with "universe", or
* Starting "synaptic" application (you can find it in System|Administration menu) and going to "Configuration|Repositories" menu option and selecting the the community repositories (universe).
3 - Update and upgrade the system:
> sudo su
> apt-get update
> apt-get upgrade
Note: remember that in Ubuntu when you issue a command preceded by sudo you have to type your own password, not the root one, which is disabled. You should restart the system after upgrading, as a new version of the kernel is installed.
Installation steps:
1 - Do the normal installation from Ubuntu CD.
2 - Activate Ubuntu community package sources (universe). They are necesary to install some of the packages VNUML depends on. You can do it by one of two methods:
* Editing /etc/apt/sources.list and uncommenting the "deb ..." lines that end with "universe", or
* Starting "synaptic" application (you can find it in System|Administration menu) and going to "Configuration|Repositories" menu option and selecting the the community repositories (universe).
3 - Update and upgrade the system:
> sudo su
> apt-get update
> apt-get upgrade
Note: remember that in Ubuntu when you issue a command preceded by sudo you have to type your own password, not the root one, which is disabled. You should restart the system after upgrading, as a new version of the kernel is installed.
4 - Install development utils and vlan support (optional):
> apt-get -y install build-essential vlan
5 - Install VNUML related utilities and perl libraries:
> apt-get install bridge-utils uml-utilities
> apt-get -y install libmodule-build-perl liberror-perl libexception-class-perl libxml-dom-perl libxml-checker-perl libterm-readkey-perl libnet-pcap-perl libnetwork-ipv4addr-perl libnetaddr-ip-perl
Net::IPv6Addr perl module is not avalaible as debian package, so it has to be installed using MCPAN:
> perl -MCPAN -e "install Net::IPv6Addr"
(answer "NO" if asked "Are you ready for manual configuration?". Answer the default option to other questions).
6 - Download the latest version of VNUML from http://www.dit.upm.es/vnuml and:
> tar xfvz vnuml-1.7.0-1.tar.gz
> cd vnuml-1.7.0-1
> ./configure
> make
> make install
7 - Download root filesystem (root_fs_tutorial-0.4.X.bz2) from VNUML sourceforge site and copy it to /usr/local/share/vnuml/filesystems. Create a symbolic link to it named "root_fs_tutorial":
> cp root_fs_tutorial-0.4.X.bz2 /usr/local/share/vnuml/filesystems
> cd /usr/local/share/vnuml/filesystems
> bunzip2 root_fs_tutorial-0.4.X.bz2
> ln -s root_fs_tutorial-0.4.X root_fs_tutorial
8 - Download guest kernel (linux-2.6.XXXX.tar.bz2) from VNUML sourceforge site and copy it to /usr/local/share/vnuml/kernels/src. Untar the file, copy the kernel and create a symbolic link to it:
> mkdir /usr/local/share/vnuml/kernels/src
> cp linux-2.6.XXXX.tar.bz2 /usr/local/share/vnuml/kernels/src
> cd /usr/local/share/vnuml/kernels/src
> tar xfvj linux-2.6.XXXX.tar.bz2
> cp linux-2.6.XXXX/linux-2.6.XXXX ..
> cd ..
> ln -s linux-2.6.XXXX linux
9 - Create ssh key:
> ssh-keygen -t rsa1
10 - Installation is finished. Launch the "simple" example to see if everything works:
> vnumparser.pl -t /usr/local/share/vnuml/examples/simple.xml -v
Note: if you execute the example from a "root" session, you should add the option "-u root" at the end of the line. There are some bugs in 1.6.1-1 version that prevent a simulation to work when executed as "vnuml" user (the default when you do not use -u option) from a root session. Alternatively, you can execute the command "xhost +local:" to allow local X-windows connections.
Installing host kernel with SKAS patch
--------------------------------------
VNUML works well over the standard kernel that comes with Ubuntu (using SKAS 0 mode). However, if you want to improve the performance, you can install the the SKAS 3 patch to the kernel. To do that:
1 - Install kernel sources and some system utilities:
> apt-get install linux-source libncurses5-dev initrd-tools
2 - Download SKAS3 patch from Blaisorblade's server and apply it to kernel sources:
> cd /usr/src
> wget http://www.user-mode-linux.org/~blaisorblade/patches/skas3-2.6/skas-2.6.15-v8.2/skas-2.6.15-v8.2.patch.bz2
> tar xfvj linux-source-2.6.15.tar.bz2
> cd linux-source-2.6.15
> bzcat ../skas-2.6.15-v8.2.patch.bz2 | patch -p1
3 - Configure, compile and install the new kernel:
> make oldconfig
> make
(Note: I´ve got an error related to "drivers/usb/net/zd1211/zddevlist.h"; to solve it, do a "make menuconfig" and desactivate support for that usb card in "Device drivers|USB support|USB network adapters")
> make modules
> make modules_install
> make install
Note: make install fails and does neither generate initrd file nor configure grub. Do it by hand:
> mkinitrd -o /boot/initrd.img-2.6-15.7-ubuntu1-skas3-v8.2 2.6-15.7-ubuntu1-skas3-v8.2
And edit /boot/grub/menu.lst and add a new entry for the new kernel like (this is just an example; change the parameters as appropriate to your system):
title Ubuntu, kernel 2.6.15.7-ubuntu1-skas3-v8.2
root (hd0,3)
kernel /boot/vmlinuz-2.6.15.7-ubuntu1-skas3-v8.2 root=/dev/hda4 ro quiet splash
initrd /boot/initrd.img-2.6.15.7-ubuntu1-skas3-v8.2
savedefault
boot
