E Troubleshooting

This chapter provides information and possible solutions to known issues in OpenScript.

E.1 Installation

In some instances, the OpenScript Internet Explorer and/or Firefox browser plug-ins fail to install properly. You can manually install and uninstall Internet Explorer and/or Firefox browser plug-ins using batch files provided with OpenScript to resolve the issue.

The following batch files are located in <installdir>\OpenScript

  • InstallBrowserHelpers.bat

  • UninstallBrowserHelpers.bat

Usage: file.bat installation path [install|uninstall] [IE|FF|both]

The following example shows the usage and default values:

InstallBrowserHelpers.bat C:\OracleATS\OpenScript\ install both

Note:

On Windows 2000 systems, the InstallBrowserHelpers.bat installation does not detect that the .NET Framework 2.0 is installed and will attempt to reinstall it, which may cause an installation failure for the .NET Framework 2.0. However, the .NET Framework 2.0 is installed during the initial OpenScript installation and should be present on the system. Check Add/Remove Programs in the Control Panel to verify the .NET Framework 2.0 installation.

See the remarks in the batch files for additional information.

E.2 OpenScript Script Execution in Oracle Test Manager

The following additional steps are required in order to run the following types of OpenScript scripts from Oracle Test Manager:

  • Siebel Functional

  • Oracle Forms Functional

  • Web Functional scripts that rely on system input events, such as key press or mouse click

It is necessary to run these scripts using an interactive desktop of a named Windows user account that is always logged in.

  1. For Siebel and Oracle Forms, the named user's account must have visited the Siebel or Oracle Forms site at least once to ensure that all necessary ActiveX controls and plug-ins are installed in the named user's browser.

  2. On the Oracle Test Manager agent machine that will run the scripts, stop the "Oracle Agent Starter Service" and configure it to start manually.

  3. On the Oracle Test Manager agent machine, login as the named Windows user account that will run the scripts. From a command prompt, run:

    C:\OracleATS\agentmanager\bin\AgentManagerService.exe -c 
      C:\OracleATS\agentmanager\bin\AgentManagerService.conf
    

    where C:\OracleATS is the OATS installed folder.

  4. The named user account must remain logged into the system at all times that scripts will be run.

E.3 Manual Installation of Firefox Extension

If Firefox is upgraded or newly installed after installing OpenScript, it may be necessary to install the OpenScript Firefox extension into it in order to record from it. To install the OpenScript Firefox extension, run the OpenScript Diagnosis Tool, which will automatically detect the missing Firefox extension and install it. To run the OpenScript Diagnosis Tool, select OpenScript Diagnosis Tool from the Help menu.

E.4 Installation of Security Certificate in Internet Explorer

The Internet Explorer browser reports There is a problem with this website's security certificate when recording load test scripts for HTTPS sites. This occurs because the OpenScript proxy is between the browser and the Web Server so the browser does not get the SSL certificate directly from the website. The browser gets the OpenScript proxy's SSL certificate instead.

This issue affects all scripts that record with the Proxy, which are:

  • HTTP Load

  • Siebel Load

  • Oracle EBS/Forms Load

  • Oracle Fusion/ADF Load

  • Flex Load

  • Web/HTTP Load

  • Web Services

The Internet Explorer browser will display the warning every time you record unless you explicitly tell the browser to trust the OpenScript certificate.

Caution:

Following these steps may have security implications. The machines where the OpenScript product is installed should be strictly used for testing.

To install the OpenScript certificate on Internet Explorer browsers:

  1. Create a load test script project and start recording the website. The Certificate Error: Navigation Blocked screen appears with the message There is a problem with this website's security certificate.

  2. Click the Continue to this website (not recommended) link. This will navigate to the website with a “Certificate Error” indicated in the a browser address bar.

  3. Click the "Certificate Error" indicator box on the right-side of the Internet Explorer address bar.

  4. Click "View Certificates" in the Certificate Invalid dialog box.

  5. Click "Install Certificate" in the Certificate Information dialog box to open the wizard to install the OpenScript certificate to the Internet Explorer browser.

  6. Click Next twice at the wizard prompts and then click Finish.

  7. Click Yes in the Security Warning dialog box to install the OpenScript certificate.

  8. Click OK to close the installation successful message.

  9. Select Internet Options from the Internet Explorer Tools menu.

  10. Click the Advanced tab and clear the Warn about certificate address mismatch* option.

  11. Click OK to close the Internet Options.

For Firefox browsers (v24):

  1. Click Options.

  2. Select the Certificates tab.

  3. Click View Certificates.

  4. Click Add Exception.

  5. Enter the URL of the page with the error in the Location field and click Get Certificate.

  6. Select Permanently store this exception and click Confirm Security Exception.

The next time you record scripts, the security certificate warning should no longer appear with the OpenScript certificate accepted in Internet Explorer browser.