10 Installing the Platform Test Environment

This chapter describes how to install Oracle Communications Services Gatekeeper Platform Test Environment (PTE).

PTE is a graphical user interface (GUI) tool that you use to test default Services Gatekeeper features and your own custom communication services. For more information about PTE, see "Understanding the Platform Test Environment" in Services Gatekeeper Platform Test Environment User's Guide.

Overview of Installing PTE

You download and install the PTE separately from other Services Gatekeeper software.

The procedure for installing Services Gatekeeper PTE follows these steps:

  1. Install Services Gatekeeper. See "Installing Services Gatekeeper".

  2. Install Services Gatekeeper PTE.

  3. Perform post-installation tasks, such as connecting PTE to Services Gatekeeper and configuring your communication services. See "Configuring and Maintaining Your PTE Server Environment" in Services Gatekeeper Platform Test Environment User's Guide.

After installing and configuring Services Gatekeeper PTE, you can start it in GUI mode or console mode. For more information, see "Starting the PTE" in Services Gatekeeper Platform Test Environment User's Guide.

Installing the PTE in GUI Mode

You can create an installation log by using the -log=logfilename parameter on the command line when you run the installer. For more information about creating a log file, see "Creating an Installation Log".

Note:

Services Gatekeeper PTE requires administrator access if you are installing it on a Windows-based host system.

To install PTE:

  1. Log in to the target system.

  2. Download the Services Gatekeeper PTE installer from the Oracle software delivery website:

    https://edelivery.oracle.com/

  3. Change to the directory where you downloaded the software.

  4. Start the installer:

    java -jar ocsg_pte_generic.jar [-log=logfilename]
    

    After the installer starts, the Welcome screen appears.

  5. Click Next.

    The Installation Location screen appears.

  6. 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 PTE.

    To see a list of Oracle products that are currently installed in the directory, click View.

  7. Click Next.

    The Installation Type screen appears.

  8. Click Next.

    The Prerequisite Checks screen appears.

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

  10. Click Next.

    The Installation Summary screen appears.

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

  12. Click Install to start the installation.

    The Installation Progress screen appears, and a progress bar indicates the status of the installation process.

  13. Click Next.

  14. When the Installation Complete screen appears, click Finish.

Installing the PTE in Silent Mode

This section describes how to install the PTE 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 PTE in silent mode:

  1. Log in to the target system.

  2. Download the Services Gatekeeper PTE installer from the Oracle software delivery website:

    https://edelivery.oracle.com/

  3. Create a response.rsp file in a text editor.

  4. 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, .
    INSTALL_TYPE=PTE
    
  5. Save the file in the directory where you downloaded the PTE package.

  6. From the directory where you downloaded the PTE package, enter:

    java -jar ocsg_pte_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.

Where to Go from Here

To finish setting up PTE, perform the post installation tasks described in "Configuring and Maintaining Your PTE Server Environment" in Services Gatekeeper Platform Test Environment User's Guide.

If you want to install Services Gatekeeper Application Test Environment (ATE), see "Installing the Application Test Environment". Otherwise, perform the tasks described in "Services Gatekeeper Post-Installation Tasks".