Part 1: Preparing the Amazon Corretto Binaries

Before updating individual components, download and stage the Amazon Corretto binaries. Using the .zip distribution allows you to swap Java environments seamlessly without running an installer.

1. Create a staging folder on your local drive: C:\ibi\corretto_java
2. Download the Amazon Corretto v11 ZIP version (do not download the .msi version).
• Main Download Page: AWS Corretto
• Version 11 Download List: AWS Documentation
• Direct ZIP Download Link: Amazon Corretto 11 Windows x64 ZIP
3. Extract the contents of the downloaded ZIP file into C:\ibi\corretto_java.
4. Rename the extracted root folder to simply jdk.
• Example: Rename C:\ibi\corretto_java\jdk11.0.31_11 to C:\ibi\corretto_java\jdk
• (Note: The version numbers in the folder name may vary depending on when you download the file).

Part 2: Updating the WebFOCUS Client

The standard WebFOCUS Client installation includes three distributions of Oracle Java that support various background components.

Affected Components

• Apache Tomcat
• Apache Derby
• WebFOCUS Report Caster
• WebFOCUS Search Service

Step-by-Step Migration Procedure

Step 2.1: Stop WebFOCUS Windows Services

To prevent file-lock issues, stop all services associated with WebFOCUS:

• Apache Tomcat
• Apache Derby
• WebFOCUS Report Caster
• WebFOCUS Search Service
• WebFOCUS Reporting Server

Step 2.2: Backup Existing Oracle JDK Folders

Locate and rename the default Oracle Java directories to create a rollback point:

Step 2.3: Deploy Amazon Corretto

Copy your newly prepared jdk directory from your staging folder (C:\ibi\corretto_java\jdk) into the following application directories:

• \ibi\WebFOCUS93\
• \ibi\tomcat\
• \ibi\derby\

Verify that your directory structures now look like this:

• \ibi\WebFOCUS93\jdk
• \ibi\tomcat\jdk
• \ibi\derby\jdk

Step 2.4: Restart and Verify

1. Restart all WebFOCUS Windows services stopped in Step 2.1.
2. Verify that the WebFOCUS environment and its associated tools are running as expected.
3. Cleanup: Once the environment is confirmed stable, you can safely delete the backup folders: jdk_oracle.

Part 3: Updating WebFOCUS Application Studio (App Studio)

Note: Application Studio does not utilize Java during standard runtime operations. However, a valid Java directory is strictly required to execute its uninstaller.

Step-by-Step Migration Procedure

Step 3.1: Backup the Existing JDK Folder

Locate and rename the App Studio Oracle Java directory:

• Rename \ibi\AppStudio93\jdk to \ibi\AppStudio93\jdk_oracle

Step 3.2: Deploy Amazon Corretto

1. Copy the jdk folder from your staging directory (C:\ibi\corretto_java\jdk) into \ibi\AppStudio93\.
2. Confirm the new path exists: \ibi\AppStudio93\jdk

Step 3.3: Cleanup

Because this configuration change does not impact active environment runtimes, you can immediately and safely delete the backup folder: \ibi\AppStudio93\jdk_oracle.

Part 4: Updating Data Science Machine Learning (DSML)

Note: DSML does not utilize Java during standard runtime operations. However, a valid Java directory is strictly required to execute its uninstaller.

Step-by-Step Migration Procedure

Step 4.1: Backup the Existing JDK Folder

Locate and rename the App Studio Oracle Java directory:

• Rename \ibi\dsml\jdk to \ibi\dsml\jdk_oracle

Step 4.2: Deploy Amazon Corretto

1. Copy the jdk folder from your staging directory (C:\ibi\corretto_java\jdk) into \ibi\dsml.
2. Confirm the new path exists: \ibi\dsml\jdk

Step 4.3: Cleanup

Because this configuration change does not impact active environment runtimes, you can immediately and safely delete the backup folder: \ibi\dsml\jdk_oracle.

WIndows

Audience: System Administrators / Operations Teams

Purpose: This document provides step-by-step instructions for reconfiguring the Java environment used by WebFOCUS, Application Studio, and DSML on Windows.

By default, these products distribute Oracle Java. This guide walks you through replacing Oracle Java with Amazon Corretto v11, which has been officially certified by ibi for WebFOCUS releases 9.3.6 and 9.2.6.