Oracle® Application Testing Suite

Installation Guide

Release 12.5.0.1

E55188-02

February 2015

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

Caution:
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.

Note:
The user should have privileges to create, remove, and change files in all subdirectories of JREs with JRE 1.6.45+ and from 7u21 to 7u45 (excluding).
For example, C:\program files (x86)\java\jre7 and its subdirectory or subdirectories.

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:

- Contents

- Installing the Applications on Windows Machines

- Installing the Applications on Linux Machines

- Installing the Oracle Load Testing Remote Agent

- Preparing for a "Clean" Installation

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

- Installing OLT/OTM after OpenScript Only Install

- Documentation Accessibility

Installing the Applications on Windows Machines

You can install Oracle Application Testing Suite from the product download zip file.

Note:
As of version 12.5.0.1, Oracle Application Testing Suite no longer supports Oracle Database XE 10g. If you are upgrading from an earlier version of Oracle Application Testing Suite and are using Oracle Database XE 10g, you must migrate your data to Oracle Database XE 11g before starting the Oracle Application Testing Suite upgrade procedure. If you start the upgrade procedure with Oracle Database XE 10g installed, you will receive a warning message allowing you to cancel the installation.
See the following location for information about migrating the data:

http://docs.oracle.com/cd/E17781_01/index.htm

From the Oracle Web site: http://www.oracle.com/technetwork/oem/app-test/index.html

1. Select and download the Oracle Application Testing Suite zip file(s) from the web site and save it to a temporary directory on your hard disk.

- oats-win32-full-version.zip: Full installation plus all prerequisites (Oracle Application Testing Suite, Product documentation PDF files, WebLogic Server 11gR2 developer edition, Oracle Database Express Edition 11g (32-bit version), .NET Framework 2.0, Eclipse 3.4.1, Sun JRE 1.6.0_07, Oracle JRockit 4.0.0.1.6.0.R28)

- oats-win64-full-version.zip: Full installation plus all prerequisites (Oracle Application Testing Suite, Product documentation PDF files, WebLogic Server 11gR1 (10.3.5) developer edition, Oracle Database Express Edition 11g (64-bit version), .NET Framework 2.0, Eclipse 3.4.1, Sun JRE 1.6.0_07, Oracle JRockit 4.0.0.1.6.0.R28)

Note:
The Microsoft .NET Framework 3.5 must be installed prior to installing Oracle Application Testing Suite for Windows 8 or Windows 2012 Server. If you are using Windows 8 or Windows 2012 Server, you must download and install Microsoft .NET Framework 3.5 before installing Oracle Application Testing Suite.

- oats-win32-micro-version.zip: Oracle Application Testing Suite and product documentation PDF files without prerequisites. For new installations or upgrading a previous release. If upgrading from a version older than 9.1, use the Complete Install.

- oats-win32-openscript-quick-install-version.zip: Oracle OpenScript only installation.

- oats-docs-version.zip: Oracle Application Testing Suite documentation PDF files.

2. Unzip the downloaded file and run the setup.bat file for Oracle Application Testing Suite. Run install-openscript.bat to run the OpenScript only installation. The OpenScript only installer does not support "upgrade" installation (i.e. installing "over" a previous install). In order to reinstall OpenScript only, you must first uninstall any existing OpenScript installation. See Uninstalling the Applications from Windows Machines and Step 4: Remove Environment Variable and Browser Properties File for additional information.

Note:
Important: Windows Vista, 2008 or Windows 7 users, select Run as Administrator from the right-click shortcut menu. This is required process for the Operating Systems that have User Account Control (UAC) enabled.

3. Follow the setup instructions to install the Oracle Application Testing Suite or Oracle OpenScript only application.
During the installation for Oracle Application Testing Suite 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:

- Oracle Test Manager users "default" and "administrator".

- Oracle Load Testing users "default" and "administrator".

- User "JMSAdmin" used for Oracle Load Testing agent to controller authentication.

- User "oats" for Weblogic Server - this is a Weblogic superuser.

- User "oats-agent" in Weblogic Server for JMS communication between agent and controller - this is not a Weblogic superuser.

- Database users "oats", "olt", "otm".

