Release Notes

QALoad 05.05.01

January 23, 2008

 

Obtaining the Latest Release Notes

System Requirements

What's New

Technical Notes

Known Issues

Contacting Compuware Customer Support



Obtaining the Latest Release Notes  back to top 

If you accessed this document from the product CD or from the program shortcuts on your desktop, you may not be reading the latest release notes. For the most recent information, go to FrontLine, Compuware's customer support Web site. The first time you access FrontLine, you are required to register and obtain a password. After logging onto FrontLine, select your product from the drop-down list and click Go. On the left side of the page, click the Documentation link. You will find the latest release notes listed with the other product documentation.


System Requirements  back to top

QALoad has the following minimum system requirements:

General Windows Installation Requirements

(*See the Technical Notes section for more information about using IE 7.0.)

Requirements by Component

The system requirements for each individual QALoad component follow:

Script Development Workbench Workstation Requirements
Conductor Workstation Requirements
Analyze Workstation Requirements
Server Analysis Agent Workstation Requirements
QALoad Windows Player Workstation Requirements

UNIX Player Workstation Requirements

The QALoad Player and associated utilities are supported on AIX, Linux, and Solaris. Compilers that are 32-bit compatible are required. The system requirements for each operating system follow:

UNIX Player Workstation Requirements for AIX

Note: The VisualAge compilers must be patched to the level indicated by the “September 2005 VisualAge C++ Professional V6.0 for AIX PTF”. For more information, refer to the IBM website.

UNIX Player Workstation Requirements for Linux

Note: The system should be updated to the packages indicated in the Red Hat Advisory: RHBA-2005:661-11. Additional packages required to resolve dependencies also should be applied.

UNIX Player Workstation Requirements for Solaris
(*Will not be supported after release 5.5.1.)

Middleware-Specific Requirements

In addition, your Windows system may need to meet specific requirements to support the middleware you will be testing. The Winsock and NetLoad middlewares do not have any additional QALoad Windows Player requirements.

Oracle* Net8/Net9 Requirements

QALoad supports load testing of Oracle Net8/Net9 environments when the following requirements are met:

QALoad Script Development Workbench
QALoad Player
(*Oracle will not be supported after release 5.5.1.)

ODBC Requirements

QALoad supports load testing of ODBC environments when the following requirements are met:

QALoad Script Development Workbench
QALoad Player

Uniface Requirements

QALoad supports load testing under Uniface when the following requirements are met:

QALoad Script Development Workbench
QALoad Player

Citrix Requirements

QALoad supports load testing under Citrix when the following requirements are met:

QALoad Script Development Workbench
QALoad Player
Web Interface

SAP Requirements

QALoad supports load testing under SAP when the following requirements are met:

QALoad Script Development Workbench
QALoad Player

ADO* Requirements

QALoad supports load testing under ADO when the following requirements are met:

QALoad Script Development Workbench
QALoad Player
(*ADO will not be supported after release 5.5.1.)

Oracle Forms Server Requirements

QALoad supports load testing under Oracle Forms Server when the following requirements are met:

QALoad Script Development Workbench
QALoad Player

Note: For 1.3, Compuware recommends that you use the Java HotSpot Client VM.

Java Requirements

QALoad supports load testing of J2EE components when the following requirements are met:

QALoad Script Development Workbench
QALoad Player

WWW Requirements

QALoad supports load testing of WWW environments when the following requirements are met:

QALoad Script Development Workbench
QALoad Player

Streaming Media Requirements

QALoad supports Streaming Media under WWW when the following requirements are met:

QALoad Script Development Workbench
QALoad Player

Integration Requirements

ApplicationVantage
ServerVantage
ClientVantage

Removal of Support

Script Commands No Longer Used

The following commands are being deprecated and will no longer be supported in QALoad Release 05.05.01 and later:

SAP Functions

Do_SAPCheckScreen

Do_SAPCheckStatus

Do_SAPCheckTitle

Do_SAPClearMessages

Do_SAPDumpEvent

Do_SAPExtractString

Do_SAPFrontEnd

Do_SAPFullMenu

Do_SAPGetControlValue

Do_SAPGetIt_Event

Do_SAPGetScreenTitle

Do_SAPGetStatusMsg

