5 Installing Services Gatekeeper

This chapter describes how to install Oracle Communications Services Gatekeeper.

Before installing Services Gatekeeper, read these chapters:

About Installing Services Gatekeeper

You must install Services Gatekeeper on every server in your implementation. You must install the software in a directory that resides on the server's local file system.

You install Services Gatekeeper by using a generic installer that works on any supported operating system and for both 64-bit and 32-bit platforms.

Installation Prerequisites

The generic installer does not include a bundled JDK. The JDK must already be installed when you use the generic installer.

Installing the JDK

You must download and install a supported JDK on the target system before installing Services Gatekeeper. If you are installing on a 64-bit system, you must install a 64-bit JDK or a hybrid 32/64-bit JDK. See "Software Requirements" for information about the required JDK version.

Download the JDK from the Java page on the Oracle Technology Network website at:

http://www.oracle.com/technetwork/java/index.html

Setting the Java Path

To ensure that the appropriate JDK is installed and that the Java path is set:

  1. Log in to the target system.

  2. Run the java -version command, or java -d64 -version command on platforms using a 32/64-bit hybrid JDK, to ensure that the JAVA_HOME variable is set to a 64-bit JDK.

    If JAVA_HOME is not correctly set, set it to point to the correct JDK.

  3. Add the bin directory of the JDK that you installed to the beginning of the PATH variable definition. For example:

    PATH=$JAVA_HOME/bin:$PATH
    export PATH
    

    Where JAVA_HOME represents the full path to the JDK directory.

Creating an Installation Log

To create an installation log, add the following option to any of the commands that launch the installer:

-log=logfilename

where logfilename is a name that you assign to the log file.

For example, the following command runs the installer in GUI mode and creates a log file named install_log containing the installation's output.

java -jar ocsg_multitier_generic.jar -log=install_log

Installing Services Gatekeeper in GUI Mode

This section describes how to install Services Gatekeeper in GUI mode.

Important:

  • Installing Services Gatekeeper on Windows is supported only for development and test environments; it is not supported for production.

  • If you are installing on Windows, you must log in as an administrator.

  • After starting the installer, you can cancel the installation at any time by clicking Exit.

To install Services Gatekeeper in GUI mode:

  1. Log in to the target system.

  2. Download the Services Gatekeeper 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.

    • To start the installer on a system that uses a 32/64-bit hybrid JDK, enter:

      java -d64 -jar ocsg_multitier_generic.jar [-log=logfilename]
      
    • To start the installer on a 32-bit system, enter:

      java -jar ocsg_multitier_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 the directory of your Middleware_home 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.

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

  7. Click Next.

    The Installation Type screen appears.

  8. Specify the components to install on this system by doing one of the following:

    • To install only the Administration Server, select Administration Server and click Next.

    • To install only the Network Tier, select Network Tier and click Next.

    • To install only the Portal server:

      1. Select Portal and click Next.

        The Portal Parameters screen appears.

      2. In the Access Tier Servers field, enter the address for each Access Tier server in your Services Gatekeeper implementation. The address uses the format IPAddress:Port. Each address must appear on its own line.

        The IP address and port of the backend server must match the IP address and port of the Access Tier. To view the Access Tier server port, in the Administration Console, click Servers, then AT Server Name, and then Listen Port.

      3. Click Next.

    • To install only the Access Tier, select Access Tier and click Next.

    • To install multiple Services Gatekeeper components:

      1. Select Custom Installation and click Next.

        The Features to Install screen appears.

      2. Select the checkbox for each component that you want to install on this system. To install all of the components, select the Oracle Communication Services Gatekeeper checkbox.

      3. 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, do one of the following:

    Important:

    If you plan to use Services Gatekeeper with an IPv6 network, do not configure the domain now. You must perform certain post-installation tasks first.
    • To configure your Services Gatekeeper domain now, click Finish.

      The WebLogic Server Configuration Wizard starts.

    • To complete installation without configuring your domain, deselect Automatically Launch the Configuration Wizard and click Finish.

      The Services Gatekeeper installer exits.

