Vnx-install

VNX (Virtual Networks over X virtualization) v0.14 beta

Installation

Installing on Ubuntu 10.04/9.10

This section describes the procedure for installing VNX over Ubuntu 10.04 or 9.10. Open a root shell window and follow these steps:

• Install all packages required (basic development, virtualization, perl libraries and auxiliar packages):

apt-get update
apt-get install build-essential qemu-kvm libvirt-bin vlan xterm bridge-utils \
screen virt-manager virt-viewer libxml-checker-perl \
libxml-parser-perl libnetaddr-ip-perl libnet-pcap-perl libnet-ipv6addr-perl \
liberror-perl libexception-class-perl uml-utilities libxml-libxml-perl \
libxml2-dev libgnutls-dev libdevmapper-dev libterm-readline-perl-perl 

Note: for Ubuntu 9.04 change "qemu-kvm" package by "qemu kvm"

• If you use 64 bits version of Ubuntu, install 32 bits compatibility libraries:

 apt-get install ia32-libs

• Install libvirt 0.7.5:

 /etc/init.d/libvirt-bin stop
 wget http://libvirt.org/sources/libvirt-0.7.5.tar.gz
 tar xfvz libvirt-0.7.5.tar.gz
 cd libvirt-0.7.5
 ./configure --without-xen --prefix=/usr && make && make install
 /etc/init.d/libvirt-bin start

NOTE: By now, libvirt 0.7.5 is the only version of libvirt known to work with VNX.

NOTE2: libvirt 0.7.5 is available as a package in Ubuntu 10.04. However it has some problems related with the Apparmor profiles configured for libvirt. If you disable Apparmor (with "/etc/init.d/apparmor stop"), VNX will work with libvirt 0.7.5 installed as package, however we recommend to download and compile it as described above, in order to maintain Apparmor in your system.

• Install Sys::Virt perl module:
• For Ubuntu 10.04, just install the libsys-virt-perl package

apt-get install libsys-virt-perl

• For Ubuntu 9.10, as Sys::Virt library is not available as a package, install it manually:

wget http://search.cpan.org/CPAN/authors/id/D/DA/DANBERR/Sys-Virt-0.2.3.tar.gz
tar xfvz Sys-Virt-0.2.3.tar.gz 
cd Sys-Virt-0.2.3
perl Makefile.PL
make install

• Install VNX:

wget -N http://www.dit.upm.es/vnx/download/vnx-0.14b.tgz
tar xfvz vnx-0.14b.tgz
cd vnx-0.14b
./install_vnx

• Download root file systems from http://idefix.dit.upm.es/download/vnx/filesystems and copy them to /usr/share/vnx/filesystems directory:

cd /usr/share/vnx/filesystem

# ubuntu server
wget -N http://idefix.dit.upm.es/download/vnx/filesystems/root_fs_ubuntu-10.04-v01.qcow2.bz2
bunzip2 root_fs_ubuntu-10.04-v01.qcow2.bz2
ln -s root_fs_ubuntu-10.04-v01.qcow2 root_fs_ubuntu

# ubuntu with gui
wget -N http://idefix.dit.upm.es/download/vnx/filesystems/root_fs_ubuntu-10.04-gui-v01.qcow2.bz2
bunzip2 root_fs_ubuntu-gui-10.04-v01.qcow2.bz2
ln -s root_fs_ubuntu-10.04-gui-v01.qcow2 root_fs_ubuntu-gui

# freebsd server
wget -N http://idefix.dit.upm.es/download/vnx/filesystems/root_fs_freebsd-v01.qcow2.bz2
bunzip2 root_fs_freebsd-v01.qcow2.bz2
ln -s root_fs_freebsd-v01.qcow2 root_fs_freebsd

# freebsd gui
wget -N http://idefix.dit.upm.es/download/vnx/filesystems/root_fs_freebsd-gui-v01.qcow2.bz2
bunzip2 root_fs_freebsd-gui-v01.qcow2.bz2
ln -s root_fs_freebsd-gui-v01.qcow2 root_fs_freebsd-gui

# winxp and win7
# Sorry! Unfortunately for legal reasons we cannot distribute windows XP
# or Windows 7 root filesystems. See VNX documentation for detailed recipes
# to create these root fylesystems from scratch

• Additionally, if you plan to use VNUML root filesystem:

# VNUML root_fs_tutorial and kernel
cd /usr/share/vnx/filesystem
wget -N http://idefix.dit.upm.es/download/vnx/filesystems/root_fs_tutorial-0.6.0.bz2
bunzip2 root_fs_tutorial-0.6.0.bz2
ln -s root_fs_tutorial-0.6.0 root_fs_tutorial
cd /usr/share/vnx/kernels
wget -N http://jungla.dit.upm.es/~vnx/download/kernels/linux-2.6.18.1-bb2-xt-4m
ln -s linux-2.6.18.1-bb2-xt-4m linux

