wiki:Instrumentize

Version 30 (modified by carpenter@vis.uky.edu, 8 years ago) (diff)

--

INSTOOLS, Instrumentize

deprectae

What is it?

Instrumentize is the INSTOOLS process of creating and deploying a set of measurement tools onto a slice.
For more information about the Instrumentation Tools see INSTOOLS Summary For more information about the INSTOOLS project, see InstrumentationTools.
See the online GEC9 Tutorial for details about setting up INSTOOLS.
See below for a quick overview of how to start using INSTOOLS.

Quick Start

  • Download the python INSTOOLS scripts and docs
  • See the /docs/README file for more details on using INSTOOLS.
  • You should already have the appropriate accounts and certificates setup. See How to use ProtoGen and-or docs/INSTOOLS-SETUP.
  • Make sure that you create a file named .protogeni-config.py in your home directory with the following contents (example is for Kentucky aggregate).
    XMLRPC_SERVER = { "default" : "www.uky.emulab.net", "ch" : "www.emulab.net" }
    
  • Create your slice as usual or use the script createExp.py
    ./createExp.py -n slicename rspecfilename
    

Note that there are sample rspecs in the rspecs directory.

  • Once the experiment has been setup, run the instrumentize.py script with the appropriate slicename.
    ./instrumentize.py -n slicename
    
    If you are not using ssh agent, you may need to provide the file name of your private key to instrumentize your experiment.
    ./instrumentize.py -n slicename -k private_key_filename
    
    where private_key_filename is the name of the file storing the private key generated by ssh-keygen.
  • The time needed for the script to run will vary on the number of nodes used and the current server loads.
  • Towards the end, you will be prompted for a password. This will be used for the INSTOOLS Live View pages and the INSTOOLS Portal page.
  • Once the scripts are complete, go to the Portal . For Portal help, see INSTOOLS Portal Wiki.