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).
-
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.
-
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
orWebgate_Oracle_Home/bin
location inLD_LIBRARY_PATH
orPATH
-
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.
- . 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
- 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
- . Run the following
commands: