7 Upgrading Non-OHS WebGate

This document describes the steps needed to upgrade an existing 12c (12.2.1.4.0) WebGates environment for non-OHS web containers, such as Apache, IHS and IIS to 14c (14.1.2.0.0).

Prerequisites for Upgrading Non-OHS WebGate from 12c (12.2.1.4.0) to 14c (14.1.2.0.0)
  • Verifying Certification and System Requirements

    Review the certification matrix and system requirements documents to verify that your environment meets the necessary requirements. Beofre you begin the upgrade, verify that all prerequisites for OS certifications, Web Server (Apache, IHS or IIS), and VC Runtime version (Windows) are satisfied.

    Whenever new certifications occur, they are added to the appropriate certification document right away. New certifications can occur at any time, and for this reason the certification documents are kept outside of the documentation libraries and are available on Oracle Technical Resources. See the Certification Matrix for 14c (14.1.2.0.0).

    Note:

    When checking the certification, system requirements, and interoperability information, be sure to check specifically for any operating system requirements. It is important for you to download software specifically designed for your operating system environment, explicitly.
  • Verify That the JDK Is Certified for This Release of Oracle Fusion Middleware

    You must have a 64-bit Java runtime environment (JRE) 17 or higher installed.

    Refer to the Oracle Fusion Middleware Supported System Configurations information on the Oracle Technology Network (OTN) to verify that the JDK you are using is supported.

  • Switch to OAP over REST (if needed)

    If WebGate to be upgraded is using OAP over TCP for communicating with OAM Server, switch it to use OAP over REST

  • Create a Complete Backup

    Ensure that your exiting installation of 12.2.1.4.0 WebGate is backed up and copied to a different location.

Installing Webgate for Apache / IHS / IIS
Install the new WebGate for Apache, IHS and IIS 14c (14.1.2.0.0) in the same location as previous 12c WebGate installation. For detailed instructions on how to obtain and install the new versions, see the previous installation chapters in this guide:
Post-Installation Steps for WebGate Upgrade
  • Maintaining Customized Scripts and Configuration Files

    As the new WebGate 14c (14.1.2.0.0) software is installed at the same location as your previous 12c (12.2.1.4.0) WebGate installation, references to WebGate Oracle Home in various configurations (like Web Server configuration files, custom scripts, etc) will remain valid for WebGate instances referring to this installation.

    Exceptions:
    • If the WebGate instance directory for the older 12.2.1.4.0 installation was under the WebGate Oracle Home and was moved during the backup step above, you will have to copy / restore it under new 14c installation at the same location.
    • You may need to update Apache / IHS / IIS startup scripts to include Webgate_Oracle_Home/lib or Webgate_Oracle_Home/bin location in LD_LIBRARY_PATH or PATH
  • Adding Permissons for IIS WebGate

    After IIS WebGate 14c (14.1.2.0.0) is installed in the same location as the 12c (12.2.1.4.0) IIS WebGate, you will need to add new permissions.

    1. . Run the following commands:
      set WebGateHome=<14.1.2-Webgate-OH>
      
      cacls %WebGateHome% /E /T /G IUSR:f
      cacls %WebGateHome% /E /T /G IIS_IUSRS:f
      cacls %WebGateHome% /E /T /G NETWORK:f
      cacls %WebGateHome% /E /T /G "NETWORK SERVICE":f
    2. Copy the webgate.ini file from the 12.2.1.4.0 WebGate installation located in the following directory and copy it to the new 12c (12.2.1.4.0) installation under same location:
      OH\webgate\iis\lib