(r1) RTCEEWorkloadTests < Deployment

Engineering Lifecycle Management Wiki - Deployment
Community information and contribution guidelines
~~EditAttach~~Printable
TWiki > Deployment Web > DeploymentPlanningAndDesign > PerformanceDatasheetsAndSizingGuidelines > RTCSystemZPerformanceTesting > RTCEEWorkloadTests
Revision 1 - 2014-09-01 - 12:46:59 - JorgeAlbertoDiaz
<div id="header-title" style="padding: 10px 15px; border-width:1px; border-style:solid; border-color:#FFD28C; background-image: url(<nop>https://jazz.net/wiki/pub/Deployment/WebPreferences/TLASE.jpg); background-size: cover; font-size:120%">
---+!! RTCEE Performance Testing: EE Workload Scenario<img src="https://jazz.net/wiki/pub/Deployment/WebPreferences/todo.png" alt="todo.png" width="50" height="50" align="right"> 
%DKGRAY% Authors: [[Main.JorgeAlbertoDiaz][Jorge Diaz]] <br>
Build basis: RTC 5.x
%ENDCOLOR%</div></sticky>

<!-- Page contents top of page on right hand side in box -->
<sticky><div style="float:right; border-width:1px; border-style:solid; border-color:#DFDFDF; background-color:#F6F6F6; margin:0 0 15px 15px; padding: 0 15px 0 15px;">
%TOC{title="Page contents"}%
</div></sticky>

<sticky><div style="margin:15px;"></sticky>
%STARTSECTION{"Intro"}%
This scenario tests the performance of the enterprise Dependency Based Build under high volume workload, simulating concurrent build operations that developers would execute in a real case scenario.<br/>
The tests itself are based on observations of the usage performed by our customers and our recommended practices to them.
%ENDSECTION{"Intro"}%
---++ Scenario Detailed Description

---+++ RTC Parametrization

---++++ Test assets configuration:

   * Personal builds requested will have the Minimum Load option set
   * Several streams are used in these tests. These streams have *not* been generated using the “Duplicate” stream feature. Duplicating a stream causes the Source Code Data to be reused, while for the tests information gathering it is preferred that every stream has different set of SCD.
   * System Definitions: 4.0.3 Link-edit feature will not be used.
   * Build Engines configuration: Build engines should be configured in such a manner that it is assured that a team build request doesn't impact personal builds concurrency. To accomplish that, the following property is added to the build engines that will be serving personal builds: “requestFilter” with value ”personalBuild=true”:

<img src="%ATTACHURLPATH%/buildFilter.png"/>

---++++ RTC Server configuration options:

   * Set advance property: 'Consider only outgoing change sets in personal builds = true'
   * Customization of the _Asynchronous Task Pool Size_ parameter for the amount of concurrent builds that will be executed.
   * Source Code Data Collection: customize the Max Number of Files in _Source Code Data Resource_ parameter to a maximum value of 100:

<img src="%ATTACHURLPATH%/scdConfig.png"/>

---+++ Virtual users characterization

To emulate the load and the main tasks expected during real solution usage, the following roles and operations have been identified. <br/>
These are used in the testing framework to emulate real users operations at the load and rates finer specified later in this topic:

   * Developer role A:
      * Change a COBOL program
      * Check-in the changes
      * Request Personal Build to verify changes
      * Accept incoming changes
      * Deliver his change sets

   * Developer role B:
      * Change a copybook source
      * Check-in the changes
      * Request Personal Build to verify changes
      * Accept incoming changes
      * Deliver his change sets

   * Contributor role:
      * Login to repository
      * Create and save a work item
      * Execute a query (25%) -- just execute query every 4 iterations
      * Logout

<br/>

---+++ Scenario execution preparation

Following are the main steps for preparing the environment for the test scenario run. The steps are beyond creating and configuring the assets already described:
   1. Assign/verify Build System definitions with sample resources
   1. Perform a full build of the applications
   1. Load the virtual developers workspaces in preparation for the test run.

<br/>

---+++ Scenario Variances

Based on the previous detailed configuration, two variances of the scenario are tested:

---++++ Test Scenario1

The following SCM structure is used:
   * 50 components distributed among 25 streams:
   * Each stream with 2 of the components with the test data sample distribution: one component will hold the “common” project of called “MortgageApplication-Common”,  where the other component contains the rest of projects

The following screenshot shows a sample configuration of one of the streams:

<img src="%ATTACHURLPATH%/streamConf1.png"/>
<img src="%ATTACHURLPATH%/streamConf2.png"/>

   * 30 build engines targeting the same build agent. This will allow the concurrency described later and the team build.
      * 25 build engines will be configured to just accept personal builds
   * One build definition for each stream representing the build of the test data application
      * Each stream will have a team build with associated:
         * Build workspace
         * Defined HLQ and load directory for every team / build definition
   * Each virtual user will need to have defined:
      * A personal repository workspace flowing to the assigned stream
      * A personal HLQ and load directory on the build machine
      * Personal workspace, HLQ and load directory will be used in the automated build requests processing

