This chapter explains how to install the Oracle Communications Services Gatekeeper Application Test Environment (ATE), which is a graphical user interface tool for testing Services Gatekeeper applications.
For more information about ATE, see "Understanding the Application Test Environment" in Services Gatekeeper Application Developer's Guide.
You download and install the ATE separately from other Services Gatekeeper software. You do not need to install Services Gatekeeper to install and run the ATE.
The procedure for installing Services Gatekeeper ATE follows these steps:
Set your environment variables to point to the JRE.
Install Services Gatekeeper ATE.
For information on how to use the features in ATE, see "Testing Applications with the Application Test Environment" in Services Gatekeeper Application Developer's Guide.
The ATE is supported on the following operating systems:
Windows 7
Red Hat Linux, Version 6
Mac OS X 10.6
The ATE requires JDK 1.8 or higher, plus the latest security updates.
Install JRE on your system and set your environment variables.
To set up your system for ATE installation:
If a JDK is not already installed on your system, install it. See "ATE System Requirements" for the supported JDK versions.
Set the JAVA_HOME environment variable to the JRE bin directory.
Add the JRE bin directory to your PATH environment variable.
This section describes how to install the ATE in GUI mode.
Note:
Services Gatekeeper ATE requires administrator access if you are installing it on a Windows-based host system.To install the ATE in GUI mode:
Download the ATE installer from the Oracle software delivery website:
Open a command window on the system where you are installing the ATE.
From the directory where you downloaded the ATE package, do one of the following:
To start the installer on Windows or Linux, enter:
java -jar ocsg_sdk_generic.jar
To start the installer on Mac OS X, enter:
java -Dos.name=unix -jar ocsg_sdk_generic.jar
After you start the installer, the Welcome screen appears.
Click Next.
The Installation Location screen appears.
In the Oracle Home field, enter the full path to your Middleware home directory or use the Browse button to locate the directory.
The Middleware home directory is the central directory for all Oracle products installed on the target system, such as WebLogic Server, Services Gatekeeper, and Services Gatekeeper ATE.
To see a list of Oracle products that are currently installed in the directory, click View.
Click Next.
The Installation Type screen appears.
Click Next.
The Prerequisite Checks screen appears.
The screen automatically tests your system to ensure that it meets all operating system and JDK software requirements:
A green check mark indicates that your system passed the prerequisite check.
A red circle indicates a problem. The bottom of the screen shows a short error message to help you troubleshoot the problem. Fix the error and click Rerun to perform the prerequisite checks again. To continue the installation without fixing the problem, click Skip.
Click Next.
The Installation Summary screen appears.
Ensure that the listed installation location and feature sets to install are correct.
If the list is not correct, you can use the Back button to make corrections.
To save the information to a response file so you can install the component later, click Save Response File and specify the name and location of the response file.
Click Install to start the installation.
The Installation Progress screen appears, and a progress bar indicates the status of the installation process.
Click Next.
When the Installation Complete screen appears, click Finish.
The installer exits.
This section describes how to install the ATE in silent mode on all platforms.
Use silent mode for installing duplicate installations on multiple machines. You do this by creating and using the response.rsp configuration file, and then specifying it as a parameter during a silent mode installation. When silent mode is used, the installation program does not display any options during the installation process.
To install the ATE in silent mode:
Log in to the target system.
Download the Services Gatekeeper ATE installer from the Oracle software delivery website:
Create a response.rsp file in a text editor.
Add the following contents to the file:
[ENGINE]
#DO NOT CHANGE THIS.
Response File Version=1.0.0.0.0
[GENERIC]
#The oracle home location. This can be an existing Oracle Home or a new Oracle Home
ORACLE_HOME=Middleware_home
#Set this variable value to the Installation Type selected. For example, ATE.
INSTALL_TYPE=ATE
Save the file in the directory where you downloaded the ATE package.
From the directory where you downloaded the ATE package, enter:
java -jar ocsg_sdk_generic.jar -silent -responseFile ResponseFile
where ResponseFile is the full path and name of the Response File. For example, /home/use/bin/response.rsp.
The installation proceeds with no prompts.