Features/Ns3

From FedoraProject

< Features(Difference between revisions)
Jump to: navigation, search
(Moved to FeatureAcceptedF17 - feature was accepted at 2011-10-31 meeting.)
(Things are progressing along nicely.)
Line 5: Line 5:
 
Design packaging scheme for ns-3 network simulator and provide it in Fedora.
 
Design packaging scheme for ns-3 network simulator and provide it in Fedora.
  
Pretty usable spec file (C++ and Python simulations work) for ns version 3.12.1 is available: [http://www.inf.uniri.hr/~vmiletic/ns-3/ns.spec ns.spec], missing: nsc, click, openflow
+
Pretty usable spec file (C++ and Python simulations work) for ns-3 version 3.13 pulled from hg repository is available: [http://www.inf.uniri.hr/~vmiletic/ns-3/ns3.spec specfile], still missing: nsc (TODO), click (TODO), openflow (might consider it when/if Blake Hurd's changes go upstream, see below), versioned libraries and pkgconfig files to allow multiple version installs, installing both normal and optimized version
 +
 
 +
To use it, you must:
 +
* manually rename ns-3-allinone to ns-allinone-3.13
 +
* manually rename ns-3-dev to ns-3.13
 +
* change ns-allinone-3.13/ns-3.13/VERSION from 3-dev to 3.13
 +
* make an archive
 +
tar cvjf ns-allinone-3.13.tar.bz2 ns-allinone-3.13
  
 
== Owner ==
 
== Owner ==
Line 15: Line 22:
  
 
* Targeted release: [[Releases/17 | Fedora 17]]  
 
* Targeted release: [[Releases/17 | Fedora 17]]  
* Last updated: 2011-07-04
+
* Last updated: 2011-12-05
* Percentage of completion: 70%
+
* Percentage of completion: 80%
  
 
== Detailed Description ==
 
== Detailed Description ==
Line 51: Line 58:
 
Definitly needed:
 
Definitly needed:
 
* everything mentioned in [http://www.nsnam.org/wiki/index.php/Installation#Fedora.2FRedHat Fedora installation at nsnam wiki]
 
* everything mentioned in [http://www.nsnam.org/wiki/index.php/Installation#Fedora.2FRedHat Fedora installation at nsnam wiki]
* [http://code.google.com/p/waf/ waf], already in Fedora (ns-3 uses customized waf 1.5.16; probably not a problem, since it's bundled with ns-3 and needed only for building)
+
* [http://code.google.com/p/waf/ waf], already in Fedora (ns-3 version 3.13 uses customized waf 1.6.7; probably not a problem, since it's bundled with ns-3 and needed only for building)
 +
* [https://launchpad.net/pybindgen PyBindGen], bundled in ns-3-allinone
 +
 
 +
Not needed but will package:
 
* [http://research.wand.net.nz/software/nsc.php NSC], bundled in ns-3-allinone
 
* [http://research.wand.net.nz/software/nsc.php NSC], bundled in ns-3-allinone
 +
* [http://www.read.cs.ucla.edu/click/ Click Modular Router] ([https://bugzilla.redhat.com/show_bug.cgi?id=709082 bug 709082])
  
 
Possibly needed:
 
Possibly needed:
* [https://launchpad.net/pybindgen PyBindGen ], bundled in ns-3-allinone
 
* [http://www.read.cs.ucla.edu/click/ Click Modular Router] ([https://bugzilla.redhat.com/show_bug.cgi?id=709082 bug 709082])
 
 
* [http://www.openflow.org/ OpenFlow], [http://code.nsnam.org/bhurd/openflow Blake Hurd's modified OpenFlow that works with ns-3]
 
* [http://www.openflow.org/ OpenFlow], [http://code.nsnam.org/bhurd/openflow Blake Hurd's modified OpenFlow that works with ns-3]
 
* [http://lxc.sourceforge.net/ LXC], already in Fedora
 
* [http://lxc.sourceforge.net/ LXC], already in Fedora
Line 62: Line 71:
  
 
Would be cool to have:
 
Would be cool to have:
* [http://memebase.com/2011/09/06/memes-introducing-terrible-teacher/ NetAnim 2.0]
+
* [http://www.nsnam.org/wiki/index.php/NetAnim NetAnim 2.0]
 
* [http://yans.pl.sophia.inria.fr/trac/nepi NEPI/NETNS/NEF]
 
* [http://yans.pl.sophia.inria.fr/trac/nepi NEPI/NETNS/NEF]
  

Revision as of 20:49, 5 December 2011

Contents

ns-3 Network Simulator

Summary

Design packaging scheme for ns-3 network simulator and provide it in Fedora.

Pretty usable spec file (C++ and Python simulations work) for ns-3 version 3.13 pulled from hg repository is available: specfile, still missing: nsc (TODO), click (TODO), openflow (might consider it when/if Blake Hurd's changes go upstream, see below), versioned libraries and pkgconfig files to allow multiple version installs, installing both normal and optimized version

To use it, you must:

  • manually rename ns-3-allinone to ns-allinone-3.13
  • manually rename ns-3-dev to ns-3.13
  • change ns-allinone-3.13/ns-3.13/VERSION from 3-dev to 3.13
  • make an archive
tar cvjf ns-allinone-3.13.tar.bz2 ns-allinone-3.13

Owner

Current status

  • Targeted release: Fedora 17
  • Last updated: 2011-12-05
  • Percentage of completion: 80%

Detailed Description

"ns-3 is a discrete-event network simulator for Internet systems, targeted primarily for research and educational use. ns-3 is free software, licensed under the GNU GPLv2 license, and is publicly available for research, development, and use.

ns-3 is intended as an eventual replacement for the popular ns-2 simulator." (ns-3 home page)

For now, we package ns-3.11, but it's very likely that ns-3.13 will be available in time for Fedora 17, so we will upgrade to that. The reason why we choose to target Fedora 17 instead of Fedora 16 is to take time to work with upstream on fixing issues in the installation process, so it's highly likely that we will be able to package ns-3 without any extra patches.

Benefit to Fedora

Fedora will be more attractive to researchers, teachers and students in field of computer networks since it will be much easier to install and use ns-3.

ns-2 is widely used in academia, and it's expected that ns-3 will follow that suit. There are already a couple of courses using ns-3. (Tom Henderson keynote at WNS3 2011 mentions three, but there are at least three more: CS641 at Indian Institute of Technology Bombay, S-38.2188 at Aalto University, CS640 at Brigham Young University)

Scope

This is an isolated change, that requires adding packages to Fedora. ns-3 has quite some dependancies, and most of them are already in Fedora (see below).

How To Test

Tests and scripts used for testing simulator itself are provided in ns-3 and can also be packaged.

No special hardware or software is required; testing is handled by ns-3's test.py script that builds tests and executes them.

User Experience

Researchers, teachers and students will be able to install ns-3 much easier.

Dependencies

Definitly needed:

  • everything mentioned in Fedora installation at nsnam wiki
  • waf, already in Fedora (ns-3 version 3.13 uses customized waf 1.6.7; probably not a problem, since it's bundled with ns-3 and needed only for building)
  • PyBindGen, bundled in ns-3-allinone

Not needed but will package:

Possibly needed:

Would be cool to have:

Contingency Plan

Release without ns-3 included.

Documentation

Release Notes

ns-3 is a discrete-event network simulator for Internet systems, targeted primarily for research and educational use. ns-3 is now included in Fedora. This makes it easier for researchers, teachers and students in field of computer networks to install it and use it.

Comments and Discussion