Difference between revisions of "Ns-3.22"

From Nsnam
Jump to: navigation, search
(week of January 26)
(week of January 26)
Line 77: Line 77:
 
== week of January 26 ==
 
== week of January 26 ==
  
Try to complete any bug fixes and core improvements by <s>Friday Jan 30</s> Saturday Jan 31.
+
Try to complete any bug fixes and core improvements by <s>Friday Jan 30</s> Sunday Feb 1. Planning to publish a release candidate on Monday Feb 2.
 
+
Here are a couple more things I want to do (Saturday?) before freezing ns-3.22 and posting a release candidate:
+
 
+
* add Sebastien's examples in 2050 and 2054
+
* add Tommaso's lr-wpan patch in 1744
+
* create the ns-3.22 repo, and extend bakeconf.xml so Hajime can start to prepare DCE-1.5
+
* look into the new TCP bug 2053, fix if a simple fix as suggested
+
* (time permitting) try to further validate the TCP RTO fix bug 2041
+
  
 
1) New features
 
1) New features
  
All ns-3.22 new features are merged, except for wifi A-MPDU and Tv transmitter module, which are ready to go once we complete signoff.  
+
All ns-3.22 new features are merged, except for <s>wifi A-MPDU</s> and Tv transmitter module, which are ready to go once we complete signoff.  
 +
** A-MPDU is merged, but Tv transmitter will be held back
  
 
2) Bugs and enhancements
 
2) Bugs and enhancements
Line 95: Line 88:
 
The following bugs/enhancements are being currently worked on:
 
The following bugs/enhancements are being currently worked on:
  