Do_SAPInit

Do_SAPLogging

Do_SAPLogin

Do_SAPLogoff

Do_SAPSendDblClick

Do_SAPSendEvent

Do_SAPSendMenu

Do_SAPSendOKCode

Do_SAPSendPFKey

Do_SAPSendReturn

Do_SAPSetCheckScreenWildcard

Do_SAPSetCtrlValue

Do_SAPSetCursor

SAP 4.x Client

Support for the SAP 4.6x client has been removed in release 05.05.01 and later. The Animating a Capture File feature has also been removed.

Java Middleware Support

QALoad's Java middleware will no longer support JDK 1.3 in release 05.05.01 and later.

Future Removal of Support

The following environments and middlewares will not be supported after QALoad release 05.05.01:


What's New  back to top

QALoad Script Development Workbench

Citrix Middleware

Support for Citrix Web Interface

You can now record and playback against applications deployed via the Citrix Web Interface. This starts Universal Sessions of both Citrix and WWW middlewares to handle the transition of information from the web browser to the Citrix client. Script and capture files are saved in the Program Files\Compuware\QALoad\Middlewares\Universal directory.

Citrix Full and Partial Bitmap Checks

The Citrix middleware has been enhanced to support script synchronization based on full and partial bitmap comparisons between screens at capture versus runtime. You can now capture your whole screen or a defined portion of the screen at capture time via a button on the capture window.

During capture, images are saved to the \QALoad\Middlewares\Citrix\Captures\Screenshots folder. After capture, the images are saved within a folder that has the same name as your capture file in the Captures directory. For example, if you named your capture file "Test.cap", you can find your screenshots in the \QALoad\Middlewares\Citrix\Captures\Test folder.

Support Citrix Emulation without Presence of an ICA File

You can now create scripts against a published application deployed via Citrix without requiring a formal ICA file.  

Ability to Clear Incoming Citrix Server Events from the Internal Events Stack

QALoad now has the ability to clear items from the internal event list resulting in enhanced synchronization with the server.  

SAP Middleware

Functionality has been added during recording in an SAP session, which outputs all controls in a window to an SAP capture file. In QALoad Workbench, there is a new SAP convert option called "Insert SAP control comments". The option called "View Control Log" gives you the opportunity to see the SAP capture control log file. During playback, user commands SAPGUIGetUniqueString, SAPGUIGetControlText, and SAPGUIContentCheck are implemented.

WWW Middleware

QALoad has been enhanced to allow you to control the level of JavaScript execution used for convert and replay. You can select from Full, Limited, or None, which result in writing the command DO_SetJavaScriptLevel (level) to the script.

Oracle Forms Server

Automatic Handling of ICX Ticket and Cookie Information

While in a Universal session including WWW and OFS, you now have the ability to automatically build variable handling functionality specific to the use of ICX tickets and cookies without having to manually modify the script.

To use the new automatic handling of ICX ticket and cookies in OFS 11i environments, you must generate a new capture file in 5.5.1. This can be achieved by either putting the existing .proxycap file through Post Capture processing or re-recording the application.

Support Available Through a Proxy

QALoad's support of OFS now extends to users that access their server via an HTTP proxy.

Relocation of OFS 11i Login Functionality

Through QALoad's ability to perform Universal OFS and Web middleware replays, the recording and playback against Oracle 11i servers have been simplified.

New OFS Convert and Replay Functions

Functionality has been added during convert and replay to identify OFS controls based on their creation. A new command, ofsWindowCreated has been implemented.

Test Asset Packing Functionality for ClientVantage Users

In Workbench, you can now create a zip file that contains the portion of the QALoad directory structure that contains the files necessary for a given script to be run by the Player.

Visual Navigator

A feature was added that allows you to modify the default behavior of CGI parameters when they appear underneath a ClickOnLink tree item.

Memory Options and Minimize Memory Usage

The advanced convert options for QALoad's web middleware have been changed to replace "Memory Options" and "Minimize Memory Usage" with "Playback Options" and "Minimized Processing" (respectively). This results in a new script command being placed in your script - Set(EVERY_REQUEST, MINIMIZED_PROCESSOR_MODE, TRUE);.