NOTE for Ubuntu 10.04.1: It seems that an additional package has to be installed:

apt-get install kvm-pxe

Installing on Fedora 11 (Not completed yet)

Follow tis steps to install VNX over Fedora 11:

• Instalar VNUML sobre Fedora 11 siguiendo la receta en http://www.dit.upm.es/vnumlwiki/index.php/Fedora11
• Instalar paquetes y librerías necesarias:

yum install qemu-kvm libvirt virt-manager virt-viewer perl-XML-LibXML perl-Sys-Virt
yum -y install bridge-utils readline-devel perl-Module-Build screen expat-devel libpcap-devel  
yum -y install perl-Net-Pcap perl-NetAddr-IP perl-Net-IPv6Addr perl-XML-DOM perl-Exception-Class
yum -y install perl-TermReadKey perl-Error perl-CPAN uml_utilities xterm tunctl

• Install XML::Checker perl library:

perl -MCPAN -e shell
install XML::Checker

• Add symbolic link for kvm:

ln -s /usr/bin/qemu-kvm /usr/bin/kvm

• Instalar VNX:

wget -N http://idefix.dit.upm.es/download/vnx/vnx-0.12b.tgz
tar xfvz vnx-0.12b.tgz
cd vnx-0.12b
./install-vnx

• Deshabilitar el firewall o, alternativamente, configurar los interfaces tipo "tun" como confiables (Sistema->Firewall->Interfaces Confiables").

Troubleshooting

Comprobaciones:

• Comprobar que el procesador tiene las extensiones de virtualización:

egrep '(vmx|svm)' --color=always /proc/cpuinfo

Si aparece la la palabra vmx (para Intel) o svm (para AMD) coloreada, es que el procesador tiene soporte de virtualización.

• Comprobar que KVM funciona con:

 modprobe kvm
 modprobe kvm_intel

• Arrancar con consola SDL

 kvm -sdl -hda /usr/share/vnuml/filesystems/linux-0.2.img -m 256    

• Arrancar con consola VNC:

 echo "Type 'vncviewer ${DISPLAY%.0}' to access vnc console"; kvm -vnc ${DISPLAY#*localhost} -hda /usr/share/vnuml/filesystems/linux-0.2.img -m 256

• Nota: si al ejecutar el comando kvm devuelve el mensaje de error:

open /dev/kvm: No such file or directory. 
Could not initialize KVM, will disable KVM support" 

es que el sistema operativo no detecta el soporte de virtualización. Si se ha comprobado que el procesador soporta virtualización, puede ser que ésta esté deshabilitada en la BIOS.

• Comprobar que libvirt+KVM funciona:
• Arrancando máquina virtual linux:

 cd /usr/share/vnuml/examples/
 virsh create root_fs_linux.xml 
 virt-viewer Linux

• Arrancando máquina virtual Windows XP:

 cd /usr/share/vnuml/examples/
 virsh create root_fs_winxp.xml 
 virt-viewer WinXP

• Para parar las máquinas utilizar:

 virsh shutdown Linux
 virsh shutdown WinXP

• En caso de problemas relacionados con la configuración de red:

 killall dnsmasq
 virsh net-start default

• En caso de que una máquina virtual creada con libvirt no arranque, se pueden consultar la causa en el fichero de trazas:

cat /var/log/libvirt/qemu/Linux.log 
cat /var/log/libvirt/qemu/WinXP.log

• El estado de las máquinas virtuales creadas con libvirt se puede ver desde la consola gráfica:

virt-manager

o desde la shell de libvirt:

virsh list

• Comprobar funcionamiento VNUML básico:

 cd /usr/share/vnuml/examples

Editar tutorial_root2.xml y añadir "<mem>64M</mem>" entre <filesystem...> y <kernel...>

 vnumlparser.pl -t tutorial_root2.xml -v -u root -Z

Errores conocidos

• Ubuntu 9.10: si al arrancar máquinas virtuales da el error:

libvirt error code: 38, message: monitor socket did not show up.: Connection refused

y en el log (/var/log/libvirt/qemu/*.log) se ve al final el mensaje:

qemu: could not open disk image /root/.vnuml/simulations/simple/vms/host1/fs/root_cow_fs

hay que rearrancar el demonio de libvirt mediante:

/etc/init.d/libvirt-bin restart

ver https://bugs.launchpad.net/ubuntu/+source/libvirt/+bug/503376