Performance options:
====================


A new array performance page was added to the GUI :
      http://arrayName:7654  => Report => General Reports => Array Performance

Use the [GO] button to display a different report.
The [Stop] button is used to stop the page from refreshing every minute. This
   only applies to report 4 (Real Time) and does not stop the probing itself (perf),
   just the refreshing of the page.

This page shows 4 reports:

  - I/O Summary : Will show current performance information for each volume of     
                  each array. This information is updated automatically every
                  time the agent runs (usually every 5 mins).

  - I/O Hourly  : Similar report but shows information for each hour of the day.
                  Multiple days are combined in the same page (24 buckets). 
                  Volume information is combined.

  - I/O Daily   : Similar report but the information is aggregated by day and
                  will show the last 31 days. Also updated by the agent automatically.

  - Real Time   : This report shows the last 40 period, periods are 1 minute by default
                  but this can be changed. This page will refresh automatically.
                  For this report to work, a separate telnet window must be open 
                  when the program /opt/SUNWstade/sbin/perf is executed:

                    $ /opt/SUNWstade/bin/perf -f 30            # use -? for options.
                    This will probe all arrays every 30 seconds.


All reports are showing the following information:

 - MB per secs(R)   : Megabytes per seconds (Read)
 - MB per secs(W)   : Megabytes per seconds (Write)
 - I/O per seconds  : Read Requests + Write Requests

 - CacheReadMiss    : Read Request that were not found in the cache.
 - CacheReadHit     : Read Request that were found in the cache.
 - CacheWriteMiss   : Write Request that were not found in the cache.
 - CacheWriteHit    : Write Request that were found in the cache.

The applet used to show the reports can display the same information in a variety of
way. Use the select button and the checkboxes to change the report style and the data
shown. Use 'Y values' to show/hide the number from the graph.
Use the 'Log.scale' to show the graphs with a logarithmic scale.


Notes: 
  - The T3 I/O accounting can be off when the request are very small and there
    is too many of them. When possible, use big requests (like 100K per request)
    to test the performance of the T3. Of course, in a real environment, the 
    request size cannot be controlled, but when using a disk exerciser (dex,dd,GRIT),
    the request size can be controlled.

  - Turn off the agent monitoring itself when running perf manually, this can 
    easily be done from the GUI (Admin->General Maint->Start Agents) or by 
    removing the start file (rm /opt/SUNWstade/DATA/start).
    Don't forget to put it back when done. perf can run with the agent on but
    it may create latencies when 2 processes are trying to get tokens from the same
    devices.
    