If you have been using the previous mode, the script command Set(EVERY_REQUEST, MINIMIZED_MEMORY_MODE, TRUE); will still continue to function, but this command will be deprecated in a future release of QALoad and you should switch to the new option. Please refer to the online help for more details on this change and its impact to the web middleware.

QALoad Conductor

Enhance Random Seed Generator

Random number seeds are used to inject random delays in script execution for each load test. The seed (or value) is automatically generated by QALoad. The previous GUI controls for random seed generation in the Conductor Options for Player have been removed.

Enhanced Item Selection Functionality in Monitoring Tree Control

When using Server Monitoring, the Choose Counters wizard page now provides a convenient way to select multiple counters and move the selections between the AVAILABLE ITEMS list and the SELECTED ITEMS list. This wizard page now enables you to take advantage of the Windows control key shortcuts for selecting multiple items – SHIFT-click or CTRL-click. The previous item selection and de-selection methods are still available.

QALoad Analyze

Ability to Adjust Precision of Times and Metrics

You can now decide the degree of precision for response times and metrics that are displayed in a report. The number of decimal places for the timing data range from 0 to 9.

Ability to Add Objects and Text to a Template

You can add descriptive and explanatory text to graphs using the 'Text Box' or the 'Balloon with Text' features available on the Graph Annotate toolbar. When you use this feature, text bubbles are added to graphs as part of a template that is used when the template is applied to future timing files.

Consistency of Color Coding in Analyze Default Graphs

The color assigned to represent various metrics within the default graphs now represents the same metrics from graph to graph to provide consistency for Analyze users.  

Graph Types Added to Analyze

You now have the ability to generate Scatter Plot, Radar, Candle Stick, open high-low, and high-low close graphs in Analyze.

QALoad Player

Provision of QALoad Player API for ClientVantage Users

The ability to use QALoad to execute ClientVantage scripts to monitor the end user experience has been simplified with the provision of the QALoad Player API. This enables ClientVantage users to execute scripts on a Player without a Conductor. ClientVantage users can create an instance of a Player thread within its process space and direct it through the execution of a script using multiple virtual users.


Technical Notes  back to top

Automatic Configuration of Windows Firewall on Windows XP Service Pack 2

When you install QALoad on a Windows XP machine with Service Pack 2 applied, the Windows Firewall is automatically configured to include the QALoad Player agent as an allowed exception. This configuration is required for communication between the Conductor and Player machines during a load test.

Re-Compile Scripts from Previous Versions of QALoad

If you are migrating from a previous version of QALoad, you must re-compile your existing scripts in the Script Development Workbench to use them in this release.

Do Not Use "Switch User" Windows Feature with Scripts Using NTLM Authorization

When load testing WWW scripts that use NTLM authorization, do not use the "Switch User" feature of Windows XP. Using this feature allows multiple user sessions to be active simultaneously, which can cause problems with script playback. If you need to use a different Windows profile, log off Windows and log on as a different user.

QALoad Certificate Added to certdb.txt for OFS recording

For the SSL support provided in this release, QALoad modifies the client machine's JInitiator certdb.txt file to include QALoad's CA certificate during the initial SSL recording process for an Oracle Forms Server application. This certificate authority information is internally validated by Oracle during the OFS-SSL session. If you want to remove the QALoad CA certificate, delete the following text from the certdb.txt file:

#qaload

-----BEGIN CERTIFICATE-----

MIIC1jCCAj+gAwIBAgIBADANBgkqhkiG9w0BAQQFADBXMQswCQYDVQQGEwJVUzER

MA8GA1UECBMITWljaGlnYW4xEDAOBgNVBAcTB0RldHJvaXQxEjAQBgNVBAoTCUNv

bXB1d2FyZTEPMA0GA1UECxMGUUFMb2FkMB4XDTA1MDYyMzE3MDEyN1oXDTE1MDYy

MTE3MDEyN1owVzELMAkGA1UEBhMCVVMxETAPBgNVBAgTCE1pY2hpZ2FuMRAwDgYD

VQQHEwdEZXRyb2l0MRIwEAYDVQQKEwlDb21wdXdhcmUxDzANBgNVBAsTBlFBTG9h

ZDCBnzANBgkqhkiG9w0BAQEFAAOBjQAwgYkCgYEA07Q/tlwx4wQezY5UY92v+NdQ