The scenario is meant to be performed during a long run of *8 hours*, trying to emulate a system load during a working day, with the following details:

   * The emulation will try to reproduce a scenario during a work day and variations of work load to different applications and streams. Similar to what would be normal lifecycle of development enterprise work, where some applications are more active than others.
      * From the 25 defined streams, 10 would be identified as more active ones, with users and load described in next subpoints.
      * Simulation of 27 concurrent developers.
      * Following distribution of emulated developers and streams:

2 streams will have 7 concurrent developers with the following roles and files to be modified in each iteration:

<table class="gray-table" style="width: 40%">
 <tr>
  <th><strong>Role</strong></th>
  <th><strong>#users</strong></th>
  <th><strong>Files to modify<br/>(1 line per developer)</strong></th>
 </tr>
  <tr>
  <td>Developer role A</td>
  <td>6 (per stream)</td>
  <td>AAACMORT.cbl / AABCMORT.cbl / AACCMORT.cbl<br/>
AADCMORT.cbl / AAECMORT.cbl / AAFCMORT.cbl<br/>
AAGCMORT.cbl / AAHCMORT.cbl / AAICMORT.cbl<br/>
AAJCMORT.cbl / AAKCMORT.cbl / AALCMORT.cbl<br/>
AAMCMORT.cbl / AANCMORT.cbl / AAOCMORT.cbl<br/>
AAPCMORT.cbl / AAQCMORT.cbl / AARCMORT.cbl </td>
 </tr>
</tr>
  <tr>
  <td>Developer role B</td>
  <td>1 (per stream)</td>
  <td>AAAMLIS.bms / AAAMTCOM.cpy / AABMLIS.bms / AABMTCOM.cpy </td>
 </tr>
</table>

3 streams will have 3 concurrent developers with the following roles and files to be modified in each iteration:

<table class="gray-table" style="width: 40%">
 <tr>
  <th><strong>Role</strong></th>
  <th><strong>#users</strong></th>
  <th><strong>Files to modify<br/>(1 line per developer)</strong></th>
 </tr>
  <tr>
  <td>Developer role A</td>
  <td>2 (per stream)</td>
  <td>AAACMORT.cbl / AABCMORT.cbl / AACCMORT.cbl<br/>
AADCMORT.cbl / AAECMORT.cbl / AAFCMORT.cbl
</td>
 </tr>
</tr>
  <tr>
  <td>Developer role B</td>
  <td>1 (per stream)</td>
  <td>AAAMLIS.bms / AAAMTCOM.cpy / AABMLIS.bms / AABMTCOM.cpy</td>
 </tr>
</table>


5 streams will have 1 developer assigned: 1:1 relationship between developers and streams:

<table class="gray-table" style="width: 40%">
 <tr>
  <th><strong>Role</strong></th>
  <th><strong>#users</strong></th>
  <th><strong>Files to modify<br/>(1 line per developer)</strong></th>
 </tr>
  <tr>
  <td>Developer role A</td>
  <td>1 (per stream)</td>
  <td>AAACMORT.cbl / AABCMORT.cbl / AACCMORT.cbl</td>
 </tr>
</table>

<br/>

Repeating the role steps at cycles of 30 minutes.
Additionally, one team build will be requested at every hour for each of the streams: not scheduled to start at same hour every time but with a difference of 10 minutes., so not all the team builds are executed at same hour time.

---++++ Test Scenario2

The following SCM structure is used:
   * 150 components distributed among 25 streams:
   * Each stream with 6 components with the test data distribution, using a different set of qualified file names

The following screenshot shows a sample configuration of one of the streams:

<img src="%ATTACHURLPATH%/streamConf1.png"/>

   * 60 build engines targeting the same build agent. This will allow the concurrency described later and the team build.
      * 50 build engines will be configured to just accept personal builds
   * Three build definitions for each stream for building each set of the testing data
      * Each stream will have a team build with associated:
         * Build workspace
         * Defined HLQ and load directory for every team / build definition
   * Each virtual user will need to have defined:
      * A personal repository workspace flowing to the assigned stream
      * A personal HLQ and load directory on the build machine
      * Personal workspace, HLQ and load directory will be used in the automated build requests processing

The emulation will try to reproduce a scenario during a work day and variations of work load to different applications and streams. Similar to what would be normal lifecycle of development enterprise work, where some applications are more active than others: as Scenario 1 but emulating a system with heavier load:
      * From the 25 defined streams, 11 would be identified as more active ones, with users and load described in next subpoints.
      * Simulation of 75 concurrent developers.
      * Following distribution of emulated developers and streams:

3 streams will have 7 concurrent developers with the following roles and files to be modified in each iteration:

