Workload Data Collection and Workload Data Rollup scripts

The Server.Load Workload Data Rollup feature is adapted from the NotesBench data rollup feature and allows test data from a group of test drivers and an SUT to be combined into a single data file for analysis. While a workload runs, the Workload Data Collection custom script, SHSTAT.SCR, collects performance data from the SUT. When the workload is complete, the Workload Data Rollup script rolls up the performance data.

About this task

Run the Workload Data Rollup Collection and Workload Data Rollup scripts on a system other than the one that contains the test drivers that put the load on the SUT.

Note: The drivers that create the test load are referred to as regular test drivers in this document.

Setting up statistics collection before the workload run

Procedure

  1. Create a folder to use as a Results directory and then set sharing privileges on that folder to allow the client drivers to write to the Results directory.
  2. On each test driver, map a drive to the Results directory on a system that will collect the data from all drivers.
  3. In the Workload Data Rollup driver's NOTES.INI file, set ResultsDirectory= to a valid directory for output files on a system. For example, if drive Z: is mapped to the results directory, the NOTES.INI setting would be:
    RESULTSDIRECTORY=Z:\
  4. In the NOTES.INI of the driver running the Workload Data Collection script, set this NOTES.INI variable:
    NB_SaveCMDConsole=1  
  5. Set these Server.Load test parameters for the driver running the Workload Data Collection script:
    number of users/threads = 1
    script loop count = 1
    Note: This setting is not needed on the regular test drivers because the path to the Results directory is specified using the Server.Load parameter Store the Metrics to this file.
  6. Click Execute to access the Metrics window.
  7. Set the Store the Metrics to this file field to point to the ResN file in the results directory for each regular test driver:
    • Z:\Res1 -- for test driver 1
    • Z:\Res2 -- for test driver 2
      Note: Each results (metrics) file from the regular test drivers must have a unique numbered name and a ResultsDirectory path.
  8. Set the Server to receive console commands field in the Metrics window to blank on the Data Collection Driver for the workload data collection and workload data rollup scripts. Server.Load does not need to authenticate with a server for these scripts.

The Workload Data Collection script

About this task

Run the Workload Data collection script template as-is or customize it for your specific use. You can add or remove groups of statistics to be collected from the SUT as needed.

Beginloop
Console [Mailserver] sh stat platform
Console [Mailserver] sh stat server.*
Console [Mailserver] sh stat server.version.*
Console [Mailserver] sh stat server.time.start
Console [Mailserver] sh stat domino
Console [Mailserver] sh stat database
Console [Mailserver] sh stat disk
Console [Mailserver] sh stat mail
Console [Mailserver] sh stat mem
Console [Mailserver] sh stat NET
Console [Mailserver] platform time 10
Pause 60000
Rewind
Note: You can obtain a copy of this script, from the Using This Database document in nameagent.nsf. Detach the script to a directory.