INSTOOLS : Instrumenting Your Kentucky Experiment

NOTE: If you can login to the nodes on your experiment via ssh without a password prompt , only then should you proceed.

 

  1. Run the python script to Instrumentize your experiment :

    ./instrumentize.py -n <SLICENAME>
  2. PLEASE BE PATIENT while you experiment is being instrumentized. This step takes around 15 to 20 minutes to complete.(Depends on the current server load)
  3. Enter a password and an email address for login to the Web-interface when prompted. The username is same as your emulab/protogeni userid.
  4. Note the URLs for the Measurement Controller displayed on your screen.
  5. Open a browser and type the URL of the Measurement Controller. Use  your emulab/protogeni userid and the password you typed in step 3 to login to the Web-interface.
  6. Go back to the putty/ssh terminal. 
  7. ssh to the node n1 "ssh -p <sshd port number> <physical hostname for n1>"
  8. Run the command "/usr/bin/traffic_gen.sh n3" on n1. (Please ignore the messages "audit_log_user_command(): Connection refused"). The traffic generator basically does the following
    • Generate tcp traffic to n3 at dst port 443 (https)
    • Generate ICMP traffic to n3
    • Generate UDP traffic to n3
  9. Go back to the browser to see the network traffic graphs and other network/system information for your experimental nodes.
  10. Browse through the various menus that display the network traffic being generated on the nodes using graphs and tables.
    • Protogeni-->n1-->Graph-->Link0-->*
    • Protogeni-->n1-->Graph-->Node0-->*
    • Protogeni-->n1-->Graph-->Netflow-->*
    • Protogeni-->n1-->Table-->*
    • Protogeni-->n2-->Graph-->Link0-->*
    • Protogeni-->n2-->Graph-->Node0-->*
    • Protogeni-->n2-->Graph-->Netflow-->*
    • Protogeni-->n2-->Table-->* .. and so on
  11. More customizable menus/pages can be generated by user.