WI1yjlbWrkFFBTVWtvb/M+SdHGHXntDxGF378058hHND95wQsADCnJmPQNIoqj1c

elHl+4hkMtioMSb8IiEMs4OCgOaoBTtFrRgffZxoWJHAlh2k/MUcbFc1oiSZGdcT

Ua7keQ5NtahHRputc0MCAwEAAaOBsTCBrjAdBgNVHQ4EFgQUXUtOUAp/U8TV4p75

AA8ybai1080wfwYDVR0jBHgwdoAUXUtOUAp/U8TV4p75AA8ybai1082hW6RZMFcx

CzAJBgNVBAYTAlVTMREwDwYDVQQIEwhNaWNoaWdhbjEQMA4GA1UEBxMHRGV0cm9p

dDESMBAGA1UEChMJQ29tcHV3YXJlMQ8wDQYDVQQLEwZRQUxvYWSCAQAwDAYDVR0T

BAUwAwEB/zANBgkqhkiG9w0BAQQFAAOBgQBEmh3S2ktyRu7pn9PaqgZS2v1o2PhH

5XYZI8YKs9ZeWJotebtgmu/5xJj4I48neWE45kA/akYbUsW491UEZ609Pf2cw3JO

xBZ8MOyT7z3RzAhBFe8CpHrQjmc6Vh8Mzcv6vVYRCDlIGlk2CguQ3WQWF8w3zNA/

I53OD9PZjisIlA==

-----END CERTIFICATE-----
#qaload

Middleware Compiler Compatibility for SAP and Citrix

To use the SAP or Citrix middlewares, you must ensure that the VC++ MFC and Template Libraries option is selected when you install Visual C++. This option installs the headers, libraries, sources, and browser database for MFC and ATL, which are required for both the SAP and Citrix middlewares.

Large Paging File Recommended for SAP and Citrix

To prevent performance issues, Compuware recommends that you increase your system paging file size to a fixed size of:

Using Internet Explorer 7.0

QALoad now supports Internet Explorer 7.0. Compuware recommends that you turn off the IE 7 Anti-Phishing Filter to avoid inaccurate test results.

Capturing a Secure Site

If you are using IE 7 to capture a secure site, you may be prompted with a browser window that indicates there is a problem with the website's security certificate. To prevent the security alerts from appearing in the future and make QALoad a trusted source, follow the steps below to import a QALoad Certificate Authority into IE:

  1. Open an IE browser window and from the Tools menu, select Internet Options>Content>Certificates.
  2. In the Intended purpose drop-down list, select Client Authentication.
  3. Click the Trusted Root Certification Authorities tab and select cacert.pem from the QALoad Certificates directory.
  4. Click Import.
ActiveX Codepaths and Internet Explorer 7.0

IE 7 introduced methods for gathering additional information for ActiveX controls which are missing details and lack fully defined codepaths. IE now queries Microsoft's own ActiveX repository to look for additional detail as well as other sites based on information gathered from the control.

You should decide if these additional requests are desirable for your testing scenario in QALoad and create traffic filters to reflect your preferences. You may find your test results are more consistent if you add http://active.microsoft.com/ to the Blocked Traffic filter.

JavaScript

QALoad JavaScript support requires that all form elements (for example, buttons and text fields) must be inside of HTML forms in order to execute associated JavaScript. JavaScript that depends on time or date information may require the user to parameterize the script. QALoad's windowless replay does not support certain specific JavaScript functions listed below.

setTimeout
clearInterval
clearTimeout
setInterval
showHelp
showModalDialog
showModelessDialog

Citrix Waitpoints

As of 5.5.1, modified Citrix scripts should not have waitpoints placed directly after BEGIN_TRANSACTION markers. For best use of system resources, Compuware recommends that you place DO_SetTransactionCleanup before the END_TRANSACTION marker.


Known Issues  back to top

This section describes known issues related to the current release of QALoad.

Window Not in Focus

