Oracle® Application Testing Suite

This document includes updated information for Oracle Application Testing Suite version 9.20. The information in this document is more up-to-date than that in the manuals. Many of the issues outlined in this document will be corrected in upcoming releases. If you have any questions or problems, please contact our support group at http://www.oracle.com/support/index.html .

Contents

This document has the following sections:

New Features and Updates in this Release

This version includes maintenance improvements to the existing features as well as new features outlined below.

Oracle Application Testing Suite 9.20 - New Features and Updates

Oracle Application Testing Suite 9.20 - Additional Notes

System Requirements

Oracle Application Testing Suite has the following system requirements:

Oracle Functional Testing/OpenScript

Oracle Functional Testing's OpenScript scripting platform has the following system requirements:

Oracle Load Testing

Oracle Load Testing has the following system requirements:

Note : These are minimum requirements only and actual requirements for the Oracle Load Testing Server will vary depending on the size and configuration of your load test. If you are running larger load tests, of greater than 1000 Virtual Users, you should consider deploying Oracle Load Testing on a faster server class machine with additional RAM recommended.

Note : Oracle recommends running the Oracle Load Testing Server and Agents on separate systems for production load testing. The amount of memory required on the Oracle Load Testing Agent systems may increase based on the number of Virtual Users that will be assigned to run on each Agent. For more information, visit the QA/Testing Technology Center on Oracle Technology Network or contact your Oracle representative.

Oracle Test Manager

Oracle Test Manager has the following system requirements:

Note : These are minimum requirements only and actual requirements for Oracle Test Manager will vary depending on the quantity of test assets stored and number of concurrent users accessing the application. If you have a large quantity of test cases, requirements or issues stored and/or are deploying Oracle Test Manager for a team greater than 10 users, you should consider deploying Oracle Test Manager on a faster server class machine with additional RAM recommended.

Additional Notes

The following are additional notes about system requirements:

Installing the Oracle Application Testing Suite

This section explains the installation procedures for the Oracle Application Testing Suite.

The machines where the OpenScript product is installed should be strictly used for testing. The security features of the browsers have been disabled on this machine to enable recording and playback operations. The browsers cannot be used for secure browsing.

Installing the Applications

There are two ways that you can install Oracle Application Testing Suite:

  1. Select and download the Oracle Application Testing Suite (oats- version .zip) from the web site and save it to a temporary directory on your hard disk.
  2. Unzip the downloaded file and run the setup.bat file for Oracle Application Testing Suite.
  3. Follow the setup instructions to install the Oracle Application Testing Suite. During the installation you will be asked to provide a master password. Remember this password . The master password specified during installation is used to set all of the following user passwords:

Manually Configuring the Installation

The above installation procedure for Oracle Application Testing Suite setup.bat in oats-plus-prereqs- version .zip installs the applications, database, and Web server. If during the installation procedure you select the Do nothing, I will configure Oracle Application Testing Suite later (advanced) option you will need to manually create the database schema.

To manually create the database schema:

    Open a command window and run the DBConfig utility using this command:

installdir>\jdk\jre\bin\javaw.exe -Djava.library.path=installdir>\install\lib -jar DBConfiguration.jar
cmo.setValue('oats')
jdbc:oracle:thin:@//hostname>:port>/servicename>

Installing the Oracle Load Testing Remote Agent

Oracle Load Testing allows you to distribute your Virtual Users to run from remote Agent machines. The Oracle Load Testing Server will connect to Oracle Load Testing Agent systems to start and run your Virtual Users on those machines. The Oracle Application Testing Suite Remote Agent is a component of the Oracle Application Testing Suite installation that enables Virtual Users to be distributed to these Agent systems. Users can either install the full Oracle Application Testing Suite installation or just the Remote Agent install component on their Agent machines to enable this functionality.

Installing the Remote Agent

To install the Remote agent:

  1. Download the Oracle Application Testing Suite Agent .zip file from the download Web site.
  2. Unzip the downloaded file and run the install.sh executable.
  3. Follow the setup procedure to the Select Components and Installation Directory screen.
  4. Select to install the full Oracle Application Testing Suite or select just the Remote Agent check box and clear all other boxes to install just the Remote Agent software.
  5. Verify network access from the Controller workstation to the Agent workstations and configure the Agent Workstations as explained in the following section.

Configure Remote Agent Service Login

To specify the user login for the Oracle Load Testing Agent Service, open the Services control panel on the Agent machine and change the login credentials for the "Oracle Load Testing Agent Service". By default, the Oracle Load Testing Agent Service will run under the Local System account.

Verify Network Access to Agent Systems

Once you have the Oracle Load Testing Server and Agent software installed on the individual systems, you should verify network access between the Oracle Load Testing Server system and each Remote Agent system. This section provides basic tips and techniques to make sure the Oracle Load Testing Server system can successfully communicate with each Remote Agent system.

Installing over beta versions or earlier releases of Oracle Application Testing Suite

If you have a 9.20 beta or Early Access version of the Oracle Application Testing Suite installed, you should un-install the earlier release of the Oracle Application Testing Suite before installing this version.

If you are installing over a previous version of Oracle Application Testing Suite, you may consider making backup copies of the following before installing this version:

If you are installing or upgrading over a previous version of OpenScript, you should close any open scripts in the earlier version before upgrading.

Backwards Compatibility and Upgrading Scripts

This section provides information about backwards compatibility of OpenScript scripts and upgrading OpenScript scripts.

Statement of Backwards Compatibility

