Difference between revisions of "Ns-3-Network-Simulator/C2/Creating-Point-to-Point-Network-in-ns-3/English"

Title Slide

Learning Objectives

• About structure of an ns-3 program
• About the classes and the methods
• To create nodes
• To establish a point-to-point connection between two nodes
• To configure client and server applications on the nodes
• To visualize the network using NetAnim

System Requirements

• Ubuntu Linux operating system version 22.04
• ns-3.38
• NetAnim visualizer tool

Prerequisite

https://www.spoken-tutorial.org

• You must have basic knowledge of using Linux terminal
• For pre-requisite Linux tutorials, please visit this website

Code files

• The files used in this tutorial are provided in the Code files link.
• Please download and extract the files.
• Make a copy and then use them while practicing.

Point-to-Point Topology

In this network, Node 0 is the transmitter and node 1 is the receiver.

Now we will go through the source code in the text editor.

The source code contains the required functions to implement a point-to-point network.

#include "ns3/applications-module.h"

#include "ns3/core-module.h"

#include "ns3/internet-module.h"

#include "ns3/network-module.h"

#include "ns3/point-to-point-module.h"

#include "ns3/netanim-module.h"

#include "ns3/mobility-helper.h"

#include "ns3/mobility-model.h"

It is used to get optional arguments for the program from the command line.

In this program we would not be using any optional argument.

The first argument is the number of arguments to parse.

The second argument is the array of arguments.

A NodeContainer class instance is used to store nodes in the network.

Create an instance of the PointToPointHelper class with the name pointToPoint.

PointToPointHelper is a topology helper class.

Helper class instances assist in creating and initializing networks.

Here we set the data rate of the devices to 100 Mbps.

We set the delay of the communication channel to 6560 nanoseconds.

We need to install net devices on the nodes.

So we create a container for the net devices.

The NetDeviceContainer class instance holds net devices.

The InternetStackHelper class instance installs internet stack on the nodes.

The nodes are passed as the parameter, to the Install method,

Let's set the base IP address for the network using the SetBase method.

The Ipv4InterfaceContainer class instance stores the interfaces.

An echo server receives data from its client and echoes it back.

It takes an integer as a parameter that represents the port number. ] Here, we create an instance of UdpEchoServerHelper with port number 9.

Create an ApplicationContainer instance named serverApps.

Install a server application on the second node of the network with index 1.

Set the start time of the applications to 1 second.

Set the stop time to 10 seconds.

The time values are counted from the start of the simulation.

An echo client sends data to an echo server.

The constructor takes two parameters.

The first one is the interface on which the application is to be installed.

The second is the port number.

Let’s create the client application helper instance.

The attributes are the client node and port number.

The attributes include packet size, number of packets etc.

Hence here we set the maximum number of packets, to 10.

Here the value is 0.5 seconds.

Here the start time is 2 seconds from the start of the simulation.

The details about mobility shall be covered in future tutorials.

The AnimationInterface class instance creates an XML file.

This file would be imported into NetAnim for animation.

The constructor takes the file name as a parameter.

Here the name of the file is point-to-point.xml.

Using the anim object, we set the position for both the nodes.

The first argument is the node whose position is being set.

The second argument is the X coordinate.

The third argument is the Y coordinate.

Now close the text editor.

Type cd ns-allinone-3.38/ns-3.38 to navigate to the ns3 installation directory

Type mv ~/Downloads/point-to-point.cc scratch/point-to-point.cc to move the source file to scratch directory.

Open the terminal by pressing Ctrl,Alt and T keys simultaneously.

Using the cd command, navigate to the installation directory of ns-3.

Go to the ns-3.38 directory.

Move your source file to the scratch directory.

The ns3 batch file is configured to run files from the scratch directory.

point to point dot cc is the name of the source file.

Type cd ~/ns-allinone-3.38/netanim

Navigate to the netanim directory under ns-allinone-3.38.

Select the point-to-point.xml file.

Click on open at the bottom.

Select size 10.

We see the circles representing the nodes.

The lines with arrows represent the transfer of packets.

Summary

Let us summarize.

In this tutorial, we have learnt

• About the structure of an ns-3 program
• About the classes and the methods
• To create nodes

Summary

• To establish a point-to-point connection between two nodes
• To configure client and server applications on the nodes
• To visualize the network using NetAnim

Assignment

• Write an ns-3 program with two point-to-point networks
• Set IP address 10.1.0.0 for the first network
• Set IP address 10.2.0.0 for the second network

Assignment

• Set different values for data rate, delay and packet size for each network
• Install client and server applications in each network

Assignment

• Start transfer of packets in each network simultaneously
• Generate an XML file for NetAnim animation

• Run the simulation in the terminal
• Import the XML file in NetAnim and play the animation

Assignment - Observation

• In the terminal, you will get this output.
• Observe the differences for the two networks.

Assignment - Observation

• In the NetAnim window, you will see two different networks.
• Observe the packet transfer rate for each network.

About the Spoken Tutorial Project

Please download and watch it.

Spoken Tutorial Workshops

For more details, please write to us.

Answers for THIS Spoken Tutorial

FOSSEE Forum

Acknowledgement

Acknowledgement

We would also like to thank Dr. R. Radha, Dr. X. Anita, and Dr. T. Subbulakshmi from VIT, Chennai for their support.

Thank You

Thanks for joining.