Fedora7

Installing VNUML over Fedora 7/8

This HowTo describes how to install VNUML over a fresh Fedora 7/8 installation. Note that it is a preliminary version. Let us know if it does not work for you.

Installation steps:

1. Install Fedora 7/8 and make sure basic development tools are installed. Use the following command to install them if needed:

yum groupinstall "Development Tools"

2. Update the system with:

yum update

3. Install the following packages needed by VNUML:

yum install bridge-utils readline-devel perl-Module-Build screen expat-devel libpcap-devel perl-Net-Pcap perl-NetAddr-IP perl-Net-IPv6Addr perl-XML-DOM perl-Exception-Class perl-TermReadKey perl-Error perl-CPAN

4. Install uml_utilities:

wget http://www.user-mode-linux.org/~blaisorblade/uml-utilities/uml_utilities_20060323.tar.bz2
tar xfvj uml_utilities_20060323.tar.bz2
cd tools-20060323
make 
make install

5. Installl VNUML. Dowload latest vnuml tar file from http://www.dit.upm.es/vnumlwiki/index.php/Download and:

tar xfvz  vnuml_1.8.3.orig.tar.gz
cd vnuml-1.8.3
./configure --with-build_modules --prefix="/usr"
make 
make install   # answer NO when asked about manual configuration; 
               # answer YES when asked "Shall I follow them and prepend....")

If when executing ./configure an error is shown regarding the Perl modules directory, try locating it with "find perl-modules" and specify it in the ./configure line using the --with-perl-modules-installroot option (for example: "./configure --with-build_modules --prefix=/usr --with-perl-modules-installroot=./perl-modules"). Thanks to Jesús Nubiola, that reported this issue :)

6. Install VNUML kernel. Download "linux-um" package from VNUML site and:

 cd /usr/share
 tar xfvz linux-um_2.6.18.1-bb2-xt-4m.orig.tar.gz
 ln -s linux-um-2.6.18.1-bb2-xt-4m linux-um 
 mv linux-um/linux-2.6.18.1-bb2-xt-4m /usr/share/vnuml/kernels
 ln -s /usr/share/vnuml/kernels/linux-2.6.18.1-bb2-xt-4m /usr/share/vnuml/kernels/linux

7. Install root_fs using root-fs-instaler installer script:

 cd /usr/share/vnuml/filesystems
 wget http://www.dit.upm.es/vnuml/download/scripts/root-fs-installer
 perl root-fs-installer

8. Create ssh keys with:

 ssh-keygen -t rsa1

9. Test the installation with:

 cd /usr/share/vnuml/examples:
 vnumlparser.pl -t simple.xml -v -u root

Important note:

If you use kernel 2.6.18.1-bb2-xt-3m or older, do not use <consoles> with id=0 (use id="1" instead). For example, edit your scenarios and change: <console id="0">xterm</console> to: <console id="1">xterm</console> If you use console id="0" the scenarios will start and work normally, but the virtual machines will hang when stopping the scenario using "-d" option. See https://lists.dit.upm.es/pipermail/vnuml-users/2007-September/000664.html for more details. In any case, it is strongly recommended to update to the latests kernel version to avoid this problem.