AnnualTraining2015

2015-05-11T13:29:47Z

Tazaki: /* Tuesday May 12 */

{{TOC}}

This is the wiki page for the ns-3 training sessions being conducted from 11-12 May, 2015 in Barcelona.

== Logistics ==

The contacts are [mailto:tomh@tomh.org Tom Henderson] and [mailto:nbaldo@cttc.es Nicola Baldo]; email one of them if you have any questions.

The flyer is posted here: https://www.nsnam.org/wp-content/uploads/2015/04/ns-3-training-2015.pdf

We plan to run from 0900-1800 each day. Coffee will be provided; participants will need to go to the canteen and purchase their own lunch during the lunch break.

== Agenda ==

Slides will be linked from these session descriptions as they become available.

=== Monday May 11 ===

The goal of this session is a comprehensive overview of the simulator (what we can fit into a day). The instructors will be mainly Tom Henderson.

Sessions will run from 0900-1030, 1100-1230, 1400-1600, 1630-1800.

* '''([http://www.nsnam.org/tutorials/consortium15/ns-3-training-part1.pdf pdf]) ([http://www.nsnam.org/tutorials/consortium15/ns-3-training-part1.pptx pptx])''' ns-3 survey and overview tutorial, software organization, documentation, build system
* '''([http://www.nsnam.org/tutorials/consortium15/ns-3-training-part2.pdf pdf]) ([http://www.nsnam.org/tutorials/consortium15/ns-3-training-part2.pptx pptx])''' ns-3 software core, running of simulations, construction of a basic network simulation, construction of a new protocol model, and development practices using ns-3. Extracting and visualizing data from ns-3 simulations, including the flow monitor,network animator NetAnim, Python-based visualizer, and the ns-3 tracing system.
** [http://www.nsnam.org/tutorials/consortium15/wns3-version1.cc program wns3-version1.cc]
** [http://www.nsnam.org/tutorials/consortium15/wns3-version2.cc program wns3-version2.cc]
** [http://www.nsnam.org/tutorials/consortium15/wns3-version3.cc program wns3-version3.cc]
** [http://www.nsnam.org/tutorials/consortium15/wns3-version4.cc program wns3-version4.cc]
** [http://www.nsnam.org/tutorials/consortium15/reorder-queue.h model file reorder-queue.h]
** [http://www.nsnam.org/tutorials/consortium15/reorder-queue.cc model file reorder-queue.cc]

=== Tuesday May 12 ===

This will consist of special topic tutorials taught by experts in each field.
* (09:00-10:30) Large-scale, distributed simulations with ns-3 (instructor: Peter Barnes)
* (11:00-12:30)An introduction to the Direct Code Execution (DCE) environment, enabling users to use real application and Linux networking code in ns-3 (instructor: Hajime Tazaki)
** The tutorial basically uses the same Live-CD, which is provided below, but also uses more code: if you want to try during the tutorial, you can prepare in advance, following the instruction below.
** 1. additional git repositories
*** Because the size of this additional code is large and you may not able to download to the root directory of Live-CD image, so you need to configure an additional (virtual) disk image, which can be mounted to /mnt, then download the code to the additional partition.
git clone --depth=1 https://github.com/direct-code-execution/net-next-sim -b wns3-2015
git clone --depth=1 https://git.kernel.org/pub/scm/linux/kernel/git/shemminger/iproute2.git

:* 2. an additional ns-3 script
wget https://gist.githubusercontent.com/thehajime/5e9e05ea2df08141ae47/raw/a23387aa97b58bc13ccf96a1a208ddd387c9646f/nat-dce-tcp-ns3-nsc-comparison.cc
* Lunch break
* (14:00-16:00) A survey of the LTE models, including model architecture, propagation models, LTE Radio Protocol Stack and EPC model. (instructor: Nicola Baldo)
* '''[http://www.nsnam.org/tutorials/consortium15/Vehicular-Comms.pptx slides]'''(16:30-18:00) A tutorial on vehicular communication simulations, including mobility, WiFi and WAVE models, and propagation. (instructor: Konstantinos Katsaros)

== Preparation ==

Nothing is strictly required, but working through the [http://www.nsnam.org/docs/release/3.22/tutorial/html/index.html ns-3 tutorial] should be helpful, if you haven't already.

You do not need to install anything to attend the training, but the below instructions are provided for those who may want to follow along.

=== Installation of ns-3 to your local system ===

Please see the [[Installation]] page on our wiki for per-system package requirements if you want to install ns-3, and follow instructions at [https://www.nsnam.org/docs/release/3.22/tutorial/html/getting-started.html this tutorial link] on how to download ns-3.

Note that the minimal requirements for working from the command line are a recent C++ compiler (g++ or clang), and a Python (version 2) installation. The additional packages enable additional optional simulation features but can be skipped until needed.

=== Trying ns-3 on a Live ISO image ===

A 32-bit Ubuntu 14.04 Live DVD (ISO) is posted for download at [https://www.nsnam.org/tutorials/consortium15/ns-3-training-may-2015.iso this link] and will also be available on flash and DVD media at the training session. The ISO has prerequisite packages pre-installed and a recent copy of ns-3 source code.

You may want to use this ISO file with a virtual machine tool such as VMware or VirtualBox.

* sha1 checksum of the ISO image: 47a1ca78803a0f31ad8c764b47fc244cf2a28f94
* file size of the download: 4 GB
* '''username:''' ns-3
* '''password:''' ns-3
* recommended virtual machine resources (if you install to a VM): 40 GB HDD, 3 GB memory

This is a Live ISO image that can be booted repeatedly without saving state, or can be installed to a virtual or real drive. The [https://launchpad.net/~nemh/+archive/ubuntu/systemback Systemback] utility was used to create the image, and can be used to install the system as well. To install, select the green icon in the panel to bring up the below dialog box, fill in the account information (for the system to be created) and then hit Next and follow the instructions.

[[File:Systemback-install.png]]

Please read the README in the top level directory.

== Additional files ==

Links to any additional example files produced for the training (outside of the ns-3 release) will be posted here.

== Questions and Answers ==

AnnualTraining2015

2015-05-11T13:25:16Z

Tazaki: /* Tuesday May 12 */

{{TOC}}

This is the wiki page for the ns-3 training sessions being conducted from 11-12 May, 2015 in Barcelona.

== Logistics ==

The contacts are [mailto:tomh@tomh.org Tom Henderson] and [mailto:nbaldo@cttc.es Nicola Baldo]; email one of them if you have any questions.

The flyer is posted here: https://www.nsnam.org/wp-content/uploads/2015/04/ns-3-training-2015.pdf

We plan to run from 0900-1800 each day. Coffee will be provided; participants will need to go to the canteen and purchase their own lunch during the lunch break.

== Agenda ==

Slides will be linked from these session descriptions as they become available.

=== Monday May 11 ===

The goal of this session is a comprehensive overview of the simulator (what we can fit into a day). The instructors will be mainly Tom Henderson.

Sessions will run from 0900-1030, 1100-1230, 1400-1600, 1630-1800.

* '''([http://www.nsnam.org/tutorials/consortium15/ns-3-training-part1.pdf pdf]) ([http://www.nsnam.org/tutorials/consortium15/ns-3-training-part1.pptx pptx])''' ns-3 survey and overview tutorial, software organization, documentation, build system
* '''([http://www.nsnam.org/tutorials/consortium15/ns-3-training-part2.pdf pdf]) ([http://www.nsnam.org/tutorials/consortium15/ns-3-training-part2.pptx pptx])''' ns-3 software core, running of simulations, construction of a basic network simulation, construction of a new protocol model, and development practices using ns-3. Extracting and visualizing data from ns-3 simulations, including the flow monitor,network animator NetAnim, Python-based visualizer, and the ns-3 tracing system.
** [http://www.nsnam.org/tutorials/consortium15/wns3-version1.cc program wns3-version1.cc]
** [http://www.nsnam.org/tutorials/consortium15/wns3-version2.cc program wns3-version2.cc]
** [http://www.nsnam.org/tutorials/consortium15/wns3-version3.cc program wns3-version3.cc]
** [http://www.nsnam.org/tutorials/consortium15/wns3-version4.cc program wns3-version4.cc]
** [http://www.nsnam.org/tutorials/consortium15/reorder-queue.h model file reorder-queue.h]
** [http://www.nsnam.org/tutorials/consortium15/reorder-queue.cc model file reorder-queue.cc]

=== Tuesday May 12 ===

This will consist of special topic tutorials taught by experts in each field.
* (09:00-10:30) Large-scale, distributed simulations with ns-3 (instructor: Peter Barnes)
* (11:00-12:30)An introduction to the Direct Code Execution (DCE) environment, enabling users to use real application and Linux networking code in ns-3 (instructor: Hajime Tazaki)
** The tutorial basically uses the same Live-CD, which is provided below, but also uses more code: if you want to try during the tutorial, you can prepare in advance, following the instruction below.
** 1. additional git repositories
*** Because the size of this additional code is large and you may not able to download to the root directory of Live-CD image, so you need to configure an additional (virtual) disk image, which can be mounted to /mnt, then download the code to the additional partition.
git clone --depth=1 https://github.com/direct-code-execution/net-next-sim
git clone --depth=1 https://git.kernel.org/pub/scm/linux/kernel/git/shemminger/iproute2.git

:* 2. an additional ns-3 script
wget https://gist.githubusercontent.com/thehajime/5e9e05ea2df08141ae47/raw/a23387aa97b58bc13ccf96a1a208ddd387c9646f/nat-dce-tcp-ns3-nsc-comparison.cc
* Lunch break
* (14:00-16:00) A survey of the LTE models, including model architecture, propagation models, LTE Radio Protocol Stack and EPC model. (instructor: Nicola Baldo)
* '''[http://www.nsnam.org/tutorials/consortium15/Vehicular-Comms.pptx slides]'''(16:30-18:00) A tutorial on vehicular communication simulations, including mobility, WiFi and WAVE models, and propagation. (instructor: Konstantinos Katsaros)

== Preparation ==

Nothing is strictly required, but working through the [http://www.nsnam.org/docs/release/3.22/tutorial/html/index.html ns-3 tutorial] should be helpful, if you haven't already.

You do not need to install anything to attend the training, but the below instructions are provided for those who may want to follow along.

=== Installation of ns-3 to your local system ===

Please see the [[Installation]] page on our wiki for per-system package requirements if you want to install ns-3, and follow instructions at [https://www.nsnam.org/docs/release/3.22/tutorial/html/getting-started.html this tutorial link] on how to download ns-3.

Note that the minimal requirements for working from the command line are a recent C++ compiler (g++ or clang), and a Python (version 2) installation. The additional packages enable additional optional simulation features but can be skipped until needed.

=== Trying ns-3 on a Live ISO image ===

A 32-bit Ubuntu 14.04 Live DVD (ISO) is posted for download at [https://www.nsnam.org/tutorials/consortium15/ns-3-training-may-2015.iso this link] and will also be available on flash and DVD media at the training session. The ISO has prerequisite packages pre-installed and a recent copy of ns-3 source code.

You may want to use this ISO file with a virtual machine tool such as VMware or VirtualBox.

* sha1 checksum of the ISO image: 47a1ca78803a0f31ad8c764b47fc244cf2a28f94
* file size of the download: 4 GB
* '''username:''' ns-3
* '''password:''' ns-3
* recommended virtual machine resources (if you install to a VM): 40 GB HDD, 3 GB memory

This is a Live ISO image that can be booted repeatedly without saving state, or can be installed to a virtual or real drive. The [https://launchpad.net/~nemh/+archive/ubuntu/systemback Systemback] utility was used to create the image, and can be used to install the system as well. To install, select the green icon in the panel to bring up the below dialog box, fill in the account information (for the system to be created) and then hit Next and follow the instructions.

[[File:Systemback-install.png]]

Please read the README in the top level directory.

== Additional files ==

Links to any additional example files produced for the training (outside of the ns-3 release) will be posted here.

== Questions and Answers ==

Dce-1.3

2014-02-18T15:37:55Z

Tazaki: /* Things to do */

= Schedule for 1.3 release =
* xxth April, 2014: dce-1.3 release

= Bugs being worked =
* 1455: [https://www.nsnam.org/bugzilla/show_bug.cgi?id=1455 Support the python binding of DCE] Emilio

= Bugs not merged in this release =

= Pending code review =

= Things to do =
* create jenkins test job for 1.3
* update web page (http://www.nsnam.org/projects/direct-code-execution/)
* nsnam.org/doc/dce
* put stable versions/revisions to bakeconf.xml

WikiEditor

2013-03-28T06:55:20Z

Tazaki: /* Schedule for 1.0 release */

= Schedule for 1.0 release =
* <s>15th March, 2013: call for voluntary to walk through tutorial document and testing</s>
* 30th March, 2013: new feature freeze
* (2weeks before release, TBD): code freeze
* (TBD): RC-1

* (TBD): dce-1.0 release

= Call for volunteers of Testing, Reviewing =
Dear folks,

We, Direct Code Execution (DCE) project, are going to release the first version of DCE with coming April release of ns-3. We would like to ask your help for document reviews and tests.

The followings are the instruction to the test.
If you have any question, please drop an email to me (Hajime Tazaki: tazaki at sfc.wide.ad.jp).

==Document for Review==
* Quick Start Guide: http://www.nsnam.org/~thehajime/ns-3-dce-next-doc/doc/build/html/index.html
* User's Guide: http://www.nsnam.org/~thehajime/ns-3-dce-next-doc/doc/build/html/dce-user-doc.html

==Test Instruction==

# Follow [http://www.nsnam.org/~thehajime/ns-3-dce-next-doc/doc/build/html/index.html Quick Start Guide] and check whether contents are correct and able to finish without any issues.
# (If possible) Follow [http://www.nsnam.org/~thehajime/ns-3-dce-next-doc/doc/build/html/dce-user-doc.html User's Guide] and check whether contents are correct and able to finish without any issues.

==Report Template==
<pre>
OS: (Distribution, e.g. Ubuntu 12.04 64bits)
Result:
1 (Quick Start Guide): Success/Fail/Other

2 (User's Guide): Success/Fail/Other
Comments:</pre>

= Supported/Unsupported features =
{| class="wikitable"
|-
! !! UcontextFiberManager !! PthreadFiberManager
|-
| CoojaLoaderFactory || Supported || Supported
|-
| CoojaLoaderFactory with elf-loader || Should work, but won't support || Unsupported ([https://www.nsnam.org/bugzilla/show_bug.cgi?id=1513 Bug1513])
|-
| DlmLoaderFactory with elf-loader || Should work, but won't support || Unsupported ([https://www.nsnam.org/bugzilla/show_bug.cgi?id=1513 Bug1513])
|}
= Bugs being worked =
* <s> 1580: [https://www.nsnam.org/bugzilla/show_bug.cgi?id=1580 doxygen description] Hajime </s>
* 1594: [https://www.nsnam.org/bugzilla/show_bug.cgi?id=1594 gcov coverage test support for applications over DCE] Hajime
* <s> 1593: [https://www.nsnam.org/bugzilla/show_bug.cgi?id=1593 support DCE sub-module under myscripts directory] Hajime </s>
* <s>1448: [https://www.nsnam.org/bugzilla/show_bug.cgi?id=1448 DCE Kernel mode. Create a helper in order to create automatically the static routes.] Hajime </s>
* 1513: [https://www.nsnam.org/bugzilla/show_bug.cgi?id=1513 Use Linux kernel stack for ns-3 applications] Hajime
* 1455: [https://www.nsnam.org/bugzilla/show_bug.cgi?id=1455 Support the python binding of DCE] Hajime

= Pending code review =
* [https://codereview.appspot.com/6856090/ Bug1513: Use Linux kernel stack for ns-3 applications]
* [https://codereview.appspot.com/7635043/ Change Scheduling of event according to NS-3 requisite: ie use only the main thread to]

= Things to do =
* <s>migrate repository from 'furbani' to 'code'</s>
* <s>migrate ns-3-linux and ns-3-linux-3 repository to github's one.</s>
* create jenkins test suite
* fix valgrind errors (so many)
* test with document (quick start guide, user's guide)
* update web page (http://www.nsnam.org/projects/direct-code-execution/)
* nsnam.org/doc/dce
* put stable versions/revisions to bakeconf.xml

Dce-1.0

2013-03-24T14:00:21Z

Tazaki: /* Things to do */

= Schedule for 1.0 release =
* 15th March, 2013: call for voluntary to walk through tutorial document and testing
* 30th March, 2013: new feature freeze
* (2weeks before release, TBD): code freeze
* (TBD): RC-1

* (TBD): dce-1.0 release

= Call for volunteers of Testing, Reviewing =
Dear folks,

We, Direct Code Execution (DCE) project, are going to release the first version of DCE with coming April release of ns-3. We would like to ask your help for document reviews and tests.

The followings are the instruction to the test.
If you have any question, please drop an email to me (Hajime Tazaki: tazaki at sfc.wide.ad.jp).

==Document for Review==
* Quick Start Guide: http://www.nsnam.org/~thehajime/ns-3-dce-next-doc/doc/build/html/index.html
* User's Guide: http://www.nsnam.org/~thehajime/ns-3-dce-next-doc/doc/build/html/dce-user-doc.html

==Test Instruction==

# Follow [http://www.nsnam.org/~thehajime/ns-3-dce-next-doc/doc/build/html/index.html Quick Start Guide] and check whether contents are correct and able to finish without any issues.
# (If possible) Follow [http://www.nsnam.org/~thehajime/ns-3-dce-next-doc/doc/build/html/dce-user-doc.html User's Guide] and check whether contents are correct and able to finish without any issues.

==Report Template==
<pre>
OS: (Distribution, e.g. Ubuntu 12.04 64bits)
Result:
1 (Quick Start Guide): Success/Fail/Other

2 (User's Guide): Success/Fail/Other
Comments:</pre>

= Supported/Unsupported features =
{| class="wikitable"
|-
! !! UcontextFiberManager !! PthreadFiberManager
|-
| CoojaLoaderFactory || Supported || Supported
|-
| CoojaLoaderFactory with elf-loader || Should work, but won't support || Unsupported ([https://www.nsnam.org/bugzilla/show_bug.cgi?id=1513 Bug1513])
|-
| DlmLoaderFactory with elf-loader || Should work, but won't support || Unsupported ([https://www.nsnam.org/bugzilla/show_bug.cgi?id=1513 Bug1513])
|}
= Bugs being worked =
* <s> 1580: [https://www.nsnam.org/bugzilla/show_bug.cgi?id=1580 doxygen description] Hajime </s>
* 1594: [https://www.nsnam.org/bugzilla/show_bug.cgi?id=1594 gcov coverage test support for applications over DCE] Hajime
* <s> 1593: [https://www.nsnam.org/bugzilla/show_bug.cgi?id=1593 support DCE sub-module under myscripts directory] Hajime </s>
* <s>1448: [https://www.nsnam.org/bugzilla/show_bug.cgi?id=1448 DCE Kernel mode. Create a helper in order to create automatically the static routes.] Hajime </s>
* 1513: [https://www.nsnam.org/bugzilla/show_bug.cgi?id=1513 Use Linux kernel stack for ns-3 applications] Hajime
* 1455: [https://www.nsnam.org/bugzilla/show_bug.cgi?id=1455 Support the python binding of DCE] Hajime

= Pending code review =
* [https://codereview.appspot.com/6856090/ Bug1513: Use Linux kernel stack for ns-3 applications]
* [https://codereview.appspot.com/7635043/ Change Scheduling of event according to NS-3 requisite: ie use only the main thread to]

= Things to do =
* <s>migrate repository from 'furbani' to 'code'</s>
* <s>migrate ns-3-linux and ns-3-linux-3 repository to github's one.</s>
* create jenkins test suite
* fix valgrind errors (so many)
* test with document (quick start guide, user's guide)
* update web page (http://www.nsnam.org/projects/direct-code-execution/)
* nsnam.org/doc/dce
* put stable versions/revisions to bakeconf.xml

2013-03-13T08:23:41Z

Tazaki:

= Schedule for 1.0 release =
* 15th March, 2013: call for voluntary to walk through tutorial document and testing
* 30th March, 2013: new feature freeze
* (2weeks before release, TBD): code freeze
* (TBD): RC-1

* (TBD): dce-1.0 release

= Call for volunteer of Testing, Reviewing =
* (with Instruction)
* Test patterns
<pre>
../bake.py configure -c ../bakeconf.xml -e dce-ns3
../bake.py configure -c ../bakeconf.xml -e dce-quagga

../bake.py configure -c ../bakeconf.xml -e dce-linux
../bake.py configure -c ../bakeconf.xml -e dce-quagga
../bake.py configure -c ../bakeconf.xml -e dce-umip
</pre>

= Supported/Unsupported features =
{| class="wikitable"
|-
! !! UcontextFiberManager !! PthreadFiberManager
|-
| CoojaLoaderFactory || Supported || Supported
|-
| CoojaLoaderFactory with elf-loader || Should work, but won't support || Unsupported ([https://www.nsnam.org/bugzilla/show_bug.cgi?id=1513 Bug1513])
|-
| DlmLoaderFactory with elf-loader || Should work, but won't support || Unsupported ([https://www.nsnam.org/bugzilla/show_bug.cgi?id=1513 Bug1513])
|}
= Bugs being worked =
* <s> 1580: [https://www.nsnam.org/bugzilla/show_bug.cgi?id=1580 doxygen description] Hajime </s>
* 1594: [https://www.nsnam.org/bugzilla/show_bug.cgi?id=1594 gcov coverage test support for applications over DCE] Hajime
* <s> 1593: [https://www.nsnam.org/bugzilla/show_bug.cgi?id=1593 support DCE sub-module under myscripts directory] Hajime </s>
* <s>1448: [https://www.nsnam.org/bugzilla/show_bug.cgi?id=1448 DCE Kernel mode. Create a helper in order to create automatically the static routes.] Hajime </s>
* 1513: [https://www.nsnam.org/bugzilla/show_bug.cgi?id=1513 Use Linux kernel stack for ns-3 applications] Hajime
* 1455: [https://www.nsnam.org/bugzilla/show_bug.cgi?id=1455 Support the python binding of DCE] Hajime

= Pending code review =
* [https://codereview.appspot.com/6856090/ Bug1513: Use Linux kernel stack for ns-3 applications]
* [https://codereview.appspot.com/7635043/ Change Scheduling of event according to NS-3 requisite: ie use only the main thread to]

= Things to do =
* <s>migrate repository from 'furbani' to 'code'</s>
* migrate ns-3-linux and ns-3-linux-3 repository to github's one.
* create jenkins test suite
* fix valgrind errors (so many)
* test with document (quick start guide, user's guide)
* update web page (http://www.nsnam.org/projects/direct-code-execution/)
* nsnam.org/doc/dce (ask Tom?)