A known issue exists with the Microsoft Operating System that may cause new programs to appear behind other already open programs. When you start a program from another program, the new program window may appear behind all other open windows. Additionally, the new-window icon flashes on the taskbar. This symptom occurs on a Microsoft Windows 2000-based computer or on a Microsoft Windows XP-based computer. Microsoft has documented a procedure that details how users can modify the value of the ForegroundLockTimeout registry entry in Registry Editor to correct the issue. For specific instructions and more information on this issue, please refer to the following article located at the Microsoft Help and Support website for details: http://support.microsoft.com/default.aspx?scid=kb;en-us;886217

EasyScript Issues

Internet Explorer Fails Launch When Starting Winsock Recording or Recording OFS Socket

Mode

If you are running McAfee's VirusScan 8.0 with the "Buffer Overflow Protection" option enabled, Internet Explorer may fail to launch when you start a Winsock recording or when you record OFS socket mode. To prevent this issue, disable the "Buffer Overflow Protection" feature within McAfee VirusScan.

Pop-up Blockers Need to be Disabled When Capturing in the WWW Middleware Environment

If you are running your application on Windows XP SP2, Compuware recommends you turn off the 'pop-up blocker' feature before recording a transaction. The feature can be disabled using the browser window's Tools menu in Internet Options>Privacy.

QALoad Analyze

Internet Explorer 5.5 and Analyze

MS XML version 4.0 parser is required to view pre-defined or custom reports (relying on XML translations). Internet Explorer 5.5 ships with the MS XML version 3.0 parser. Compuware provides the MS XML 4.0 parser with this version of QALoad so that an upgrade to IE 6.0 is not required. It is automatically installed by QALoad but does not override any other version that may exist on the machine. QALoad Analyze looks for and loads this parser when using pre-defined or custom reports.

Sending Email Messages with Test Data Using Microsoft Outlook 2003

The Send utility in Analyze does not always work properly with Outlook 2003. If you experience problems when clicking the Send button in the email that is generated by the utility, you can use the utility to create a .zip file of the results and manually attach that file to an email you create directly in Outlook.

MBCS Characters Not Supported in Analyze Tab Titles and Annotation Objects

Timing file names containing multi-byte characters do not display the file name correctly in Analyze tabs. The multi-byte characters are removed from the name and, if containing all multi-byte characters, the tab reads “TimingFile.tim”. Annotation Objects for Graphs do not support MBCS either, so some characters may be displayed incorrectly in annotation object text for languages utilizing MBCS.  

QALoad Conductor

Problem with Microsoft Office 2000 and XP

If you are using the QALoad Conductor on a machine that has Microsoft Office 2000 or XP installed, when launching Conductor, you may be prompted repeatedly to insert a Microsoft Office installation CD. This problem is a known issue with Microsoft Office. It occurs during use with an account that is different from the account used during the Office installation when none of the Office components were launched since installation. To avoid receiving the prompts, launch any Microsoft Office component under the user account that was used during installation, and close it. For more information about this Microsoft Office issue, refer to the Microsoft knowledge base article Q298385.

Other Issues

Viewing QALoad Timing Files with International Versions of Microsoft Windows

QALoad supports load testing of Traditional Chinese, Simplified Chinese, Japanese, and Korean Web applications that use Double Byte Character Sets (DBCS). Viewing timing files and Summary reports with International versions of Microsoft Windows is only possible if the timing file is viewed on the same Windows language platform on which the timing file was created.

Server Analysis Agent on a Multi-Processor Machine

When using the Server Analysis Agent to monitor the "Process->% Processor Time" counter on a multi-processor machine, values greater than 100% for any instance of the counter are reported as 100%. To ensure accurate results, Compuware recommends that you use Remote Monitoring or Top Processes Monitoring when monitoring any instance of the "Process->% Processor Time" counter.

Solaris and Logfile Generation With More Than 250 Virtual Users

A file descriptor limit exists on the Solaris platform if a script is running in threaded mode, logfile generation is turned on, and there are more than 250 virtual users. To avoid this limitation, modify the Logfile Generation parameters so that logfiles are not generated by all virtual users:

  1. On the QALoad Conductor main window, click the Script Assignment tab.
  2. In the Debug Options column for the appropriate script, click the Browse button. (Click in the Debug Options column to enable the Browse button). The Debug Options dialog box appears.
  3. On the Debug Options dialog box, in the Logfile Generation Virtual User Range area, select the Virtual User(s) option and type a range that contains less than 250 virtual users.

