#############################################################################
###
### SDNS: a prototype SDN controller to interact with the DNS in order to set 
### up communication in federated networks using any IP addresses plan.
###
### This software has been developed by Habib Mostafaei, Andrea Brandimarte,
### and Roberto di Lallo, within the research line described at
### http://www.dia.uniroma3.it/~compunet/www/view/topic.php?id=sdn
###
### Last update: 9 January 2017
###
#############################################################################

This file describes how to install the experimental version of Netkit on a 
machine equipped with a GNU/Linux distribution.

=== GETTING STARTED ===
The first step to do in order to set up the environment for SDNS is to install 
Netkit (actually, the experimental version). To do that, it is needed to start 
from the installation of the stable release. You can find the stable 
distribution here:

http://wiki.netkit.org/index.php/Download_Official#Latest_Stable_Release

The instructions to install it are available here:

http://wiki.netkit.org/download/netkit/INSTALL

Now, you can proceed to install the experimental version of Netkit by 
downloading the filesystem and the kernel here:

http://wiki.netkit.org/index.php/Download_Official

** NOTE: being an experimental version, we observed undesired behaviors on 
linux operating systems having a kernel <4.1. We strongly recommend to install 
the experimental version of Netkit on linux operating systems with a kernel 
>4.1.

To upgrade Netkit from the stable version to the experimental one, follow these 
steps:

1. Extract the experimental filesystem in the NETKIT_HOME/fs folder

2. Move in the NETKIT_HOME/fs folder by running the command:

   $ cd $NETKIT_HOME/fs
   
3. Replace the old filesystem with the experimental one, by executing the 
   command:

   $ ln -sf netkit-fs-sid-x86_64 netkit-fs
   
4. Extract the experimental kernel in the NETKIT_HOME/kernel folder

5. 2. Move in the NETKIT_HOME/kernel folder by running the command:

   $ cd $NETKIT_HOME/kernel

6. Replace the old kernel with the experimental one, by executing the 
   commands:

   $ ln -sf netkit-kernel-4.0.0-x86_64 netkit-kernel
   $ mv modules modules-i386
   $ mv modules-x86_64 modules

Now, the experimental version of Netkit has been successfully installed and you 
can run the Netkit labs.