2 Installing and Configuring Oracle HTTP Server 11g WebGate for OAM

2.1 Prerequisites for Installing Oracle HTTP Server 11g WebGate

This section discusses the following topics:

• Oracle Fusion Middleware Certification

• Installing and Configuring Oracle HTTP Server 11g

• Installing and Configuring OAM 11g

• Prerequisites for 64-Bit Oracle HTTP Server 11g WebGates on Windows 2003 and Windows 2008 64-Bit Platforms

http://www.oracle.com/technology/software/products/middleware/htdocs/fmw_11_download.html

http://edelivery.oracle.com/

2.2 Installing Oracle HTTP Server 11g WebGate

This section discusses the following topics:

• Obtaining the Software

• Starting the Oracle HTTP Server 11g WebGate Installer

• Installation Flow and Procedure of Oracle HTTP Server 11g WebGate

2.3 Post-Installation Steps for Oracle HTTP Server 11g WebGate

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

• On UNIX

  1. Go to the WebGate_Home/webgate/ohs/tools/deployWebGate directory by running the following command:

     cd WebGate_Home/webgate/ohs/tools/deployWebGate

  2. Run the following command to copy the required bits of agent from the WebGate_Home directory to the WebGate_Instance location:

     ./deployWebGateInstance.sh -w WebGate_Instance_Directory -oh WebGate_Oracle_Home

     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

       Note:

       An Instance Home for Oracle HTTP Server is created after you configure Oracle HTTP Server. This configuration is performed after installing Oracle HTTP Server 11.1.1.2.0 or patching to Oracle HTTP Server 11.1.1.5.0.

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

  4. From your present working directory, move up one directory level:

     WebGate_Home/webgate/ohs/tools/setup/InstallTools

  5. 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]

     Note:

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

     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

• On Windows

  1. Move to the following directory under your Oracle Home for WebGate:

     WebGate_Home\webgate\ohs\tools\deployWebGate

  2. Run the following command to copy the required bits of agent from the WebGate_Home directory to the WebGate_Instance location:

     deployWebGateInstance.bat -w WebGate_Instance_Directory -oh WebGate_Oracle_Home

     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

       Note:

       An Instance Home for Oracle HTTP Server is created after you configure Oracle HTTP Server. This configuration is performed after installing Oracle HTTP Server 11.1.1.2.0 or patching to Oracle HTTP Server 11.1.1.7.0.

  3. Run the following command to ensure that the LD_LIBRARY_PATH variable contains Oracle_Home_for_Oracle_HTTP_Server\lib:

     Set the WebGate_Installation_Directory\webgate\ohs\lib location and the Oracle_Home_for_Oracle_HTTP_Server\bin location in the PATH environment variable. Add a semicolon (;) followed by this path at the end of the entry for the PATH environment variable.

  4. From your present working directory, move up one directory level:

     WebGate_Home\webgate\ohs\tools\EditHttpConf

  5. Run the following command to copy the apache_WebGate.template from the WebGate_Home directory to the WebGate Instance location (renamed to WebGate.conf) and update the httpd.conf file to add one line to include the name of WebGate.conf:

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

     Note:

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

     In this command:

     • WebGate_Oracle_Home is the directory in which 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

2.4 Verifying the Installation and Configuration of Oracle HTTP Server 11g WebGate

After installing Oracle HTTP Server 11g WebGate for Oracle Access Manager, including the post-installation steps, you can examine the installDATE-TIME_STAMP.out log file to verify the installation. The default location of the log are as follows:

• On UNIX

  WebGate_Home/oraInst.loc

• On Windows

  C:\Program Files\Oracle\Inventory\logs

2.5 Getting Started with a New Oracle HTTP Server 11g WebGate

Before you can use the new Oracle HTTP Server 11g WebGate agent for Oracle Access Manager, you must complete the following tasks:

1. Registering the New Oracle HTTP Server 11g WebGate

2. Copying Generated Files and Artifacts to the Oracle HTTP Server WebGate Instance Location

3. Restarting the Oracle HTTP Server Instance

2.6 Deinstalling Oracle HTTP Server 11g WebGate

You should always use the instructions provided in this section for removing the Oracle HTTP Server 11.1.1.7.0 WebGates for Oracle Access Manager. If you try to remove the software manually, you may experience problems when you try to reinstall the software again at a later time. Following the procedures in this section will ensure that the software is properly removed.

To deinstall the WebGate agent, do the following:

1. Go to the MW_HOME/webgate_Home/oui/bin directory on UNIX, and MW_HOME\Webgate_home\oui\bin on Windows.

2. Run the following command:

   On UNIX: ./runInstaller -deinstall

   On Windows: setup.exe -deinstall -jreLoc JRE_LOCATION

   Ensure that you specify the absolute path to your JRE_LOCATION; relative paths are not supported.

After the deinstaller starts, the Welcome screen is displayed. Proceed with the deinstallation by referring to Section 2.6.1.

2.7 Silent Installation for Oracle HTTP Server 11g WebGate

To run the Oracle HTTP Server 11g WebGate in silent mode, complete the following steps:

1. Set the contents of the silent.rsp file. For example:

   [ENGINE]
   #DO NOT CHANGE THIS.
   Response File Version=1.0.0.0.0
   [GENERIC]
   ORACLE_HOME=/home/MW_HOME/ohs_Webgate_home
   MIDDLEWARE_HOME=/home/MW_HOME
   [SYSTEM]
   [APPLICATIONS]
   [RELATIONSHIPS]
   

   In the preceding file, the parameters are as follows:

   • ORACLE_HOME: Provide the Oracle Home location. This is the directory in which you want to install the new Oracle HTTP Server WebGate. The location must be an immediate child folder under the specified Middleware Home location. The Oracle Home directory name can contain only alphanumeric, hyphen (-), dot (.), and underscore (_) characters, and must begin with an alphanumeric character. The total length has to be less than or equal to 128 characters. For example, home/middleware/ohs_webgate.

   • MIDDLEWARE_HOME: Specify the full path to your Middleware home directory.

2. Extract the contents of the installer to a directory.

3. Run the following command:

   WebGate_Installer_Directory/Disk1/runInstaller -jreLoc jre_location -invPtrLoc Absolute_Path_Of_the_oraInst.loc_file -silent -response Absolute_Path_Of_the_silent.rsp_file

   In the preceding command:

   • WebGate_Installer_Directory is the absolute path to the directory in which you have extracted the contents of the WebGate installer.

   • jre_location is the absolute path to the JRE directory.

   • Absolute_Path_Of_the_oraInst.loc_file is the absolute path to the oraInst.loc file.

   • Absolute_Path_Of_the_ silent.rsp_file is the absolute path to the silent.rsp file you created.

2.8 Upgrading Oracle HTTP Server Webgate 11.1.1.5.0 or 11.1.1.6.0 to 11.1.1.7.0

To upgrade from Oracle HTTP Server WebGate 11.1.1.5.0 or 11.1.1.6.0 to 11.1.1.7.0, complete all of the steps described in this chapter. However, in the "Specify Installation Location" screen (Table 2-1, step 3), specify the same Oracle home in which the Oracle HTTP Server 11g WebGate for OAM version 11.1.1.5.0 or 11.1.1.6.0 was installed.