Administrative Rights

QALoad now supports the use of non-Administrator users on the Windows 2000 and Windows XP Professional Edition platforms. Administrative rights are still required to install the software and appropriate user privileges are required for QALoad to write files to its own directory (which by default is in the Program Files directory). Administrative rights are also required when using middlewares that require the Capture Initialization Phase option. This requirement applies to middlewares other than WWW.

Previous Version of QALoad is Detected

If you have uninstalled all previous versions of QALoad but the installation process indicates that a previous version of the product is still installed, you may need to remove a registry key. In the Windows Registry Editor, delete the following registry key if it exists on your system:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\{90C9114B-ED44-4AB9-B32F-1B9EA363FBEF}

Find/Replace Functionality

The Visual Navigator's Find/Replace functionality may not find and replace XML tree items.

Checkpoint View

The Checkpoint view may be blank when applying an existing saved template.

ServerVantage Agent for Remote Monitoring

For Performance Monitoring of Application Servers for WebSphere, WebLogic, SAP, WMI, and WebSphere MQ, you must install the ServerVantage agent that is packaged with the QALoad software. The agent should be installed on a non-production machine that does not currently have a ServerVantage agent installed.

Subrequests in Old-Style WWW Scripts

In old-style WWW scripts, additional subrequests may show up as main requests.

Invalid characters in the Conductor Runtime Graphs on Japanese Operating System

If you are running a Japanese Operating System, you may see invalid characters in the file names in the drop-down list on the Series tab of the Conductor Runtime Graph. There is no known resolution at this time. The improper interpretation of the characters involves a third-party tool that the software uses to display this information. Check FrontLine for future updates to resolve this issue.

Central Datapool Size Limitations

There are limitations to the size of a Central Datapool that the QALoad Conductor can handle when starting a test. When attempting to use a Central Datapool file that is approximately 20MB or greater, the QALoad Conductor may fail to start. To avoid this problem, create a smaller Central Datapool file, or use a local Datapool for the test instead.

Using HTTP with the GCC Compiler on AIX after the SSL Module is Installed

HTTP scripts fail to compile on AIX systems using GCC as the compiler after the QALoad SSL module is installed. You must manually install a different library for your scripts to compile properly.

When installing the SSL module, EasyScript for Secure WWW, on AIX using the package installation method, you must perform the following steps after the installation is complete:

  1. Login to the AIX system as 'root'.

  2. cd to /opt/QALoad/lib

  3. Enter the following commands:

  1. mv libqlHTTP.a orig.libqlHTTP.a

  2. ln -s ./libqlHTTP128.a libqlHTTP.a

  3. mv libg++qlHTTP.a orig.libg++qlHTTP.a

  4. ln -s ./libg++qlHTTP128.a libg++qlHTTP.a

Data Execution Prevention

In Windows XP SP2 and Windows 2003 Server environments, if you experience problems with your applications crashing while capturing, perform the following steps:

  1. Right-click on My Computer and select Properties.

  2. Click the Advanced tab and select Settings in the Performance field.

  3. Click the Data Execution Prevention tab. By default, it is set to guard system processes. To stop your application from crashing, click the second radio button Turn on DEP for all programs and services except those I select:

  4. Add the link to your program's executable file (.exe) to the list of programs that are allowed.

  5. Restart your machine.


Contacting Compuware Customer Support  back to top

Compuware Customer Support can assist you with all issues, from installation to troubleshooting.

Before Contacting Customer Support

Prior to contacting customer support, gather the following information:

Telephone

800.538.7822

FrontLine Support Web Site

Refer to Compuware's FrontLine support web site for fast access to critical information about your product. You can read and print documentation, download product fixes, review frequently asked questions, or directly e-mail Compuware with questions or comments. The first time you access FrontLine, you are required to register and obtain a password.

Compuware Corporate Web Site

Refer to Compuware's corporate web site at http://www.compuware.com/ for information about Compuware customer support policies and problem resolution process.

Mail

Customer Support
Compuware Corporation
One Campus Martius
Detroit, MI 48226-5099

End of QALoad Release Notes
(C) 2007 Compuware Corporation. All rights reserved. Unpublished rights reserved under the Copyright Laws of the
United States.