* [https://www.nsnam.org/bugzilla/show_bug.cgi?id=2054 2054 update ht-wifi-network program]
+
* <s>[https://www.nsnam.org/bugzilla/show_bug.cgi?id=2054 2054 update ht-wifi-network program]</s>
** '''Status (01/30/15):''' patch pending; plan to merge on 1/31/15
+
** '''Status (2/1/15):''' merged
* [https://www.nsnam.org/bugzilla/show_bug.cgi?id=2053 2053 Tcp wrong NotifyDataSent]
+
* <s>[https://www.nsnam.org/bugzilla/show_bug.cgi?id=2053 2053 Tcp wrong NotifyDataSent]</s>
** '''Status (01/30/15):''' investigating
+
** '''Status (2/1/15):''' fixed
* [https://www.nsnam.org/bugzilla/show_bug.cgi?id=2050 2050 add A-MPDU example program]
+
* <s>[https://www.nsnam.org/bugzilla/show_bug.cgi?id=2050 2050 add A-MPDU example program]</s>
** '''Status (01/30/15):''' patch pending; plan to merge on 1/31/15
+
** '''Status (2/1/15):''' merged
 
* <s>[https://www.nsnam.org/bugzilla/show_bug.cgi?id=2046 2046 wifi block ack configuration]</s>
 
* <s>[https://www.nsnam.org/bugzilla/show_bug.cgi?id=2046 2046 wifi block ack configuration]</s>
 
** '''Status (01/30/15):''' fixed
 
** '''Status (01/30/15):''' fixed
Line 117: Line 110:
 
* <s>[https://www.nsnam.org/bugzilla/show_bug.cgi?id=1801 1801 wifi attribute setting]</s>
 
* <s>[https://www.nsnam.org/bugzilla/show_bug.cgi?id=1801 1801 wifi attribute setting]</s>
 
** '''Status (01/26/15):''' fixed
 
** '''Status (01/26/15):''' fixed
* [https://www.nsnam.org/bugzilla/show_bug.cgi?id=1774 1774 wpan spectrum propagation loss]
+
* [https://www.nsnam.org/bugzilla/show_bug.cgi?id=1774 1774 wpan spectrum propagation loss]</s>
** '''Status(01/26/15):'''  patch pending
+
** '''Status(2/1/15):'''  fixed
* [https://www.nsnam.org/bugzilla/show_bug.cgi?id=1604 1604] (provide Config::GetDefault)
+
* <s>[https://www.nsnam.org/bugzilla/show_bug.cgi?id=1604 1604] (provide Config::GetDefault)
 
**'''Status (01/26/15):''' will slip to next release
 
**'''Status (01/26/15):''' will slip to next release
 
* [https://www.nsnam.org/bugzilla/show_bug.cgi?id=761 761 (wifi) non standards compliant timeout values]
 
* [https://www.nsnam.org/bugzilla/show_bug.cgi?id=761 761 (wifi) non standards compliant timeout values]

Revision as of 05:01, 2 February 2015

Main Page - Current Development - Developer FAQ - Tools - Related Projects - Project Ideas - Summer Projects

Installation - Troubleshooting - User FAQ - HOWTOs - Samples - Models - Education - Contributed Code - Papers

This page summarizes the release planning for ns-3.22. The ns-3 release process is listed here and here.

How you can help

The release manager is Tom Henderson. Please contact him if you would like to participate in any way in preparing the ns-3.22 release.

If you are interested in testing a particular feature that is planned for ns-3.22, see the section on this page for testing repos.

If you are interested in helping with a code review of a specific feature that you'd like to see in ns-3.22, please leave your comments on the code review pertaining to the feature of interest.

If you are interested to see that a specific bug be fixed, please email ns-developers mailing list, or the release manager. You will probably be asked to help with creating a patch or testing an existing patch for that bug, if so.

Release goals

1) make a major dent in the bug tracker. Can we clean out most issues on our actively maintained modules, including closing out feature requests for which we do not have anyone working on them?

2) continue the transition to a more modular build system. While a major change to the build system is not planned for ns-3.22, one goal is to start to allow modules outside the core of ns-3 to be maintained in separate places, and integrated using the 'bake' tool (rather than merge everything into ns-3-dev).

3) merge (into ns-3-dev or to a bake-enabled repository) as many new features as we can get ready, including all remaining features from 2013 and 2014 GSOC and SOCIS projects, and 2014 summer projects

Release and development schedule

ns-3.22 is planned for early February 2015.

Already done items:

The following features will be deferred to ns-3.23 (code seems mostly complete, but is lacking complete tests/examples/documentation):

  • Full duplex CSMA
  • TCP satellite extensions

week of January 26

Try to complete any bug fixes and core improvements by Friday Jan 30 Sunday Feb 1. Planning to publish a release candidate on Monday Feb 2.

1) New features

All ns-3.22 new features are merged, except for wifi A-MPDU and Tv transmitter module, which are ready to go once we complete signoff.

    • A-MPDU is merged, but Tv transmitter will be held back

2) Bugs and enhancements

The following bugs/enhancements are being currently worked on:

Packaging

ns-3.22 will be packaged as a source tarball as before: ns-allinone-3.22.tar.bz2.

The tarball will contain:

  • Latest version of pybindgen
  • Latest version of netanim
  • ns-3.22
  • bake

where bake is used to fetch optional ns-3 components, including DCE.

A patch from ns-3.21 to ns-3.22 will also be posted.

Whether ns-3.22 is prepared in other packaging (e.g. Debian) would require a volunteer to prepare this.

Whether ns-3.22 will be distributed also as a Docker container would require a volunteer to prepare this.

Release platforms

We usually try to keep pace with the latest popular versions of Linux, OS X, and FreeBSD. For the ns-3.22 release, we plan to support the following systems and compilers:

  • OS X 10.10 Yosemite with latest Xcode
  • Ubuntu 14.04 and 14.10 (gcc-4.8, 4.9)
  • Fedora 20 and 21 (gcc-4.8, 4.9)
  • Debian 7 (gcc-4.9)
  • FreeBSD 10.1 (clang 3)
  • CentOS 6.6 (gcc-4.4.7)
  • some legacy platforms (to be determined); likely older Ubuntu LTS and CentOS systems, and OS X 10.9

Testing repos

Some repositories, based on a recent copy of ns-3-dev, are available for testing specific features.

WAVE and vehicular networks

A repository to test 1609.4 WAVE code and vanet-routing-compare example features is available here:

$ ./waf --run vanet-routing-compare $ ./waf --run wave=simple-device $ ./test.py -s wave-mac-extension

Mobility Service Interface

Tiago Cerqueria has posted some code that uses Google Maps and Directions API to fetch waypoints for the ns-3 waypoint mobility model, corresponding to real-world routes provided by the service. There is a testing repository available for this code (the patchset in https://codereview.appspot.com/176430044/ is too large to download from Rietveld). To test, one must obtain an API key from Google, as described in the code review issue. One must also have installed GeographicLib, xerces-cpp, libcurl, and libdl.

hg clone http://code.nsnam.org/ns-3-dev
cd ns-3-dev/src
hg clone http://code.nsnam.org/tomh/mobility-service-interface
cd mobility-service-interface
mkdir conf
# copy your API key to this conf directory as described here https://codereview.appspot.com/176430044/
cd ../../
./waf configure ...

CSMA full duplex

There was a previous code review issue on a switched ethernet device, which gradually led to an alternative proposal to extend the existing CSMA model (half-duplex) to full duplex. There is now a separate code review issue for this patch. The following repo is being kept in sync with the codereview issue.

hg clone http://code.nsnam.org/tomh/ns-3-dev-csmafd

MPDU aggregation

Sebastien Deronne is working on preparing a testing repository; should be available shortly.

New features

Developers are working or planning to work on the following new features for ns-3.22. Note: there is no guarantee that the features will be finished by the end of the year, so check back for progress/status.

Changes to the simulation core

Higher priority:

Lower priority:

Others to be determined

Statistics

  • Add a basic statistics collector, and convert some existing stats helpers in LTE and WiFi to use the statistics framework (Tom Henderson and Li Li)

Internet module

A number of changes relate to supporting AQM and ECN. This code may end up in the internet module or a new 'internet-queues' module.

Status: Tom Henderson is working on progressing the idea to add a TC sublayer, socialized by Natale Patriciello on the ns-developers list here: http://mailman.isi.edu/pipermail/ns-developers/2014-November/012398.html

TCP

The following were mentioned in the past but don't seem to be actively worked at the moment:

WiFi

Vehicular networks

status: There is a 'testing repository' available to test Scott's example and Junling's WAVE code; see Ns-3.22#Testing_repos.

Delay-tolerant networking

Status: No recent activity; will likely slip another release cycle.

DSR

Status: Tomasz is working on addressing the review comments

CSMA improvements

Status: Tom Henderson posted a testing repository for the full duplex feature.

Epidemic Routing

Status: Still undergoing code review revisions.

UAN WOSS

Satellite models

Status: There hasn't been any recent activity so this will likely slip another release

Spectrum module

Status: Seems to be nearing completion; needs review from Nicola.

Nix vector routing

Status: under review

Software maintenance issues

Documentation improvements

others to be determined

Bugs or issues in ns-3 core

Bugs in models to fix

To be determined