After installation completes, the WebLogic Server Configuration Wizard starts by default. For information about how to configure your Services Gatekeeper domain, see "Configuring the Domain in GUI Mode".

Installing Services Gatekeeper in Silent Mode

Silent mode is a way of setting installation options once and then using those settings to duplicate the installation on many machines. The installation program reads your settings from a Response File that you create prior to beginning the installation. The installation program does not display any options during the installation process. Silent-mode installation works on Windows, Solaris, and Linux systems.

About the Response File

The entries in the Response File (response.rsp) correspond to the prompts that you would see if you used GUI mode.

Incorrect entries in the Response File can cause the installation to fail. To help you determine the cause of a failure, Oracle recommends that you create a log file when you start the installation.

The following is a sample version of the Response File. Your input may be slightly different, depending on your installation.

[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=c:\oracle\ocsg6.0
 
#Set this variable value to the Installation Type selected (for example, WebLogic Server, Coherence, Complete with Examples).
INSTALL_TYPE=Complete with Examples
 
#Provide the My Oracle Support Username. If you want to ignore Oracle Configuration Manager configuration, provide an empty string
#for the user name.
MYORACLESUPPORT_USERNAME=
 
#Provide the My Oracle Support Password
MYORACLESUPPORT_PASSWORD=<SECURE VALUE>
 
#Set this to true if you want to decline the security updates. Setting this to true and providing an empty string for the My Oracle Support 
#username will ignore the Oracle Configuration Manager configuration.
DECLINE_SECURITY_UPDATES=true
 
#Set this to true if My Oracle Support Password is specified.
SECURITY_UPDATES_VIA_MYORACLESUPPORT=false
 
#Provide the Proxy Host.
PROXY_HOST=
 
#Provide the Proxy Port.
PROXY_PORT=
 
#Provide the Proxy Username.
PROXY_USER=
 
#Provide the Proxy Password.
PROXY_PWD=<SECURE VALUE>
 
#Type String (URL format) Indicates the OCM Repeater URL which should be of the format [scheme[Http/Https]]://[repeater host]:[repeater port]
COLLECTOR_SUPPORTHUB_URL=

Returning Exit Codes to the Console

When run in silent mode, the installation program generates exit codes that indicate the success or failure of the installation. Table 5-1 describes these exit codes:

Table 5-1 Installation Program Exit Codes

Code Description

0

Installation completed successfully.

-1

Installation failed due to a fatal error.

-2

Installation failed due to an internal XML parsing error.


When you start the silent-mode installation process from a script, you can use the echo command to have these exit codes displayed to the console. The following is a sample command file that invokes the installer in silent mode and sends the exit codes to the console.

Example 5-1 Script that Returns Exit Codes

rem Execute the installer in silent mode
@echo off
java -jar ocsg_multitier_generic.jar -silent -responseFile=/home/use/bin/response.rsp -log=logfilename

@rem Return an exit code to indicate success or failure of installation
set exit_code=%ERRORLEVEL%

@echo.
@echo Exitcode=%exit_code%
@echo.
@echo Exit Code Key
@echo ---------------
@echo  0=Installation completed successfully
@echo -1=Installation failed due to a fatal error
@echo -2=Installation failed due to an internal XML parsing error
@echo.

Running the Installer in Silent Mode

To install Services Gatekeeper in silent mode on any supported platform:

  1. Log in to the target system.

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

    https://edelivery.oracle.com/

  3. Create a response.rsp file, as described in "About the Response File".

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

  5. Start the installer by entering the following command:

    java -jar ocsg_multitier_generic.jar -silent -responseFile ResponseFile
    

    where ResponseFile is the full path and name of the Response File. For example, /home/use/bin/response.rsp.

  6. Check whether the installer completed successfully by retrieving the exit codes, as described in "Returning Exit Codes to the Console".

Where to Go from Here

If you want to install:

Otherwise, perform the tasks in "Services Gatekeeper Post-Installation Tasks".