wiki:NetServTutorialInstruction

Version 17 (modified by jae@cs.columbia.edu, 13 years ago) (diff)

draft of layer 2 scenario added

NetServ tutorial: step-by-step instruction

Preparation

  1. Start the provided VM and login as the geni user.
  1. Open the tutorial slides found at:

/home/geni/Tutorials/NetServ/gec-tutorial/tutorial/NetServTutorialSlides.pdf

Go to slide number 7 and leave it there for reference.

  1. Open Firefox and point it to the following URL:

http://pc519.emulab.net/visual/index.html?id=50

Please note that you must replace "50" with your own user number throughout this tutorial.

  1. You will see the traffic visualization in your browser as follows:

Install NetServ module

  1. Open a terminal window, update NetServ software, and go to your NetServ user directory.
cd /netserv-root
svn up
./build-netserv-gec-tutorial.sh

cd tutorial/user50
ls -l
  1. The following files have been prepared for each user:
Makefile
NetServ/Example.java
example.mf

upload.sh
setup.sh
remove.sh

setup-request-1.txt
setup-request-2.txt
setup-request-3.txt
remove-request.txt

request-signer
private-key-50.pem
public-key-50.pem
  1. Build the Example module and upload it to the NetServ repository.
make
./upload.sh
  1. Send a SETUP message to the NetServ router to install the module.

While you are watching the browser window type the following command into the terminal window.

./setup.sh 1

The traffic will be redirected to D2 (the node on the lower right) and NetServ.Example will be added to the list of NetServ modules currently installed.

  1. The SETUP message looks like this:
$ cat setup-request-1.txt 
SETUP NetServ.Example_1.0.0 NETSERV/0.1
url: http://pc487.emulab.net/modules/user50/example.jar
user: user50
ttl:  600
filter-ipv4: 10.10.2.2
filter-proto: udp
filter-port: 20050
properties: debug = false, ip = 10.10.3.2

  1. Send a REMOVE message to the NetServ router to remove the module.
./remove.sh
  1. The REMOVE message looks like this:
$ cat remove-request.txt 
REMOVE NetServ.Example_1.0.0 NETSERV/0.1
user: user50

Develop NetServ module

  1. Open Example.java with gedit or your favorite editor.
gedit NetServ/Example.java &

Example.java is a typical NetServ packet processing module and it extends the NetServ.BuildingBlock.service.PktProcessorActivator class.

  1. Modify Example.java.

Comment out processPkt() marked as scenario #1, and uncomment processPkt() scenario #2.

  1. Compile and upload the new version of the module.
make
./upload.sh
  1. While you're watching the browser screen, install the module into the NetServ router with the following command.
./setup.sh 2

Note that the "2" argument will make the script send setup-request-2.txt, which includes two IP addresses in the properties header.

$ cat setup-request-2.txt 
SETUP NetServ.Example_1.0.0 NETSERV/0.1
url: http://pc487.emulab.net/modules/user50/example.jar
user: user50
ttl:  600
filter-ipv4: 10.10.2.2
filter-proto: udp
filter-port: 20050
properties: debug = false, ip = 10.10.2.2  10.10.3.2

  1. Update the module properties by sending another SETUP message.

By sending a SETUP message for a module that is already installed, you can update its properties and refresh its TTL.

Try sending setup-request-3.txt to the NetServ router:

./setup.sh 3

This SETUP request contains a non-existing IP address as the packet destination, which will make the NetServ node drop the incoming packets.

  1. Example.java also contains an embedded web server. Thus, it is not only a packet processing module but also a server module. The embedded web server is started when the module is installed (in initialize() method) and stopped when the module is removed (in cleanup() method). See the startHttpServer() method for what the web server does.
  1. Open a new tab on your browser and go to the following URL (replace "XX" with your own user number):

http://pc508.emulab.net:80XX

The embedded web server will respond with the current packet count as shown below.

screenshot of the embedded webserver html page

Run NetServ node locally

  1. Open another terminal window and start the NetServ router.

Type the "GENI User" password when asked.

cd /netserv-root/core/linux/
sudo su
.  setenv-i386-ubuntu
./run-controller.sh  conf-default.xml

The conf-default.xml file specifies a sample configuration for a single container.

  1. Open two more terminal windows (they don't have to be big).

On one window, start Netcat in server mode, listening on UDP port 22222:

nc -u -l 22222

On the other window, start Netcat in client mode, connecting to the UDP port 22222 on the localhost:

nc -u 127.0.0.1 22222

Test the chat-like connection by typing something in the Netcat client window. You should see the same characters appear on the server window.

  1. Open another terminal window and build the UDPEcho module.
cd /netserv-root/apps/udpecho/modules
make
  1. Install the UDPEcho module into the local NetServ router.
cd test
./setup.sh

You can switch to the NetServ router window and see the log output of the installation process.

  1. See UDPEcho in action!

Type something in the Netcat client window and see what happens. See also the debugging output from the UDPEcho module in the NetServ router window.

  1. Remove the UDPEcho module.
./remove.sh

Type something again in the Netcat client window and see what happens.

(Optional) Process Layer 2 frames in NetServ

compile with layer 2 functionality

NETSERV_TRANSPORT=tap make all

set up TAP interface

ip link set netserv101 up ip add 10.0.0.1/24 dev netserv101

check the interface

ifconfig

set up a manual ARP table entry for a fake address

arp -s 10.0.0.99 01:02:03:04:05:06

install udp echo

ping 10.0.0.99

remove and setup again

Please take a quick survey

A very quick survey. :-)

https://spreadsheets.google.com/spreadsheet/viewform?formkey=dGxxWFA1ckwxdWxaYlR5M3NvdjA2REE6MQ

Further information

NetServ home page:

http://www.cs.columbia.edu/irt/project/netserv/

Mailing list:

https://lists.cs.columbia.edu/cucslists/listinfo/netserv-users

Feedback or questions:

Jae Woo Lee <jae@cs.columbia.edu>

Roberto Francescangeli <rf2410@cs.columbia.edu>

Attachments (2)

Download all attachments as: .zip