- Database users (XE's defaults) "system" or "sys".

Notes:
When installing Oracle Application Testing Suite server components on a machine that:

1. has no previous version of Oracle Application Testing Suite installed, AND

2. has Oracle Enterprise Edition database installed,

make sure to choose the "Custom Installation" option and specify the connection credentials for your Oracle Enterprise Edition database. If you choose "Complete Installation", Oracle Application Testing Suite will install Oracle XE database, which may not run properly alongside Oracle Enterprise Edition database on the same machine.

If you install Oracle Database 12c before installing Oracle Application Testing Suite, you must clear the "Create a Container Database" option (which is selected by default) in the Oracle Universal Installer. If you install Oracle Database 12c with the "Create a Container Database" option setting enabled, the Oracle Application Testing Suite installation fails with the error "invalid common user or role name Exception in thread Main Thread". However, if you install Oracle Database 12c with the "Create a Container Database" option disabled, Oracle Application Testing Suite can be installed successfully. Oracle Application Testing Suite does not support the new "multitenant container database" feature which was introduced in Oracle Database 12c.

When upgrading Oracle Application Testing Suite from a previous version, the installation process may display a Confirm message indicating the Oracle Test Manager schema is an older version and must be upgraded to the latest version. The message recommends making a backup of the schema and requires you to select the I have a backup of the schema I am about to upgrade checkbox before proceeding.

If you do not have a backup of the schema click No to exit the installation and make a backup of the schema before proceeding. See the "Exporting and Importing Databases" section of the Configuring Databases chapter of the Oracle Test Manager User's Guide or online help for information about backing up the database.

If you do have a backup of the schema, select the I have a backup of the schema I am about to upgrade checkbox and click Yes to proceed with the installation. If the upgrade procedure detects any problems with the database (such as duplicate records or incorrect sequence values) it will automatically correct the problems.

Manually Configuring the Installation

The above installation procedure for Oracle Application Testing Suite setup.bat in oats-full-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.

If there is no database installed and you will not be using a remote database, you will need to install Oracle XE or EE on the local machine. Install an Oracle Database or acquire the hostname, port, instance, and credentials for an existing one.

If WebLogic Server is not installed on the local machine, you must download Weblogic 11gR1P2 (10.3.5) from download.oracle.com and install it. Install Weblogic 11gR1P2 (10.3.5) on your local machine or acquire the location on your local machine of a Weblogic instance of the same version.

To manually configure Weblogic and create the database schema:

1. Create the following environment variables:
WL_HOME=The location of your Weblogic home (typically C:\Oracle\Middleware\wls if it was installed with default options).

MW_HOME=The location of your Weblogic root folder (typically C:\Oracle\Middleware if it was installed with default options).

WLS_PW=Your master password. This will be used to set your admin password for Weblogic, as well as to create your Default and Administrator accounts in Oracle Load Testing and Oracle Test Manager.

DB_HOST=The location of your database.

DB_NAME=The name of the database that Oracle Application Testing Suite will use. For XE installations, the name is typically XE. For EE installation this will depend on your installation settings.

DB_PORT=The port of your database (typically 1521).

DB_USER=The admin user of your database (typically "system"),

DB_PASS=The password of the database user.

DB_URL=jdbc:oracle:thin:@//<hostname>:<port>/<servicename>

2. Run <installdir>\bin\install.bat. This will delete your previous OATS domain, if any, and recreate it. (If the install is fresh you do not need to run this .bat file.)

3. Change to directory %OATS_HOME%\bin and issue the following commands (in order):

initConfig
dbsetup
config_ds
unpack
storeUser
installSvc
restartSvc "OracleATSServer"
deploy %OATS_HOME%\install\oats.ear
config_sec

4. Validate your installation by going to http://localhost:8088/olt and verify that you can successfully login (i.e. with credentials Default/master password) and use the product.

Uninstalling the Applications from Windows Machines

To uninstall the Oracle Application Testing Suite applications:

1. Select Uninstall Oracle Application Testing Suite from the Oracle Application Testing Suite Start menu.

2. Select OATS in the tree.

3. Click Remove.

To uninstall the Oracle OpenScript only application:

1. Select Uninstall OpenScript from the Tools submenu of the Oracle Application Testing Suite Start menu.

See Preparing for a "Clean" Installation for additional information.

Installing the Applications on Linux Machines

Oracle Application Testing Suite server components (Oracle Load Test/Oracle Test Manager) and Agent components (Oracle Load Test agent/Data Collector) can be installed on Linux via a separate installer; however Oracle OpenScript is Windows only. Oracle Application Testing Suite components have been tested with Oracle Enterprise Linux 5.1 64 bit, 5.2 64 bit, 4u8 64 bit. Note that Data Sources (Perfmon, Ping, COM+, and the SSH version of Virtual Agent) cannot be used on a Linux Data Collector.

The Oracle Application Testing Suite Linux installer is based on the Oracle Universal Installer (OUI) which requires UI based access. To install the Oracle Application Testing Suite server components on Linux you will need to access XTerm. XTerm, most typically, can be accessed over VNC.

Installing Oracle XE or EE Database

The Oracle Application Testing Suite installer requires a working instance of Oracle XE or Oracle EE database. If you have not installed and configured an Oracle XE or Oracle EE database, install and configure an Oracle XE or EE database before installing the Oracle Application Testing Suite server components.

Note:
See the Oracle® Database Installation Guide <Release> for Linux in the Oracle Database Documentation Library for additional information about installing Oracle EE databases.
http://www.oracle.com/technetwork/indexes/documentation/index.html

To install an Oracle XE database:

1. Open a terminal window and install XE database, as follows:

sudo rpm -ivh downloads/oracle-xe-11.2.0-1.0.x86_64.rpm

A progress bar displays during the installation which is followed by the final message: You must run '/etc/init.d/oracle-xe configure' as the root user to configure the database.

2. Configure the database, as follows:

sudo /etc/init.d/oracle-xe configure

3. When prompted, enter a password for database accounts. Enter: oracle.

4. For the remainder of the configuration, click Enter to accept the default values for most common use-cases.

Installing Oracle Application Testing Suite Components

Note:
As of version 12.5.0.1, Oracle Application Testing Suite no longer includes Oracle Application Testing Suite Linux (32-Bit) Installer. Oracle Application Testing Suite Linux (64-Bit) Installer should be used for all Linux deployments.

From the Oracle Web site: http://www.oracle.com/technetwork/oem/app-test/index.html

1. Select and download the Oracle Application Testing Suite zip file(s) from the web site and save it to a temporary directory on your hard disk.

- oats-docs-version.zip: Oracle Application Testing Suite documentation PDF files.

- oats-linux64-full-version.zip: Full Linux installation plus WebLogic Server for 64-Bit machines.

- oats-linux64-micro-version.zip: Linux installation without prerequisites for 64-Bit machines.

2. Be sure to install an XE or Oracle EE database before the ATS install. See Installing Oracle XE or EE Database.

3. Unzip the downloaded file for the Oracle Application Testing Suite.

4. Enter the installation folder where you unzipped the download file.

5. Set appropriate permissions for the installation shell script to execute, as follows:

chmod u+rwx,g+rx,o+x setup.sh

6. Edit the installation Shell script setup.sh and change ORACLE_HOME to any designated location under your scratch folder (for example: /scratch/<myFolder>/oats12, as follows:

#!/bin/bash
INSTALL_DIR="'dirname $0'" cd "$INSTALL_DIR" INSTALL_DIR="'pwd'"
cd - INSTALL_DIR=$( echo "$INSTALL_DIR" | sed -e 's/ /\\ /g' )

##Adding Chmod to add execute permissions for files.

chmod -R 777 $INSTALL_DIR/ 1> /dev/null 2>&1 $INSTALL_DIR/oui/bin/runInstaller
-force -noconsole ORACLE_HOME="/scratch/myFolder/oats12"
ORACLE_HOME_NAME="OATS" SHOW_EXIT_CONFIRMATION=false
SHOW_SUMMARY_PAGE=true INSTALL_ROOT=$INSTALL_DIR

##COMPONENT_LANGUAGES={"$LOCALE"} SELECTED_LANGUAGES={"$LOCALE"}

7. Run the setup.sh file to start the GUI installation for the Oracle Application Testing Suite.

sh setup.sh

You cannot install Oracle Application Testing Suite as root, so do not use sudo sh setup.sh.

8. 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:

- Oracle Test Manager users "default" and "administrator".

- Oracle Load Testing users "default" and "administrator".

- User "JMSAdmin" used for Oracle Load Testing agent to controller authentication.

- User "oats" for Weblogic Server - this is a Weblogic superuser.

- User "oats-agent" in Weblogic Server for JMS communication between agent and controller - this is not a Weblogic superuser.

- Database users "oats", "olt", "otm".

- Database users (XE's defaults) "system" or "sys".

9. Specify Inventory Directory and credentials, as follows:

Enter full path of inventory directory: /scratch/<myFolder>/oraInventory

Specify Operating System group name: dba

10. Click Next.

11. Select Installation Type: Complete and click Next.

12. Specify Home Details, as follows:

Name: Home1

Path: /scratch/<myFolder>/oats12

13. Click Next.

14. Enter Install Location, as follows:

Folder: /scratch/<myFolder>/oracleats

15. Click Next.

16. Set the Master Password by entering and confirming the password, for example:

Enter password: oracle123

Confirm password: oracle123

17. Click Next.

18. Specify Oracle Database Installation, as follows:

Configure an existing Oracle XE or EE Database

19. Click Next.

20. Specify Oracle Database Information, as follows:

DB Hostname: localhost
Port: 1521
Service Name: XE
Db User: system
DB Password: oracle

21. Click Next.

22. Review the Summary details and click Install. The installation will continue automated install until you see the following message:

Execute Configuration Scripts
The following configuration scripts need to be executed as the "root" user

Scripts to be executed:
1. /scratch/<myFolder>/oraInventory/orainstRoot.sh
2. /scratch/<myFolder>/oats12/root.sh

23. Open a terminal window and execute the configuration scripts, as follows:.
Script 1: orainstRoot.sh

sudo sh /scratch/<myFolder>/oraInventory/orainstRoot.sh

Script 2: root.sh

sudo sh /scratch/<myFolder>/oats12/root.sh

24. Enter the Oracle Application Testing Suite Agent Manager password: (the same as the Master installation password entered and confirmed in the previous step above).
The script execution will complete with following confirmation messages: "OATS Agent Manager (OracleATSAgent) service is now running!" "Oracle Application Testing Suite Linux Agent is now installed!"

25. Exit the terminal window and click OK in the Execute Configuration Script pane of the installation GUI.

26. Click Exit on the End of Installation pane to complete the installation.

27. Navigate to http://<linux-host-name>:8088/ to start using the OATS application.

Starting the Applications on Linux Machines

This section lists how to start Oracle Application Testing Suite applications and utilities on Linux machines. It also lists how to restart and stop the application service.

To start the Oracle Application Testing Suite Administrator:

http://<machine>:8088/admin or http://localhost:8088/admin

To start the Oracle Test Manager application:

http://<machine>:8088/otm or http://localhost:8088/otm

To start the Oracle Load Testing application:

http://<machine>:8088/olt or http://localhost:8088/olt

To start the Database Configuration utility:

<installdir>/bin/DbConfig.sh

To start the Oracle Load Testing Agent Authentication Manager utility:

<installdir>/jdk/jre/bin/java -jar <installdir>/agentmanager/AMAuthManager.jar

To restart the Oracle Application Testing Suite service:

<installdir>/bin/restartSvc.sh [OracleATSServer|OracleATSAgent]

To stop the Oracle Application Testing Suite service:

<installdir>/bin/stopSvc.sh [OracleATSServer|OracleATSAgent]

To create a support package for troubleshooting purposes (OATSSupport.zip):

<installdir>/bin/oats_support.sh

Uninstalling the Applications from Linux Machines

To uninstall the Oracle Application Testing Suite server components or remote agent:

1. Run the setup.sh file to start the GUI installation for the Oracle Application Testing Suite.

sh setup.sh

You cannot uninstall Oracle Application Testing Suite as root, so do not use sudo sh setup.sh.

2. Follow the screen instructions for uninstalling the server components or remote agent.

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 appropriate .zip file from the download Web site:

- For Windows agents, use oats-full-version.zip and run setup.bat.

- For Linux agents, use oats-linux64-full-version.zip for 64-bit and run setup.sh. See Installing the Applications on Linux Machines for additional information.

2. Unzip the downloaded file and run the installation file.

3. Follow the setup instructions to install just the Remote Agent software.

4. 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.

- Make sure that you have the Oracle Load Testing Agent software loaded on the Agent system(s) and that it is the same version as the Oracle Application Testing Suite software that is loaded on the Oracle Load Testing Server system. The systems you plan to use as Agents must have either the Oracle Load Testing Agent software or the full Oracle Application Testing Suite installed to work as agents.

- Make sure you can successfully Ping all of the Agent systems from the Oracle Load Testing Server system. The machine names you use to Ping the systems are the same names that you will specify for the Agent systems in the Oracle Load Testing server. You can also use the IP addresses of the agent systems. If you cannot successfully Ping the Agent systems, contact your network administrator to resolve the issue. If you cannot Ping the Agent systems from the Oracle Load Testing Server system, you will not be able to run the Agents from the server.

- Make sure that the same user is logged in on both the Oracle Load Testing server system and all of the Agent systems. All of the Agent systems must have a user logged in to be controlled by the Oracle Load Testing Server system. You may be able to log in as a different user on the Agent systems as long as the user login has the same administrative privileges as the user logged in on the server system.

- From the server system, try mapping a drive on each of the Agent systems using Windows Explorer. Depending on how your network is setup, the server system may not be allowed to start up processes on the Agent systems. The easiest way around this is to map a drive to the Agent system in order to authenticate with Windows.

- In the Oracle Load Testing server add a Visual Script to the Scenario Profiles list. Enter the machine name or IP address of the Agent system where you want to run the Visual Script into the Systems Manager and select that machine in the Systems field on the Build Scenario tab of Oracle Load Testing.

Preparing for a "Clean" Installation

In some cases, you may want to prepare a system for "Clean" installation of the Oracle Application Testing Suite product. This may be required in the following cases:

- There is a previous beta version of the Oracle Application Testing Suite product installed on the system.

- It is necessary to downgrade the product from a newer version.

- An installation failure occurred for some reason and it is necessary to clean the environment to a fresh start.

The following sections provide step-by-step instructions to perform a clean installation of the Oracle Application Testing Suite product on your system.

Make sure to backup all scripts and databases before proceeding. See Installing over beta versions or earlier releases of Oracle Application Testing Suite for additional information.

Step 1: Uninstall Oracle Application Testing Suite Products

To uninstall Oracle Application Testing Suite product:

1. Run the Oracle Application Testing Suite Setup.bat file to launch "Oracle Universal Installer".

2. Click Deinstall Products. The Inventory window opens.

3. Expand the Oracle Homes tree and select the "OATS" checkbox.

4. Click Remove. The Remove window opens and starts the deinstallation procedure.

5. Wait for the Remove window to automatically dismiss itself. After the successful deinstalltion, the Inventory window may show "There are no installed products" if there no other Oracle products installed.

6. Close the Inventory window.

7. Click Cancel to close the Oracle Universal Installer.

Step 2: Uninstall Oracle XE Database

To uninstall Oracle XE Database:

1. Select Control Panel from the Start menu.

2. Open Add/Remove Programs or Program and Features depending upon your Windows version.

3. Find and select Oracle Database 11g Express Edition.

4. Click the Remove or the Uninstall/Change button from the tool bar, or double-click the item to launch the InstallSheild wizard.

5. Click Yes in the dialog box to remove the database.

6. Wait for the uninstallation to complete successfully.

7. Click Finish to close the InstallShield wizard.

Step 3: Remove or Rename Installation Folders

To remove or rename installation folders:

1. Backup OpenScript scripts and script asset files in repositories or folders under the installation directory (in installdir\workspace! directories or installdir\directoryname directories).

2. Backup OpenScript scripts and script asset files in repositories under the installation directory (in installdir\workspace directories).

3. Remove or rename the Oracle Application Testing Suite installation directory (the default is C:\OracleATS).

4. Remove or rename the directory: C:\Documents and Settings\username\osworkspace (depending upon your Operating System, it may be similar to: C:\Users\username\osworkspace).

5. Remove or rename the directory: C:\Program Files\Oracle\Inventory (depending on your Operating System, it may be like: C:\Program Files (x86)\ Oracle\Inventory).

6. Remove or rename the file: C:\Windows\rsw.ini

Step 4: Remove Environment Variable and Browser Properties File

If you plan to perform an OpenScript only install after removing the Oracle Application Testing Suite applications, you must also remove the OATS_HOME environment variable and the browserHelper.properties file to prepare the machine for the installation.

To remove the OATS_HOME environment variable:

1. Open System settings in Control Panel.

2. Open System Properties. (depending upon Windows version, select Properties or Change settings).

3. Click Environment Variables on the Advanced tab.

4. Select the OATS_HOME variable and click Delete.

To remove the browserHelper.properties file:

1. Open Windows Explorer.

2. Navigate to %APPDATA%\Oracle\Application Testing Suite\browserHelper.properties file and delete the file.

Step 5: Remove the Services (Optional)

To remove Oracle Application Testing Suite services:

1. Select Run from the Start menu.

2. Type cmd and click OK.

3. Type the command: sc delete servicename, where servicename is each of the following:

- OracleATSAgent

- OracleATSServer

- OracleATSHelper

If the message "The specified services does not exist as an installed services" is returned from the program, the service was successfully removed by the previous steps.

Step 6: Remove the Registry Keys (Optional)

To remove Oracle Application Testing Suite Registry keys:

1. Select Run from the Start menu.

2. Type regedit and click OK.

3. Delete the following Registry keys using the Registry Editor:

- HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\OracleATSServer

- HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\OracleATSAgent

- HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\OracleATSHelper

If you do not find the keys in the Registry, they were successfully removed by the previous steps. Note: The keys may be found in the different location depends on your Operating System (search by the key to find the correct location).

Step 6: Restart the System (Optional)

While not required, it is a best practice to restart the system after uninstalling applications.

- Select Shutdown from the Start menu, then select Restart.

Step 7: Install Oracle Application Testing Suite

To install Oracle Application Testing Suite:

1. Make sure the installing user has administrator privilege on the system.

2. Unzip the oats-full-version.zip product download file in a temporary directory.

3. Using Windows Explorer, double-click the setup.bat to start the Oracle Universal Installer. See Installing the Applications on Windows Machines for additional information.

Note:
Important: Windows Vista, 2008 or Windows 7 users, select Run as Administrator from the right-click shortcut menu. This is required process for the Operating Systems that have User Account Control (UAC) enabled.

4. Follow the setup instructions to install the Oracle Application Testing Suite.

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

If you have a 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:

- OpenScript scripts and script asset files in repositories or folders under the installation directory (in installdir\workspace! directories or installdir\directoryname directories).

- Script and script asset files in repositories under the installation directory (in installdir\workspace directories).

- Oracle Load Testing reports database.

- Oracle Test Manager database.

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

Installing OLT/OTM after OpenScript Only Install

The Oracle Application Testing Suite 12.5.0.1 component based installer will install Oracle Load Testing and Oracle Test Manager over installed OpenScript only installations (of either version or pre 12.4.0.1). The installer will upgrade the OpenScript installation and will install other Oracle Application Testing Suite components.

Documentation Accessibility

For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.

Access to Oracle Support

Oracle customers that have purchased support have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.

Oracle Application Testing Suite Installation Guide Release 12.5.0.1

E55188-02

Copyright © 1997, 2015, Oracle and/or its affiliates. All rights reserved.

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable:

U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007). Oracle America, Inc., 500 Oracle Parkway, Redwood City, CA 94065.

This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group.

This software or hardware and documentation may provide access to or information about content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services unless otherwise set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services, except as set forth in an applicable agreement between you and Oracle.

Oracle Legal Notices

Copyright Notice

Copyright © 1994-2016, Oracle and/or its affiliates. All rights reserved.

License Restrictions Warranty/Consequential Damages Disclaimer

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

Warranty Disclaimer

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

Restricted Rights Notice

If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, then the following notice is applicable:

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

Hazardous Applications Notice

This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.

Trademark Notice

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group.

Third-Party Content, Products, and Services Disclaimer

This software or hardware and documentation may provide access to or information about content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services unless otherwise set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services, except as set forth in an applicable agreement between you and Oracle.

Alpha and Beta Draft Documentation Notice

If this document is in preproduction status:

This documentation is in preproduction status and is intended for demonstration and preliminary use only. It may not be specific to the hardware on which you are using the software. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to this documentation and will not be responsible for any loss, costs, or damages incurred due to the use of this documentation.

Private Alpha and Beta Draft Documentation Notice

If this document is in private preproduction status:

The information contained in this document is for informational sharing purposes only and should be considered in your capacity as a customer advisory board member or pursuant to your beta trial agreement only. It is not a commitment to deliver any material, code, or functionality, and should not be relied upon in making purchasing decisions. The development, release, and timing of any features or functionality described in this document remains at the sole discretion of Oracle.

This document in any form, software or printed matter, contains proprietary information that is the exclusive property of Oracle. Your access to and use of this confidential material is subject to the terms and conditions of your Oracle Master Agreement, Oracle License and Services Agreement, Oracle PartnerNetwork Agreement, Oracle distribution agreement, or other license agreement which has been executed by you and Oracle and with which you agree to comply. This document and information contained herein may not be disclosed, copied, reproduced, or distributed to anyone outside Oracle without prior written consent of Oracle. This document is not part of your license agreement nor can it be incorporated into any contractual agreement with Oracle or its subsidiaries or affiliates.

Documentation Accessibility

For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.

Access to Oracle Support

Oracle customers that have purchased support have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.