-
Notifications
You must be signed in to change notification settings - Fork 3
Link modeling using ns 3
- Introduction
- ns-3 emulation features
- Link simulation with ns-3
- Details
- How to achieve communication of ns-3 process with TAP interfaces in distinct namespaces?
- Code
- Mininet
- ns-3 optional patches
- Usage
- ns-3 downloading and building
- Running mininet scripts
ns-3 network simulator has ability to work in so called real-time/emulation mode. In that mode, the simulator can exchange packets in real-time with the outside world. It means, that packets originating from simulated nodes can be processed by a real network. Another possibility is to drive a simulated network with packets from real nodes. These two options are covered by two different kinds of ns-3 modules: FdNetDevice and TapBridge.
See more:
FdNetDevice can read and write from a file descriptor, which can be associated to a network device (via raw socket). This allows ns-3 simulations to read frames from and write frames to a network device on the host. Instead of an ns-3 channel connecting ns-3 nodes, real hardware provided by the testbed can be used. This allows ns-3 applications and protocol stacks attached to a simulation node to communicate over real hardware. The primary use for this configuration is to generate repeatable experimental results in a real-world network environment that includes all of the ns-3 tracing, logging, visualization and statistics gathering tools.
FdNetDevice case.
Nodes are simulated, the network is real.
+----------------------+ +-----------------------+
| host 1 | | host 2 |
+----------------------+ +-----------------------+
| ns-3 simulation | | |
+----------------------+ | Linux |
| ns-3 Node | | Network Stack |
| +----------------+ | | +----------------+ |
| | ns-3 TCP | | | | TCP | |
| +----------------+ | | +----------------+ |
| | ns-3 IP | | | | IP | |
| +----------------+ | | +----------------+ |
| | FdNetDevice | | | | | |
| | 10.1.1.1 | | | | | |
| +----------------+ | | + ETHERNET + |
| | raw socket | | | | | |
|--+----------------+--| | +----------------+ |
| | eth0 | | | | eth0 | |
+-------+------+-------+ +--------+------+-------+
10.1.1.11 10.1.1.12
| real network |
+----------------------------+
TapBridge allows a real host to participate in an ns-3 simulation as if it were one of the simulated nodes. It can be viewed as essentially an inverse configuration to the previous one. It allows host systems and virtual machines running native applications and protocol stacks to integrate with a ns-3 simulation. In this case ns-3 connects to a TAP virtual interface created on Linux host. Packets send by host to the TAP device are transmitted through the file descriptor to the ns-3 process. Next they are forwarded down by TapBridge to the ns-3 net device and transmitted over the ns-3 emulated channel. The typical use case for this environment is to analyse the behaviour of native applications and protocol suites in the presence of large simulated ns-3 network.
TapBridge case.
Nodes are real, the network is simulated.
+--------+
| Linux |
| host | +----------+
| ------ | | ghost |
| apps | | node |
| ------ | | -------- |
| stack | | | +----------+
| ------ | | | | node |
| TAP | |==========| | -------- |
| device | <----- IPC ------> | tap | | IP |
+--------+ | bridge | | stack |
| -------- | | -------- |
| ns-3 | | ns-3 |
| net | | net |
| device | | device |
+----------+ +----------+
|| ||
+---------------------------+
| ns-3 channel |
+---------------------------+
Two TapBridge net devices can be used to create emulated link between two TAP virtual interfaces. Two ghost nodes inside ns-3 need to be created. Each node should consist of a TapBridge and ns-3 net device. These net devices should be connected together by an emulated ns-3 channel. Each TapBridge should be connected to the proper TAP interface. These TAP interfaces can serve now as the endpoints of the emulated link.
+--------+ +--------+
| name | | name |
| space1 | | space2 |
| ------ | |--------|
| node | | node |
| ------ | |--------|
| stack | | stack |
| ------ | |--------|
| TAP | |==========| |==========| | TAP |
| device |<-fd->| tap | | tap |<-fd->| device |
+--------+ | bridge | | bridge | +--------+
| -------- | | -------- |
| ns-3 | | ns-3 |
| net | | net |
| device | | device |
+----------+ +----------+
|| ||
+---------------------------+
| ns-3 channel |
+---------------------------+
|<------------------------------->|
ns-3 process
The first question, which needs to be answered, is if it is possible to ns-3 process to communicate with TAP devices in two distinct network namespaces. And, if it is possible, how sequence of interface creation, connecting ns-3 to them, and moving them between namespaces should look like.
It turns out, that it is possible to establish connection between two TAP interfaces through ns-3 and maintain it after moving TAP interfaces to another namespaces. The sequence should look like the following:
- Create tap0 interface in the root namespace.
- Create tap1 interface in the root namespace
- Start ns-3, connect with tap bridges to the both interfaces and establish channel between these two nodes in ns-3.
- Move tap0 to namespace A.
- Move tap1 to namespace B.
So, at the end, there are:
- tap0 interface in the namespace A
- tap1 interface in the namespace B
- ns-3 process in the root namespace
Finally, we get a ns-3 process which provides a communication channel between namespace A and namespace B. Tested on Linux kernels 3.5 and 3.8.
Development branch: http://github.com/piotrjurkiewicz/mininet/tree/ns3-integration
A list of changes to the original mininet:
- added new module
mininet.ns3[mininet/ns3.py] - minor change in
Node.addIntf()[mininet/node.py] - added ns-3 related examples [examples/ns3/*]
You can follow the commits here: http://github.com/piotrjurkiewicz/mininet/commits/ns3-integration
- Download ns-3 source code: http://www.nsnam.org/releases/latest
- Unzip it:
tar xjf ns-allinone-3.*.tar.bz2 - Go to the directory containing ns-3:
cd ns-allinone-3.*/ns-3.*/ - Configure it:
./waf -d optimized --enable-sudo configure - You may be prompted for sudo password while building
- Build:
./waf build
- Run
sudo ./waf shellin order to let the ns-3 set appropriate environment variables - Go to the directory with mininet scripts
- Run a mininet script, for example:
python mininet/examples/ns3/emptynet-simple.py