(file) Return to README CVS log (file) (dir) Up to [Pegasus] / pegasus / test / StressTestController

Diff for /pegasus/test/StressTestController/README between version 1.1.2.1 and 1.1.2.2

version 1.1.2.1, 2006/04/18 03:15:28 version 1.1.2.2, 2006/04/18 05:16:30
Line 12 
Line 12 
 =============================================================================== ===============================================================================
 1.0 Execution model assumptions 1.0 Execution model assumptions
 2.0 OpenPegasus Stress Test Overview 2.0 OpenPegasus Stress Test Overview
     2.1 stressTestController      2.1 TestStressTestController
     2.2 Stress Test Clients     2.2 Stress Test Clients
     2.3 The Stress Test Configuration File     2.3 The Stress Test Configuration File
 3.0 Default Values 3.0 Default Values
Line 36 
Line 36 
         mainly to isolate the CIM server that is under stress.         mainly to isolate the CIM server that is under stress.
  
     1.3 ALL OF THE PROPOSED STRESS TEST CLIENTS INVOKED BY A GIVEN EXECUTION OF     1.3 ALL OF THE PROPOSED STRESS TEST CLIENTS INVOKED BY A GIVEN EXECUTION OF
         THE "stressTestController" ARE EXPECTED TO BE STRESS TESTING THE SAME          THE "TestStressTestController" ARE EXPECTED TO BE STRESS TESTING THE SAME
         CIMSERVER.         CIMSERVER.
  
 ===================================================================i=========== ===================================================================i===========
Line 52 
Line 52 
   follows:   follows:
  
  
    1. stressTestController     1. TestStressTestController
         Command that invokes one or more of the Stress Test Clients.         Command that invokes one or more of the Stress Test Clients.
  
    2. Stress Test Clients.    2. Stress Test Clients.
Line 61 
Line 61 
    3. Stress Test Configuration.    3. Stress Test Configuration.
        A flat file containing test configuration information.        A flat file containing test configuration information.
  
    The "stressTestController" will read the configuration file  and then,     The "TestStressTestController" will read the configuration file  and then,
    invoke the "Stress Test Client" instances specified in the "Stress Test    invoke the "Stress Test Client" instances specified in the "Stress Test
    Configuration".  Each of the client instances will be a separate process.    Configuration".  Each of the client instances will be a separate process.
    These Clients will in turn connect to the same CIM Server and perform    These Clients will in turn connect to the same CIM Server and perform
    their respective operations concurrently.    their respective operations concurrently.
  
    2.1 stressTestController:     2.1 TestStressTestController:
        =====================        =====================
          This command can be run using the following options:          This command can be run using the following options:
          (Usage information may be displayed using "--help" option)          (Usage information may be displayed using "--help" option)
  
          stressTestController [ -s ] [ -h hostname ] [ -p portnumber ]           TestStressTestController [ -s ] [ -h hostname ] [ -p portnumber ]
                               [ -u username ] [ -w password ] [ --help ]                               [ -u username ] [ -w password ] [ --help ]
                               [ --version ] [ --verbose ] [<config_filename>]                               [ --version ] [ --verbose ] [<config_filename>]
  
Line 94 
Line 94 
  
     2.1.1 The user may specify the name of the configuration file that is to be     2.1.1 The user may specify the name of the configuration file that is to be
           used for the tests. When a configuration file is not specified at           used for the tests. When a configuration file is not specified at
           command line, then the stressTestController command will use the            command line, then the TeststressTestController command will use the
           default configuration file if it exists, otherwise take the default           default configuration file if it exists, otherwise take the default
           values hard coded in the stressTestcontroller.            values hard coded in the TestStressTestcontroller.
  
     2.1.2 This command will also verify the validity of the configuration values     2.1.2 This command will also verify the validity of the configuration values
           specified in the configuration file.           specified in the configuration file.
Line 110 
Line 110 
             - If the specified configuration file cannot be found in  the             - If the specified configuration file cannot be found in  the
               configuration directory.               configuration directory.
             - If the configuration file has any invalid parameter or value.             - If the configuration file has any invalid parameter or value.
             - A failure in one (or more) of the Stress Test Clients.              - A persistent failure in one (or more) of the Stress Test Clients.
             - The configuration can be setup to allow some margin of client             - The configuration can be setup to allow some margin of client
               failures. By default, any client failure will be reported               failures. By default, any client failure will be reported
               and result in termination of the stress test               and result in termination of the stress test
Line 124 
Line 124 
            file.            file.
  
      2.1.7 Log files for the controller can be found in      2.1.7 Log files for the controller can be found in
            $PEGASUS_HOME/test/StressTests/log/ and will be named as             $PEGASUS_HOME/test/StressTestController/log/ and will be named as
            "<controller_pid>_stressTest_<DDMMYYhhmmss>.log "            "<controller_pid>_stressTest_<DDMMYYhhmmss>.log "
             where,             where,
                "DD" denotes the day.                "DD" denotes the day.
