Blog

Updating the JDK for Oracle Forms and Reports

Keeping your Oracle Forms and Reports environment up to date is critical to maintaining security, performance, and stability. One of the most important parts of this process is updating the Java Development Kit (JDK). Since Oracle Fusion Middleware relies on the JDK, an outdated version can leave your system exposed to vulnerabilities or cause compatibility issues.

In this guide, we’ll walk through:

Why Update the JDK?

A JDK update is more than just a version bump—it directly impacts security, stability, and performance:

– Security: Every version of the JDK can contain vulnerabilities. Updates include fixes that help prevent attacks and data loss.

– Performance: Each update may include optimizations to improve the speed and efficiency of Java applications.

– Stability and bug fixes: Updates resolve bugs that could cause instability or unexpected behavior.

– Feature enhancements: New features and improved tools introduced in newer Java releases are sometimes backported into updates.

– Expiration dates: Certain versions of Java expire after a set date. Once expired, they are no longer supported and must be updated to remain secure.

Before You Begin: Check Compatibility

Not every JDK version is compatible with every Oracle Fusion Middleware version. Always check the Oracle Certification Matrix:

Always verify your Fusion Middleware version first, then choose the correct JDK version.

Step 1: Install the New JDK

1. Install the JDK in a new folder

– Do not install inside system folders such as %SYSTEM% (e.g., C:\Program).

– Example: installing JDK 1.8.0_371.

2. Unzip and install

Unzip jdk-8u371 and copy the folder into your designated Java directory.

Best practice: Always create a new folder for each version so you can roll back if needed. If you overwrite the existing folder (e.g., using a global path like C:\oracle\java\jdk), rollback is not possible.

Step 2: Update JAVA_HOME

Oracle Fusion Middleware stores the JDK path in a variable called JAVA_HOME. This value is centrally located in the globalEnv.properties file inside the ORACLE_HOME/oui directory.

Because the binaries, metadata, and utility scripts (such as RCU or Configuration Wizard) reference the JDK version used during installation, you must manually update the references to the new JDK.

Files to Update

Use grep (UNIX) or findstr(Windows) to search for the old JDK (e.g., jdk1.8.0_121) and replace with the new JDK path. Common files include:

– UNIX: DOMAIN_HOME/bin/setDomainEnv.sh

– Windows: DOMAIN_HOME\bin\setDomainEnv.cmd

– UNIX: DOMAIN_HOME/bin/setNMJavaHome.sh

– Windows: DOMAIN_HOME\bin\setNMJavaHome.cmd

– UNIX: DOMAIN_HOME/nodemanager/nodemanager.properties

– Windows: DOMAIN_HOME\nodemanager\nodemanager.properties

These files are generated by the Configuration Wizard and hard-coded to the JDK used during installation.

Step 3: Modify Configuration Files

– Located in Domain/bin.

– Open with a text editor, search for the old JDK path, and update to the new version.

– Located in the same directory.

– Scripts inside the domain reference this file to locate the active JDK.

– Located inside domain/nodemanager.

– Edit with a text editor and update the JAVA_HOME path to the new folder.

Step 4: Restart the Domain

Once all references are updated:

1. Restart the domain

2. Check the .out log files to confirm the new JDK is being used.

For example, in AdminServer.out you should see output similar to:

<Sep 2, 2025 10:33:40 AM CEST> <INFO> <NodeManager> <Starting WebLogic server with command line: C:\oracle\user_projects\domains\fr3domain\bin\startWebLogic.cmd ><Sep 2, 2025 10:33:40 AM CEST> <FINEST> <NodeManager> <Environment: JAVA_HOME=c:\oracle\Java\jdk1.8.0_371>

3. Finally, test your application server to verify that everything is functioning as expected.

Wrapping Up

Updating the JDK for Oracle Forms and Reports is an essential task to keep your environment secure and supported. While the process requires careful updates across configuration files, the steps are straightforward once you know where to look:

Taking the time to follow this process ensures that your environment benefits from the latest security patches, performance improvements, and stability fixes, while giving you the flexibility to roll back if needed.

Regular updates aren’t just about compliance—they’re about ensuring your Oracle Forms and Reports applications continue running smoothly and securely for years to come.

Ready to take your Oracle Forms to the next level? Or do you have specific questions related to how the updates affect your organization? Contact us for a free Forms modernization, consultation.