wiki:Internal/RunningDemos

Version 2 (modified by kishore, 19 years ago) ( diff )

HowTo for ORBIT Demos

This document describes the technical procedure for showing demonstrations on the ORBIT Indoor testbed. The objective here is to cover all the technical aspects so that any novice ORBIT user can run these demos. The current version covers two demos

  • Conference room demo
  • Streaming video demo

Future demos should also include their details here.

Conference room demo

Streaming video demo

Revision History

Version Date Revised by Changes
v0.1 2005-10-25 Mesut Ali Ergin Initial version
v0.2 2005-10-27 Mesut Ali Ergin Updates some IP addresses, added UDP streaming port number.

Objective

In this demo, purpose is to run three concurrent video streams on three node pairs ([1,2],[1,8],[2,1],[2,5],[3,2],[3,8]). These three pairs should nearly saturate the network and by enabling admission control on one of the pairs, we should be able to see that one of the streams is not accepted in the first place for routing. Direction of the flow is designed to be like

     VIDEO                            VIDEO
    SOURCES                        DESTINATIONS
             Streaming on Wireless
      [1,2] -----------------------> [1,8]   } Streaming on Wired
      [2,1] -----------------------> [2,5]   }====================> DISPLAY
      [3,2] -----------------------> [3,8]   }                      MACHINE
               UDP Streaming to                  HTTP Streaming to
                destport 1234                    destports 80XY

All script files (except the ones in the node image file) are compiled into a nodehandler tarball and they can be found in repository/test/exp folder after extracting nodeHandler-panasonic.0.1.tar.gz. This tarball is available for download from http://www.winlab.rutgers.edu/~ergin/files/nodeHandler-panasonic.0.1.tar.gz

Preliminaries

  1. Image name
    panasonic-demo-2.4.26-click-20051025.ndz node image file must be used. Resides on repository2:/export/orbit/image. It includes following additional installed features onto the standard click image:
    • Lunar protocol source code and compiled modules
    • VLC Media Player 0.8.2
    • ssh key files for hosts [1,2],[1,8],[2,1],[2,5],[3,2],[3,8]
    • bash files for experiment support: send-stream,sh, receive-stream.sh, stop-everything.sh
  1. nodeHandler scripts
    There are two scripts with names streaming-panasonic.rb and streaming-panasonic-stop.rb. Former is used to start the experiment, and the latter is used to stop it. nodeHandler version 1.71 (modified to support execution of bash scripts and has been used with those scripts. As of writing, due to a bug in lunar modules, stop script cannot unload klunar and ksapf modules, after they are involved in data transfer. So, for a clean restart, node power cycle might be needed.
    • Display machine
      It must be able to reach ports on grid nodes using TCP. Display machine at ORBIT control room has that capability (or any other machine connected to that wall plug). The port numbers to connect are of 80XY format, where X and Y are coordinates of the node. Display machine should have VLC Media Player 0.8.2 installed in order to show the streams to user. E.g., if experiment is run on sandbox 9, the URL to the stream on [1,2][1,8] pair is http://10.19.1.8:8018
  • Video Clip packages
    There are two debian packages (with different set of video clips in them) called,

teststream_1.1-1_all.deb, teststream_1.1-2_all.deb. Normally, experiment support

script checks the package and installs if it does not exist on the particular

source node automatically. If debian repository, which is

repository1.orbit-lab.org (or the network connected to it) fails, it may not be

loaded on demand. In that case, the mentioned package have to be uploaded and

installed manually to the node. Video clips are not embedded into the O/S image

file due to the image file size concerns. The folder on which this debian

package files reside is repository1:/var/www/video/binary

  • Auxiliary scripts

Following are the the shell scripts that can be used on the console to help

maintaining the experiment. They are not required for functionality, they are

only for helping with some of the tasks.

  • poweroff-panasonic/poweron-panasonic: Powers off or on all the experiment

nodes by contacting CMC web interface accordingly.

  • getlunarips: Retrieves lunar interface IP addresses from the streaming nodes.

Must be run during the experiment.

  • scp-deb: copies teststream debian package to three source nodes via scp.

Steps to Follow:

Step 1)

