ORACLE HTTP SERVER WEBGATE INSTALLATION AND CONFIGURATION

The Oracle Http Server Webgate Installation And Configuration consists of following topics:

 

A WebGate is a web-server plug-in for Oracle Access Manager (OAM) that intercepts HTTP requests and forwards them to the Access Server for authentication and authorization.

Installing a WebGate for Oracle Access Manager involves the following steps:

Installing and Configuring Oracle HTTP Server WebGate

Obtain Oracle HTTP Server Webgate software from the Oracle Fusion Middleware Downloads. Download webgate.zip file (version 11.1.2.3.0) to a directory, and unpack the downloaded archive that contains the installer. By default, this directory is named webgate.

To start the installation wizard, perform the following steps:

Note: You must enter the absolute path of the JRE folder located in this JDK when launching the installer.

After the Installer starts, the Welcome screen is displayed. Proceed with the installation by referring to the section "Installation Flow and Procedure of Oracle HTTP Server 11g WebGate" for installing Oracle HTTP Server 11g WebGate for Oracle Access Manager.

To install Oracle HTTP Server 11g WebGate for Oracle Access Manager, follow the instructions as shown below:

Specify Inventory Directory Screen

Installer Prerequisite Setup

This screen appears for UNIX systems only; if this is your first Oracle installation on this host, you must specify the location of the inventory directory. This inventory directory is used by the installer to keep track of all Oracle products installed on the computer. The default inventory location is USER_HOME/oraInventory.

In the Operating System Group name field, select the group whose members you want to grant access to the inventory directory; all members of this group will be able to install products on this system.

Click Ok to continue.

Inventory Location Confirmation Screen

Installer Prerequisite Setup

This screen appears for UNIX systems only; you are asked to run the inventory_directory/createCentralInventory.sh script as root.

If you do not have root access on this system but want to continue with the installation, select Continue installation with local inventory.

Click Ok to continue.

Welcome Screen

Installer Prerequisite Setup

The Welcome screen is displayed each time you start the installer.

Click Next to continue.

Install Software Updates Screen

Installer Prerequisite Setup

If you want to search for and download software updates from My Oracle Support, then do the following:

Select Search My Oracle Support for Updates.

Enter User name and Password.

Click Test Connection.

If you want to search your local directory for updates, then do the following:

Select Search Local Directory for Updates.

Click Search For Updates.

If you want to skip software updates, then select Skip Software Updates. (Kindly follow recommended practices regarding updates depending on the setup requirements or usage.)

Click Next to continue.

Prerequisite Checks Screen

Installer Prerequisite Setup

This screen shows whether the system requirements are met in order to install the software.

If there is a problem, a short error message appears in the bottom portion of the screen. Fix the error, and click Retry to try again.

If you want to ignore the error or warning messages and continue with the installation, click Continue.

To stop prerequisite checking for all components, click Abort.

Click Next to continue.

Specify Installation Location Screen

Installer Prerequisite Setup

Specify the following installation locations:

Oracle Home directory is where your products will be installed. All software binaries will reside in this directory, and no runtime process can write to this directory.

Note: The Oracle Middleware Home path should be different from the Weblogic Server installation path, in case where Webgate installation would be done on the same server where Weblogic is installed.

This installation directory will be referred to as Webgate_ORACLE_HOME throughout the remainder of this document. If you are performing an installation on a Windows operating system, be sure that your directory paths are valid, and do not contain double backslashes (\\).

Click Next to continue.

Installation Summary Screen

Installer Prerequisite Setup

Review the information on this screen. The operations summarized on this page will be performed when you click Install.

If you want to make any changes to the configuration before starting the installation, use the navigation pane, and select the topic you want to edit.

If you want to save this configuration to a text file (called a response file), click Save. You will be prompted for the location of name of the file you want to create (for example, silent_install.rsp). This file can be used later if you choose to perform the same installation from the command line.

Click Install.

Installation Progress Screen

Installer Prerequisite Setup

This screen shows the progress of the installation.

If you want to quit before the installation is completed, click Cancel. Doing so will result in a partial installation; the portion of the software that was installed on your system before you click Cancel will remain on your system, and you will have to remove it manually.

Installation Complete Screen

Installer Prerequisite Setup

This screen summarizes the installation that was just completed.

You can save this summary information to a file for future reference by clicking Save. You will be prompted to specify a name and location for your summary file.

Click Finish to dismiss the screen.

Post-Installation Steps for Oracle HTTP Server WebGate

You must complete the following steps after installing Oracle HTTP Server 11g WebGate for Oracle Access Manager:

Installer Prerequisite Setup

In this command:

WebGate_Oracle_Home is the directory in which you have installed Oracle HTTP Server WebGate and created it as the Oracle home for WebGate.
Example: MW_HOME/Oracle_OAMWebGate1

WebGate_Instance_Directory is the location of WebGate Instance Home, which is same as the Instance Home of Oracle HTTP Server.

Example: MW_HOME/Oracle_WT1/instances/instance1/config/OHS/ohs1

Run the following command to ensure that the LD_LIBRARY_PATH variable contains Oracle_Home_for_Oracle_HTTP_Server/lib:

export LD_LIBRARY_PATH = $LD_LIBRARY_PATH:$Oracle_Home_for_Oracle_HTTP_Server/lib

From your present working directory, move to directory:

cd WebGate_Home/webgate/ohs/tools/setup/InstallTools

On the command line, run the following command to copy the apache_WebGate.template from the WebGate_Home directory to the WebGate Instance location (re-named to WebGate.conf) and update the httpd.conf file to add one line to include the name of WebGate.conf:

./EditHttpConf -w WebGate_Instance_Directory [-oh WebGate_Oracle_Home] [-o output_file]

In this command:

WebGate_Oracle_Home is the directory where you have installed Oracle HTTP Server WebGate for Oracle Access Manager and created as the Oracle Home for WebGate.

Example: MW_HOME/Oracle_OAMWebGate1

WebGate_Instance_Directory is the location of WebGate Instance Home, which is same as the Instance Home of Oracle HTTP Server.

Example: MW_HOME/Oracle_WT1/instances/instance1/config/OHS/ohs1

output_file is the name of the temporary output file used by the tool.

Example: Edithttpconf.log

Note: The -oh WebGate_Oracle_Home and -o output_file parameters are optional.

Verifying the Installation of Oracle HTTP Server WebGate

After installing Oracle HTTP Server 11g WebGate for Oracle Access Manager, including the post-installation steps, you can examine the install DATE-TIME_STAMP.out log file to verify the installation.

The default location of the log is : WebGate_Home/oraInst.loc

Registering the New Oracle HTTP Server 11g WebGate

Before you can use the new Oracle HTTP Server 11g WebGate agent for Oracle Access Manager, you must register the new WebGate agent with Oracle Access Manager by using the Oracle Access Manager Administration Console.

Refer to the Section “Post-Installation Tasks” under Oracle Access Management Configuration chapter.

Back