<table class="gray-table" style="width: 40%">
 <tr>
  <th><strong>Role</strong></th>
  <th><strong>#users</strong></th>
  <th><strong>Files to modify<br/>(1 line per developer)</strong></th>
 </tr>
  <tr>
  <td>Developer role A</td>
  <td>9 (per stream)</td>
  <td>AAACMORT.cbl / AABCMORT.cbl / AACCMORT.cbl<br/>
AADCMORT.cbl / AAECMORT.cbl / AAFCMORT.cbl<br/>
AAGCMORT.cbl / AAHCMORT.cbl / AAICMORT.cbl<br/>
AAJCMORT.cbl / AAKCMORT.cbl / AALCMORT.cbl<br/>
AAMCMORT.cbl / AANCMORT.cbl / AAOCMORT.cbl<br/>
AAPCMORT.cbl / AAQCMORT.cbl / AARCMORT.cbl<br/>
AAQCMORT.cbl / AARCMORT.cbl / AASCMORT.cbl<br/>
AATCMORT.cbl / AAUCMORT.cbl / AAWCMORT.cbl<br/>
AAXCMORT.cbl / AAYCMORT.cbl / AAZCMORT.cbl </td>
 </tr>
</tr>
  <tr>
  <td>Developer role B</td>
  <td>3 (per stream)</td>
  <td>AAAMLIS.bms / AAAMTCOM.cpy / AABMLIS.bms / AABMTCOM.cpy<br/>
AACMLIS.bms / AACMTCOM.cpy / AADMLIS.bms / AADMTCOM.cpy<br/>
AAEMLIS.bms / AAEMTCOM.cpy / AAFMLIS.bms / AAFMTCOM.cpy</td>
 </tr>
</table>

5 streams will have 6 concurrent developers with the following roles and files to be modified in each iteration:

<table class="gray-table" style="width: 40%">
 <tr>
  <th><strong>Role</strong></th>
  <th><strong>#users</strong></th>
  <th><strong>Files to modify<br/>(1 line per developer)</strong></th>
 </tr>
  <tr>
  <td>Developer role A</td>
  <td>5 (per stream)</td>
  <td>AAACMORT.cbl / AABCMORT.cbl / AACCMORT.cbl<br/>
AADCMORT.cbl / AAECMORT.cbl / AAFCMORT.cbl<br/>
AAGCMORT.cbl / AAHCMORT.cbl / AAICMORT.cbl<br/>
AAJCMORT.cbl / AAKCMORT.cbl / AALCMORT.cbl<br/>
AAMCMORT.cbl / AANCMORT.cbl / AAOCMORT.cbl
</td>
 </tr>
</tr>
  <tr>
  <td>Developer role B</td>
  <td>1 (per stream)</td>
  <td>AAAMLIS.bms / AAAMTCOM.cpy / AABMLIS.bms / AABMTCOM.cpy<br/>
AACMLIS.bms / AACMTCOM.cpy / AADMLIS.bms / AADMTCOM.cpy</td>
 </tr>
</table>


3 streams will have 3 developers assigned: 1:1 relationship between developers and streams:

<table class="gray-table" style="width: 40%">
 <tr>
  <th><strong>Role</strong></th>
  <th><strong>#users</strong></th>
  <th><strong>Files to modify<br/>(1 line per developer)</strong></th>
 </tr>
  <tr>
  <td>Developer role A</td>
  <td>3 (per stream)</td>
  <td>AAACMORT.cbl / AABCMORT.cbl / AACCMORT.cbl</td>
 </tr>
</table>

<br/>

Repeating the role steps at cycles of 30 minutes.
Additionally, one team build will be requested at every hour for each of the streams: not scheduled to start at same hour every time but with a difference of 10 minutes., so not all the team builds are executed at same hour time.



---++ Test Topologies

The following topologies are being used for the execution of this scenario in order to test the performance and gather relevant data.

%INCLUDE{"RTCEETestingTopologies" section="DualTierZ"}%

---++ Test Data

From the existing scalability test data based on [[https://jazz.net/wiki/pub/Main/ZOSBuildSamplesV4/MortgageApplication.zip][Mortage Application]] sample, the following will be used:
%INCLUDE{"RTCEEPerfTestsData" section="Mortx500"}%

---++ Test Reports

%RED% Fill with a brief introduction and links to relevant data %ENDCOLOR%

---+++++!! Related topics:

---+++++!! External links:          

   * [[https://www.ibm.com][IBM]]

---+++++!! Additional contributors:
     

<sticky></div></sticky>
Copyright © by IBM and non-IBM contributing authors. All material on this collaboration platform is the property of the contributing authors.
Contributions are governed by our Terms of Use. Please read the following disclaimer.
Dashboards and work items are no longer publicly available, so some links may be invalid. We now provide similar information through other means. Learn more here.