Scripts created in older versions of OpenScript will always run in new versions of the product without modification from the command-line, Oracle Load Testing, and Oracle Test Manager.

Older OpenScript scripts may not be opened or played back in the newer version of the OpenScript User Interface without upgrading them first. See Upgrading Scripts to the New Release below. The introduction of Script Assets (in Script Properties) requires pre-version 9.1 scripts to be migrated to the current version if they are to be edited in the OpenScript User Interface.

Previously published script API functions are supported in the latest release. Some published API may be marked as deprecated, but will still work in the new release in order to maintain backwards compatibility.

Upgrading Scripts to the New Release

OpenScript requires that scripts be upgraded to the latest release in order to open them in the OpenScript User Interface. You are not required to upgrade a script to the new version unless you want to open the script in the OpenScript User Interface. Older versions of OpenScript scripts can be run without modification from the command-line, Oracle Load Testing, and Oracle Test Manager.

Version 9.20 and higher scripts cannot be played back in earlier versions of OpenScript, Oracle Load Testing, and Oracle Test Manager. If you want to maintain pre-version 9.20 scripts, you should make a back up copy of your scripts before opening and saving them in version 9.20 or higher. OpenScript automatically migrates any pre-version 9.20 scripts when the script is opened and saved in OpenScript version 9.20 or higher.

Opening Older Scripts in OpenScript

OpenScript automatically prompts you to upgrade older version scripts to the current version whenever the script is opened in the OpenScript User Interface. When opening an older script, you can choose not to open the script and the script will not be upgraded.

When prompted to upgrade a script, if the script depends on any child scripts or function libraries, OpenScript provides an option to upgrade the child scripts or function libraries to the new version also.

Once a script is upgraded to a new release, the script cannot be opened or run using older versions of Oracle Application Testing Suite (OpenScript, Oracle Load Testing, or Oracle Test Manager).

Migrating Older Scripts in OpenScript

If you wish to upgrade scripts without opening them individually in OpenScript, you can use the Migrate Scripts upgrade option on the Tools menu. The Migrate Scripts tool lets you select which scripts to migrate to the current version and find any child scripts that also need to be migrated.

Since version 9.1, scripts that will be run in Oracle Load Testing may not specify absolute paths for their repositories or script assets. However, if your pre-9.1 scripts use absolute paths, you may continue to run the same scripts, unmodified, in the current version of Oracle Load Testing, without issue. As soon as you upgrade the pre-9.1 scripts to the current version using either the OpenScript User Interface or the Migrate Script tool, the script will not playback in Oracle Load Testing until the absolute paths are changed to relative paths. The Migrate Scripts tool does not migrate absolute paths to relative paths or to repository paths. The absolute paths must be changed in the scripts manually.

Copying Older Scripts to New Repositories

For scripts created in releases before 9.1, you should maintain the same rigid, legacy Repository/Workspace folder structure as repositoryLocation/workspace!/script. Changing the repository folder structure within which pre-9.1 scripts exist, such as by adding multiple sub-folders within the repository, or by creating sub-folders without an exclamation mark “!” at the end, may prevent certain pre-9.1 scripts from playing back successfully.

Running Mixed Versions of Scripts

You are advised not to run mixed versions of "job" scripts where a parent script calls child scripts or function libraries. This may happen in cases where you may have 9.2x "parent" scripts that run pre-9.1 "child" scripts or function libraries. Although this configuration has been tested and is supported, the combination of mixed versions scripts may lead to unpredictable results and some confusion as to which scripts are the latest version. In addition, mixed version job scripts may not be able to take advantage of some newer features, such as:

Upgrade Details

When an OpenScript script is upgraded from an older version to the current version, the following changes are applied:

Database Migration

A database migration utility is now available for users to enable migration of data from MS Access, SQL Server, and Oracle database into an Oracle database. Documentation for the database migration utility can be found in < installDir >/bin/DataMigration/help.

Tutorial and Documentation for the Oracle Application Testing Suite

The Oracle Application Testing Suite includes product documentation in Adobe Acrobat .PDF format and online help for each application and utility. The documentation includes electronic versions of the Getting Started Guide, OpenScript User's Guide, Oracle Load Testing User's Guide, and Oracle Test Manager User's Guide. The PDF files are installed to the < installDir >/docs directory.

You need the Adobe® Acrobat® Reader v4 (or newer) to open and view the documents. You can download the reader from the Adobe web site at http://get.adobe.com/reader/ .

All of the components of the Oracle Application Testing Suite include comprehensive online Help. You can access the online help using the Help menu options inside of each product.

Known Problems, Limitations and Workarounds

This section lists known issues and workaround solutions for the components in the Oracle Application Testing Suite.

Oracle Application Testing Suite

The following are know issues and workaround solutions for Oracle Application Testing Suite.

weblogic.store.PersistentStoreException: [Store:280073]The file store "WLS_DIAGNOSTICS" could not be opened because it contained a file with the invalid version 1. A file of version 2 was expected.

Oracle Load Testing

The following are know issues and workaround solutions for Oracle Load Testing.

The ServerStats JMX discovery caches counter information. The side effect is that it also caches error messages. For example, failure to copy the correct jar files to data collector's classes directory prior to attempting the discovery would result in an error. When the discovery is attempted after copying the jar files, the discovery still may not work because of the cache. The recommended workaround is to re-start the Oracle Load Testing Server and retry the discovery.

Oracle Test Manager

The following are known issues and workaround solutions for Oracle Test Manager.