Please see Installation Page for instructions on installing Mini-NDN and its dependencies.
To run Mini-NDN with the default topology,
A full list of options can be printed by using:
sudo minindn --help
To run Mini-NDN with a topology file, provide the filename as the first argument:
sudo minindn my-topology.conf
During set up, the list of nodes in the network will be listed as they are initialized:
*** Adding hosts: a b c d
After set up, the command-line interface (CLI) will display a prompt.
To interact with a node, first type the node’s name and then the command to be executed:
mini-ndn> a echo "Hello, world!" Hello, world!
To see the status of the forwarder on the node:
mini-ndn> a nfdc status report
To see the status of routing on the node:
mini-ndn> a nlsrc status
To exit Mini-NDN, type
quit in the CLI:
For a more in depth explanation of the CLI, please see the Mininet Walkthrough.
To run Mini-NDN with a replica of the NDN testbed, use the
sudo minindn --testbed
To change the working directory from default
/tmp following option can be used:
sudo minindn --work-dir /home/mydir/test
To run NLSR with hyperbolic routing enabled, use the
sudo minindn --hr
Topology files given under ndn_utils/topologies/minindn* have hyperbolic coordinates configured and can be used with this option.
To configure the max number of faces added by NLSR to reach each name prefix, use the
sudo minindn --faces 3
--faces can be an integer from 0 to 60; 0 indicates NLSR can add all available faces.
To run Mini-NDN with NLSR security configured
sudo minindn --nlsr-security
Working Directory Structure
Currently Mini-NDN uses /tmp as the working directory if not specified otherwise by using the option –work-dir.
Each node is given a HOME directory under /tmp/node-name where node-name is the name of the node specified in the [nodes] section of the conf file.
NFD conf file is stored at
NFD log file is stored at
.ndn folder is stored at
NLSR conf file is stored at
NLSR log file is stored at
When security is enabled, NLSR security certificates are stored in:
Note that no NLSR publishes the root certificate, Mini-NDN installs root.cert in security folder for each NLSR.