Make sure that all nodes in the experiment are powered off. poweroff-panasonic

shell script can be used for that purpose.

Image the experiment nodes with the following command:

imageNodes [1,2],[1,8],[2,1],[2,5],[3,2],[3,8] \

panasonic-demo-2.4.26-click-20051025.ndz

Carefully watch the imaging process. It should take less than 10 mins. If any of

the nodes do not come up with PXE image or any of them check back in during the

imaging process, kill the imaging nodeHandler instance, power-off the nodes, and

restart imaging.

If successful, nodes will be powered off automatically. They can be powered-on

with experiment script or with poweron-panasonic shell script without starting

the experiment.

Step 2)

Start the experiment with the following command after getting into

nodeHandler-panasonic/ruby folder:

ruby nodeHandler.rb -s false test:exp:streaming-panasonic

change test:exp portion if the script is being invoked from some other folder

structure. After all nodes check in, it will take at most 10 seconds for the

streaming to start on the node pairs, except first time. The first time run will

involve an apt-get install command to install video clip debian package file.

So, this adds at most 2 minutes. Subsequent runs should not have this additional

delay. This delay is not a blocking delay for nodeHandler. So, experimenter

needs to wait this amount of time after the nodeHandler start script is invoked.

Step 3)

Use display machine to run three instances of VLC player, and enter URL info of

the stream into 'File→Open Network Stream→HTTP' text field. URL format is

http://CTRL_IP_of_Node:80XY, where X and Y are coordinates of the node. In

current setup, the URLs translate into:

http://10.19.1.8:8018

http://10.19.2.5:8025

http://10.19.3.8:8038

Invoking these URLs should bring up three video streaming windows on display

machine. With the current setup, there should be perceivable distortion on the

streams, especially on the bigger one.

Step 4)

Log-into node3-2 with 'ssh root@node3-2' command. Execute 'pkill vlc' on the

node to stop streaming of the video. After a few seconds, video should freeze on

the corresponding VLC window on display machine. Stream can be restarted, if

necessary, by executing 'sh execfile' on the node.

Step 5)

After stopping the stream on one pair, invoke monitor program on node3-8 (or

node3-2), by executing 'lin/monitor2 ath1raw 3000 500'. Here, 3000 means that

the link is supposed to support 3Mbps bandwidth, and 500 means that the

application packet rate is 500 packets/sec. This command should run a process

that updates /proc/pkt_rate periodically. After a few updates, re-invoke the

streaming by executing 'sh execfile'. Streaming process should start, but

pressing play button on the VLC software on display machine should not display

the stream, since it is not accepted for routing on the wireless network.

Step 6)

Stop the monitor program, and manually enter 'echo 40X6000'>/proc/pkt_rate to

tell the admission control algorithm that there is enough bandwidth for the

video. Re-invoking the stream and trying to see it on display (as explained in

Step5) should succeed this time.

Troubleshooting

If video is not visible on the display machine, check the following things to

see what might have gone wrong by logging into a source and destination pair.

  • At the source and destination, do a 'ps aux'. There should be a group of vlc

processes running (at least three or four). Run 'cat execfile' to check IP

addresses for streaming client and server are produced correctly. If not, re-run

the nodeHandler script to see if problem persists.

  • Make sure that video clip package is installed correctly by looking into

/usr/streams directory. There should be MPEG files in that folder. If not,

upload teststream_1.1-2_all.deb to source nodes and install it with

'dpkg -i teststream_1.1-2_all.deb' command.

  • Make sure that you can ping the destination node's lunar IP address

(192.168.42.X) from the source node. If not, try restarting node, since lunar

modules can not be reloaded in a healthy manner.

  • Make sure that display machine VLC client can connect to the stream

destination node. Kill the destination vlc instance (at stream destination node)

with 'pkill vlc' and invoke it the same way specified in execfile, without -d

option. This will enable foreground mode and process should inform whenever

display VLC client is connected to the destination node.

Note: See TracWiki for help on using the wiki.