For the impatient
-----------------

(It strongly recomended you read the whole document before installing, anyway!)

   ./configure
   make
   make install

Requirements:
------------

  * Perl 5.6 or newer
  * User Mode Linux kernel and filesystem (see VNUML website)
  * One of the following: curl, wget, libwww-perl (installation)
  * libxml2, expat2 (can be installed automatically)
  * GNU make

Basic installation
------------------

Configure and make:

   ./configure
   make
   make test

Then as root, type:

   make install

This installs binaries and documentation.

To uninstall, type 'make uninstall' as root.

In order to set the Perl interpreter, the installer checks if PERL environment 
variable is defined, then this will be used. Otherwise, the configure script 
will search for a perl binary on the system. 

Libxml2 and expat2
------------------

If your OS has libxml2 and expat2 available as packages, we recommend
installing those. Otherwise, we will install it from source for you in
the following steps. To do so, use the --with-libxml=yes and/or --with-expat=yes.

For example, the following will install both libxml2 and expat2 from sources:

   ./configure --with-libxml=yes --with-expat=yes

External Perl modules
------------

The VNUML tool requires some external Perl modules to work. By default, the installer 
check if the required modules are installed. If not, the installer will report the
user about the missing modules, in order he can install them before running again the
installer.

However, the VNUML installer can automate the missing modules installation using 
--with-build_modules=yes configure option. This is done throught the CPAN public repository
and requires Internet connection.

   ./configure --with-build_modules=yes

The required modules are the following (try using newest versions):

	File::Glob
	Module::Build
	LWP
	XML::Parser
	XML::Parser::PerlSAX
	XML::RegExp
	XML::DOM
	XML::Checker
	Term::ReadKey
	Math::Base85
	NetAddr::IP
	Net::Pcap
	IO::Socket
	Error
	Exception::Class

Rootfs and UML kernel related options
-------------------------------------

Options --with-rootfs and --with-linux (with the associated option --with-linux-sv)
are very useful if you don't have a previously downloaded or built 
UML filesystem or kernel. For example, to download filesystem 0.3.2 
and kernel 2.6.12.2-1m from VNUML homepage use following instead the standard 
configure command:

   ./configure --with-linux=2_6_12_2 --with-linux-sv=1m --with-rootfs=0_3_2

Aditional information
---------------------

See the Installation Manual, online at 

   http://www.dit.upm.es/vnuml/doc/html/en/install/index.html

