#############################################################################
###
### 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 set up a custom topology to run our controller. 

=== GETTING STARTED ===

The script having in charge the task of creating custom topologies is 
"createHosts.sh" inside SDNSlab folder. To customize (in terms of number of 
hosts for each customer) topologies, you have to:

1. Enter directory "SDNSlab" on your machine 

2. Open and edit "createHosts.sh" script. In this file, the "HostCount" 
   variable determines how many end hosts you want to create for each customer. 
   
3. After choosing the number of hosts per customer, you can create the lab by 
   running the command:

   $ ./createHosts.sh

   This script creates a customized number of end hosts for each customer in a 
   federated network as well as configures their interfaces in the "lab.conf" 
   file. Also, it adds the IP address of each end-host to its local name server 
   configuration which is accessible by moving into the directory "/etc/bind/". 
   Finally, this script creates a directory for each end-host, sets up an 
   interface for each end-host by connecting it to the CE, makes a copy of 
   resolv.conf file inside "/etc/" directory of each end-host, and changes 
   "lab.conf" file in order to connect the end-hosts to local name servers 
   (i.e. ns1 and ns2) and customer premises (i.e. ce1 and ce2).

4. After that, you can run the lab as described in README.txt file.

** NOTE: we recall that before running a new lab generated following the above 
steps, you could need to tune some files as reported in the "IMPORTANT NOTE" 
section of the README.txt file.