Release Notes

Mini-NDN version 0.7.0 (Major changes since version 0.6.0)

Breaking Changes:

  • Install behavior regarding existing installation of dependencies has been reversed; by default, these are now ignored. This is meant to clear up confusion regarding installing on existing installs which have been used for NDN development previously. The previous behavior can be enabled using –use-existing.

New features:

  • Added NFDCBatch to NFDC helper, which allows the user to use the existing NFDC wrapper API to instead create and execute a batch file. When running large numbers of commands, this significantly speeds up performance due to not needing to add delay between individual CLI calls.

  • Added MinindnAdhoc class which can be used to construct adhoc Mini-NDN-Wifi networks from topology files.

  • Model mobility parameters can now also be passed to Mini-NDN-Wifi via topology files.

  • Working directory can be passed as constructor argument to Minindn objects

  • We have added a new –release flag to the installer which simplifies installing matching releases of dependencies. Reference the install documentation for more information.

  • Experimental wifi support for NLSR helper. See experiment docs <experiment> for details (issue: 5232)

  • Added a Dockerfile for Mini-NDN. A prebuilt image for linux/amd64 platforms is available on the GitHub container registry

  • The previous testbed topology generation script has been deprecated and removed. Please reference the NDN Play website for a replacement

Improvements:

  • Ethernet unicast faces are now supported natively by NLSR wrapper, NFDC wrapper, and NDN routing helper. No additional formatting by the user is needed for ethernet addresses extracted from the Mininet API when passed to these functions (issue: 5321)

  • NdnRoutingHelper has been parallelized along with minor optimizations. You can now also use it to create permanent faces (issue: 5264)

  • checkConvergence method of Experiment helper can now output more detailed information when flag returnConvergenceInfo is set (issue: 5236)

  • getPopen can now accept commands formatted as lists as well as strings

  • We now natively edit nfd.conf files using infoconv to read and write it as json rather than calling infoedit at the shell (issue: 5318)

  • Added Sprint PoP topology

  • Link bandwidth value (bw) can now be specified as decimal megabits rather than only integers in topology files

  • NFDC was significantly refactored for the NFDCBatch change.

Bug fixes:

  • NFDC helper properly supports existing faces and no longer outputs unnecessary error messages if face exists by default.

  • Fixed out of date ndnsec commands

  • Socket path now defaults to NFD default as of release 24.07. You can specify a different path with the defaultSocketLocation argument in the Nfd object constructor (issue: 5309)

  • Fixed jitter being parsed into incorrect type from topology files

  • Moved vestigial CLI arguments relating to wifi_ping.py example out of the Mini-NDN-Wifi class

Mini-NDN version 0.6.0 (Major changes since version 0.5.0)

Breaking Changes:

  • Rewrite install script (issue: 4630)

    • Set dependency versions: PPA, git repository & commit

    • Separate download and build+install steps

    • Don’t reinstall package if it’s already installed

    • More details here

  • Note: We have dropped support for python 2, the latest Mini-NDN requires at least python 3.0

New features:

  • Update Mini-NDN codebase with Mini-NDN-Wifi code (issue: 4858)

  • Provide pre-built Mini-NDN Vagrant box and Docker container

  • Added several new examples:

  • consumer/producer

  • ndnping

  • traffic generator

  • catchunks/putchunks

  • Allow for creation of net object without topology (issue: 5162)

Improvements and Bug Fixes:

  • Support running NDN applications on mixed topologies (issue: 5160)

  • Support route addition using face-id in Nfdc helper (issue: 5130)

  • Add wrapper for ndnpingserver and fix passing the Mininet host object as a prefix on ndnpingclient

  • Show status of route calculation in NdnRoutingHelper

  • Incorporate changes of NDNPing Class (wrapper of pingserver and pingclient) in the examples

  • Support simple topology files with no additional parameters

Mini-NDN version 0.5.0 (Major changes since version 0.4.0)

Breaking Changes:

  • Mini-NDN re-design: simple and robust design with better quality, control, and more consistency with Mininet

New features:

  • Add a script to generate up-to-date NDN testbed topologies for Mini-NDN

  • Add Mini-NDN utility application for PCAP logging

  • Add NDN routing helper to compute centralized LS and HR routes

  • Add routing helper to allow IP communication in experiments

  • Add startup experiments for NLSR and current testbed topology

  • Move the NDNPing wrapper method to a helper class

  • Create a helper class to provide a wrapper around nfdc

