= INSTOOLS, Instrumentation Tools = == What is it? == INSTOOLS gives users the ability to observe and understand the runtime behavior of their experiments. Leveraging existing monitoring capabilities, INSTOOLS creates a simple interface for the user but also allows for a detailed drill down for more advanced purposes. For more details on the INSTOOLS project, see [wiki:InstrumentationTools InstrumentationTools]. [[br]] See the online [http://www.netlab.uky.edu/p/instools/home GEC9 Tutorial] for details about setting up INSTOOLS. [[br]] See below for a quick overview of how to start using INSTOOLS. == Quick Start == * Download the [http://www.uky.emulab.net/downloads/INSTOOLSv3_2.tgz 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 /docs/INSTOOLS-SETUP. * Create your experiment as usual. * Once the experiment has been setup, run the instrumentize.py script with the appropriate slicename. {{{ ./instrumentize.py -n slicename }}} * 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 [wiki:INSTOOLSInterface Live View] pages and the INSTOOLS Portal page. * Once the scripts are complete, go to the [http://portal.uky.emulab.net/ Portal ]. For Portal help, see [wiki:SlicePortal INSTOOLS Portal Wiki].