Page History

The Analysis Phase

Adding a new probe to the IepmIEPM-BW test is "complex" because one must understand all the aspects of the probe:

...

• Are there customized plots one would like to see of this probe versus others? See:
    http://www.slac.stanford.edu/comp/net/iepm-bw.slac.stanford.edu/html/miscplots/iepm-bw.cacr.caltech.edu.html^{Image Removed}.
  If so then these specs must be defined in the plotspecs the PLOTSPECS table.

Custom Code to Implement the Probe

Each probe requires customized configuration and code.

• The probe configuration information (parameters) is put in the toolspecs the TOOLSPECS table. Each probe is different,
  and the configuration for each node it is targeted to can be different (window sizes, streams, duration, run interval)

...

• The master results page must be modified to include the probe into in it (controlled by "datatoanalyse" for each probe). This can be done by copying and editing the display code for any of the other probes.

• Possibly a fetch-test-data script must be written, unless the probe data fits the pattern of one that is already
  written. I have one data table "bwdataBWDATA" which hopefully is general enuf enough now to hold the data from new probes , in
  which in it. Then 'fetch-bw-data' can be used for most data.fetching the data.

Code Which Must be Modified to Handle New Probes

 The following scripts/files must be modified to include code for any new probes. Usually one can just copy, insert and modify the code for the other probes.

• 'create-analysis-data'
• 'create-history' and the scripts it calls
• 'fetch-binned-bwdata' if the data is in the BWDATA table
• 'install-iepmtools' - and if the new probe has server/client code, it should be put in the 'iepmtools' directory.
• 'create-tool-plots'
• 'make-bw-html' and the script snipit it calls in the directory 'site-customization' called 'top-of-page.pl'
• 'make-data-collection'
• 'scripts.list'
• dist.scripts.list
• 'analyze-for-alerts' in the directory 'alerts'. 

As usual, the devil is in the analysis. It is extremely important as one does not want to hang or crash
the system, and if the probe has certain problems characteristic of it, one MUST take care of them and recognize them!