Line 136 
Line 136 
                "controller-pid" denotes the pid of the stressTestController                "controller-pid" denotes the pid of the stressTestController
  
      2.1.8 Log file for the clients intiated by a controller can be found in      2.1.8 Log file for the clients intiated by a controller can be found in
             $PEGASUS_HOME/test/StressTests/log/ and will be named as              $PEGASUS_HOME/test/StressTestController/log/ and will be named as
             <controller-pid>_StressTestClients.log             <controller-pid>_StressTestClients.log
             where,             where,
                 "controller-pid" denotes the pid of the stressTestController                 "controller-pid" denotes the pid of the stressTestController
Line 186 
Line 186 
  
      2.2.2 "Stress Test Clients" on completion or failure of its operation as      2.2.2 "Stress Test Clients" on completion or failure of its operation as
            specified above will continue to repeat the operations until stopped            specified above will continue to repeat the operations until stopped
            by the "stressTestController".             by the "TestStressTestController".
  
    2.3 The Stress Test Configuration File:    2.3 The Stress Test Configuration File:
        ===================================        ===================================
Line 198 
Line 198 
            used for the tests.            used for the tests.
  
      2.3.3 Default configuration file will be kept in      2.3.3 Default configuration file will be kept in
            $PEGASSUS_ROOT/test/StressTests/cfg/ directory.             $PEGASSUS_ROOT/test/StressTestController/ directory.
  
      2.3.4 The Configuration file can contain the following common values that      2.3.4 The Configuration file can contain the following common values that
            would in turn provide the factors required for the stress tests:            would in turn provide the factors required for the stress tests:
Line 388 
Line 388 
         (Ensure that the hostname specified below matches where the above         (Ensure that the hostname specified below matches where the above
          CIM Server resides.)          CIM Server resides.)
  
          stressTestController  -h <hostname>           TestStressTestController  -h <hostname>
  
          NOTE:          NOTE:
            If the <hostname> is local host run the command without the "-h" option            If the <hostname> is local host run the command without the "-h" option
            as follows:            as follows:
  
            stressTestController             TestStressTestController
  
     4.3 The "stressTestController" will search for the default file     4.3 The "stressTestController" will search for the default file
         in the configuration directory.         in the configuration directory.
Line 406 
Line 406 
          "CLI niall -l <hostname>" .          "CLI niall -l <hostname>" .
          (See section 3.0 (Default Values) above for reference)          (See section 3.0 (Default Values) above for reference)
  
     4.5  The "stressTestController" will log status and other information in its      4.5  The "TestStressTestController" will log status and other information in its
          log file.          log file.
  
     4.6  Each instance of the invoked stressClients(ModelWalkStressClient &     4.6  Each instance of the invoked stressClients(ModelWalkStressClient &
Line 414 
Line 414 
          default port and run its operations.          default port and run its operations.
  
     4.7  Note that the stress clients will repeat these operations until it     4.7  Note that the stress clients will repeat these operations until it
          unexpectedly ends  or is stopped by the "stressTestController".           unexpectedly ends  or is stopped by the "TestStressTestController".
  
     4.8  stressTestController will monitor the overall status of these stress      4.8  TestStressTestController will monitor the overall status of these stress
          clients for every One minute interval.          clients for every One minute interval.
            - If the overall stress client status is less than or equal to the            - If the overall stress client status is less than or equal to the
              tolerance level then all is well and all the client instances are              tolerance level then all is well and all the client instances are
Line 455 
Line 455 
         The stress test programs are expected to be build already         The stress test programs are expected to be build already
         and ready to run.         and ready to run.
  
     5.4 Another target "teststresstests" can also be run from      5.4 Another target "make tests" can also be run from
         $PEGASUS_ROOT/test/StressTests/tests.         $PEGASUS_ROOT/test/StressTests/tests.
         These tests will run some usage tests for the         These tests will run some usage tests for the
         "stressTestController".  Any failure, will be reported          "TestStressTestController".  Any failure, will be reported
         accordingly and end the tests.         accordingly and end the tests.
  
 ***************************************************************************** *****************************************************************************
Line 473 
Line 473 
     option is selected.     option is selected.
  
     6.1 Log files for the Stress Tests will be saved in the following directory:     6.1 Log files for the Stress Tests will be saved in the following directory:
             $PEGASUS_HOME/test/StressTests/log/              $PEGASUS_HOME/test/StressTestController/log/
  
     6.2 Each test will generate two log files.(One for the controller and one     6.2 Each test will generate two log files.(One for the controller and one
         for all the clients executed by this test.)         for all the clients executed by this test.)
Line 494 
Line 494 
             <controller-pid>_StressTestClients.log             <controller-pid>_StressTestClients.log
  
            where,            where,
              "controller-pid" denotes the pid of the stressTestController               "controller-pid" denotes the pid of the TestStressTestController
  
 ******************************************************************************* *******************************************************************************
 7.0 Stress Test Errors: 7.0 Stress Test Errors:

Legend:
Removed from v.1.1.2.1  
changed lines
  Added in v.1.1.2.2
No CVS admin address has been configured
 Powered by
ViewCVS 0.9.2