== Emulator for Next-Generation Smart Grid Network Management Tutorial ==

This wiki page contains tutorial for: "Emulator for Next-Generation Smart Grid Network Management".

=== Description ===
For this tutorial we will use ORBIT SB9 test bed to execute a test with two types of supported flows (stream and command flows) on test topology shown on image below.
[[Image(tutorial_topology.png)]]

Environment setup, test execution and results collecting is covered in this tutorial.

=== Prerequisites ===

VM that will be used in ORBIT environment should be Ubuntu 14.04 with following installed:
1. Mininet with POX, available at [https://github.com/mininet/mininet this GitHub page] with detailed installation instruction.
2. [https://github.com/jsonpickle/jsonpickle jsonpickle], used for JSON configuration deserialization. It can be installed using pip (pip install jsonpickle)
3. [https://github.com/phaag/nfdump nfdump], needed for Net Flow results parsing. It can be installed using `sudo apt-get install nfdump`
4. emulator, provided at following link

These steps can be simplified if prepared VM is saved and reused.

=== Setting up the environment ===

Setting up environment automated. First, time slot at ORBIT should be scheduled. It can be done using ORBIT Control Panel. Once the registrations has been approved via email, prepared VM can be loaded onto the SB9 test bed and the machines can be started:
1. `omf load -i sg.ndz -t all`
2. `omf tell -a on -t all`
Once the VM image has been loaded and the nodes are up and running, the only thing left is to exchange ssh authorized keys. This is done by executing following script `./setup_ssh.sh ~/nodes.`
Provided nodes file contains the list of ORBIT nodes that are up and running.

=== Running the experiment ===

Test is run by executing `SG-CommTestBed.py` script, locally or remotely using SSH.

=== Results analysis ===

Results are grouped by node name and there are two types of results:
1.	Traffic generators
2.	Netflow data
They can be collected by calling on ORBIT gateway box that will collect all the results and copy it locally.
Once the results are collected they can be analyzed. Traffic generators can be opened using any text editor while Netflow can be opened using excel.