Improvements and Bug Fixes:

  • Change workDir and resultDir to be class attribute

  • Quiet apt install for Vagrant

  • Fix route computation bug in ndn_routing_helper

  • Fix overwriting of existing prefixes in ndn_routing_helper

  • Move log files to resultDir after evaluation finishes

  • Check for duplicate HR coordinates in the topology file

  • Check PSync integration and add a tests case for it

  • Bug fixes in nfdc and experiments

  • Added functionality to check Mini-NDN dependencies

  • Parser fix to avoid an infinite loop

  • Allow use of NFD and NLSR PPA with Mini-NDN

  • Remove arbitrary arguments in favor of parsing arguments from experiment files

  • Auto-complete command-line arguments

  • Add option to set CS size

  • Adjust to use ndn-cxx logging

Mini-NDN version 0.4.0 (changes since version 0.3.0)

Release date: January 10, 2018

New features:

  • Use SIGQUIT to quit Mini-NDN, SIGINT to kill programs

  • Use Infoedit to edit NFD and NLSR configuration files

  • Use nlsr.conf installed in the system

  • Provide a Vagrantfile to setup Mini-NDN and NDN

  • Provide option to disable NLSR

  • Provide an option to run NLSR in dry-run mode

  • Add option to specify whether to use TCP or UDP face in nlsr.conf

  • Add option to specify arbitrary arguments to use in experiments

  • Include a single option to install Mini-NDN and all the dependencies

Bug fixes:

  • Fix “key does not exist error” after NLSR starts

  • Update install.sh to call ldconfig after installing ChronoSync

  • Add hyperbolic coordinates to default topology

Misc changes:

  • Add an experiment to test nlsrc

  • Create faces in NFD for each neighbor in NLSR

  • Update to latest ndn-cxx

  • Use /tmp/minindn folder as default work dir instead of /tmp

Mini-NDN version 0.3.0 (changes since version 0.2.0)

Release date: March 3, 2017

New features:

  • Mini-NDN cluster edition

  • New experiments for making NLSR testing easier

Bug fixes:

  • Set site name correctly

  • Install missing certificates in NLSR security config

  • Fix quitting of NLSR due to key not found error

Misc changes:

  • Removed nlsr.conf file, generate it within the code

  • Use argparse instead of deprecated optparse

  • Update security config section for NLSR

  • Change mininet prompt to mini-ndn

  • Set network name at one place

  • Update install.sh script to install openssl

  • Update install.sh script to install cryptopp from package instead of compiling from source

  • Update install.sh to clean build folder every time to get rid of removed files such as old experiments

  • Fix old code - use net.hosts instead of storing hosts in a variable

  • Use nfdc instead of deprecated nfd-status

Mini-NDN version 0.2.0 (changes since version 0.1.1)

Release date: August 18, 2016

New features:

  • Automatic security configuration for NLSR

  • Use /usr/local/etc/ndn/nfd.conf as default config file for NFD

  • Class to monitor /proc/$PID/stat file for PID

  • Mini-NDN exits gracefully on SIGINT and non-convergence

  • Faster Mini-NDN install script - does not do apt-get update everytime

  • NLSR is launched with explicit config file for easier process identification

  • Add and update more documentation

Bug fixes:

  • NFD is killed correctly on exit

  • Best route strategy is set correctly

Mini-NDN version 0.1.1 (changes since version 0.1.0)

Release date: November 4, 2015

New features:

  • Use nfd.conf.sample from currently installed NFD

  • Add working directory option to allow execution environment outside of /tmp

  • Add results directory option to store experiment results after completion

  • Add support for switches in GUI and configuration file

  • Add failNode and recoverNode methods to Experiment class

  • Add most connected node (MCN) failure experiment

  • Add option to specify percentage of nodes pinged

Code changes:

  • Refactor program options into container class

  • Remove unused “FIB Entries” option from NDN host options

Bug fixes:

  • Abort start up if experiment name is invalid

  • Restart pings after recovery in failure experiment

Mini-NDN version 0.1.0 (initial release)

Release date: July 15, 2015

Mini-NDN is a lightweight networking emulation tool that enables testing, experimentation, and research on the NDN platform. Based on Mininet, Mini-NDN uses the NDN libraries, NFD, NLSR, and tools released by the NDN project to emulate an NDN network on a single system.

Included features:

  • Run a complete NDN network on a single system

  • Automatic configuration of NLSR to provide a routable NDN network

  • Supports user created NDN applications

  • Create a topology using the included Mini-NDN Edit GUI application

  • Allows individual configuration of NFD and NLSR parameters for each node

  • Provides an experiment management framework for easy creation of custom networking experiments

  • Uses a simple topology file format to define hosts, links, and configuration values

  • Configure network link parameters including bandwidth, delay, and loss rate

  • Includes a pre-configured topology file to replicate the NDN testbed