Professional Documents
Culture Documents
1
Copyright (c) 2022, Oracle. All rights reserved. Oracle Confidential.
Using Java Web Start with Oracle E-Business Suite (Doc ID 2188898.1)
This knowledge document describes how to use Java Web Start with Oracle E-Business Suite (EBS) Releases 12.2 and 12.1.
The most current version of this document can be obtained in My Oracle Support Knowledge Document 2188898.1.
Note: To receive automatic notifications of updates, subscribe to the Hot Topics Notification feature in My Oracle Support,
as described in Document 793436.2, Subscribing to Hot Topic E-Mails.
In This Document
Java Web Start provides a browser-independent architecture for deploying Java technology-based applications to the client
desktop. With Java Web Start, users can launch a Java application by clicking a link in a web page. The link points to a Java
Network Launch Protocol (JNLP) file, which instructs Java Web Start software to download, cache, and run the application.
This way, users can download and launch applications without going through additional installation procedures.
Java Web Start software is installed as part of the Java Runtime Environment (JRE) software. Users do not have to install Java
Web Start software separately or perform additional tasks to use Java Web Start applications.
The following architectural diagrams illustrate the differences between the Java Plug-in and Java Web Start on the client
(desktop) tier:
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=8b7ihnx2f_4&id=2188898.1 1/31
28/7/22, 14:43 Document 2188898.1
The Oracle E-Business Suite migration to Java Web Start is primarily driven by modern web browsers ending support for the
Netscape Plug-in Application Programming Interface (NPAPI), which is used by the Java Plug-in. At the same time, Oracle
plans to deprecate the Java Plug-in for web browsers starting with the release of Java SE 9. Java Web Start applications can be
launched independently of a browser since they do not rely on a browser plug-in, it provides a migration path from Java
applets.
2.1 How Does Java Web Start Impact the Oracle E-Business Suite Architecture?
Java Web Start is included in the Java Runtime Environment (JRE). The following table lists the minimum JRE release required
on the client tier to use Java Web Start with Oracle E-Business Suite.
Oracle E-Business
Minimum JRE Release
Suite Release
12.2
JRE 8 Update 301 or later (for macOS Big Sur
and earlier clients) 1
JRE 8 Update 181 or later (for multiple Forms
session support) 2
JRE 8 Update 171 or later (for macOS
Catalina and earlier clients) 3
JRE 8 Update 144 b01 Patch 26512977 or
later 4
JRE 8 Update 141 b15 Patch 25951321 5
JRE 8 Update 131 b31 Patch 25767257
JRE 8 Update 121 b33 Patch 25450542
12.1.3
JRE 8 Update 301 or later (for macOS Big Sur
or earlier) 1
JRE 8 Update 181 or later (for multiple Forms
session support) 2
JRE 8 Update 171 or later (for macOS
Catalina and earlier clients) 3
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=8b7ihnx2f_4&id=2188898.1 2/31
28/7/22, 14:43 Document 2188898.1
1 JRE 8 Update 301 is the minimum requirement for macOS clients accessing EBS environments with the patches listed
in 4.7 Required Patches for Supporting Firefox ESR on macOS (Big Sur and Earlier) Using Java Web Start applied.
2 JRE 8 Update 181 is the minimum requirement for multiple Forms session support using Java Web Start. For further
information, see 4.5 Required Patches for Multiple Forms Session Support Using Java Web Start and 6.8 Using Multiple
Forms Sessions with Java Web Start.
3 JRE 8 Update 171 is the minimum requirement for macOS clients accessing EBS environments with only the patches
listed in 4.6 Required Patches for Supporting Firefox ESR on macOS (Catalina and Earlier) Using Java Web Start applied.
4JRE 8 Update 144 b01 includes the fix for a regression issue introduced in JDK 8u141, which under specific conditions
may cause Java Web Start applications to fail to launch. For further information, see the Java 8u144 Release Notes.
5JRE 8 Update 141 b15 is the standard public July 2017 CPU release which is also available for download through the
Oracle Technology Network (OTN) and Java.com public sites.
The above table lists the minimum JRE release to run the Forms application in EBS using Java Web Start. Oracle strongly
recommends that you use the latest JRE 8 Update certified with EBS on the client tier, and stay current with future Java Critical
Patch Updates (CPUs). See My Oracle Support Knowledge Document 2484000.1, Oracle E-Business Suite Release 12.2.3
Readme, Section 1: Identifying Latest CPU For Oracle E-Business Suite for further information.
The same web browsers used in the current architecture will continue to be supported (Microsoft Internet Explorer, Mozilla
Firefox ESR, and Apple Safari). Browsers which formerly did not support the Java Plug-in and only supported HTML/OA
Framework modules (such as Google Chrome and Microsoft Edge) will be able to launch Forms and Java applets in Oracle E-
Business Suite using Java Web Start.
2.2 Are There Any Changes in the User Experience When Migrating to Java Web Start?
In general, Java Web Start provides a similar user experience as the Java Plug-in.
With Java Web Start, Java applications are still launched from the browser, but now all Java applets in Oracle E-Business Suite
will run outside of the web browser. The following screenshot illustrates the new behavior of the Workflow Status Diagram
Java applet. It opens in a new and separate Java window, instead of displaying the Java applet directly within the web browser
using the Java Plug-in.
Only one instance per Java applet can be running on the client PC. Multiple instances of a specific Java applet cannot be
launched, even when launched from different sessions or browsers. The following message will be displayed when opening a
second Java applet instance:
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=8b7ihnx2f_4&id=2188898.1 3/31
28/7/22, 14:43 Document 2188898.1
2.3 Performance Comparison Between Java Web Start and Java Plug-in
Stress tests have been conducted on Oracle E-Business Release 12.2 and 12.1.3 to compare both the new Java Web Start and
current Java Plug-in launch method for the Forms application. The results of both tests were comparable on all key
performance indicators:
Client (desktop) tier: The time taken to open the Forms application in Oracle E-Business Suite with Java Web Start is
comparable to that seen with the Java Plug-in. There is no significant variation observed in CPU utilization and memory
consumption.
Application tier: There is no significant variation observed in CPU utilization and memory consumption for the oacore
and forms services.
Database tier: A slight increase in the number of database connections is seen with Java Web Start on Oracle E-
Business Suite Release 12.1.3. This is due to architectural changes where the Forms server also creates its own JDBC
connection pool. There was no such difference observed with Java Web Start on Oracle E-Business Suite Release 12.2.
The CPU utilization and memory consumption remained the same on this tier.
For macOS platform, Firefox ESR is supported using Java Web Start. It is required to apply the latest patches as listed in
Section 4: Applying Required Patches to use Firefox ESR on macOS for launching the Forms application and other Java applets
using Java Web Start.
4.5 Required Patches for Multiple Forms Session Support Using Java Web Start
Using Java Web Start
4.6 Required Patches for Supporting Firefox ESR on macOS (Catalina and Earlier)
4.7 Required Patches for Supporting Firefox ESR on macOS (Big Sur and Earlier) Using Java Web Start
4.8 Required Patches for Compatibility with JRE 8 Update 291 and Later
Using Java Web Start with Oracle E-Business Suite previously required enhancements to Java Runtime Environment (JRE).
These were included in commercial JRE Bundled Patch Releases (BPR) namely, JRE 8 Update 131-b31 and JRE 8 Update 121-
b33.
These enhancements are now included in the public release of the July 2017 CPU, JRE 8 Update 141-b15. JWS users are
recommended to upgrade to this latest and therefore most secure version of JRE which can be obtained from the following
locations:
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=8b7ihnx2f_4&id=2188898.1 4/31
28/7/22, 14:43 Document 2188898.1
Alternatively, it is also available from My Oracle Support by downloading Patch 25951321 - Oracle JRE 8 Update 141.
Certain Java Web Start related features such as multiple Forms sessions require a more recent JRE on the client. For further
information, see 2.1 How Does Java Web Start Impact the Oracle E-Business Suite Architecture?
This section provides an overview of all patches required to install and configure Java Web Start on Oracle E-Business Suite
Release 12.2:
Instructions for applying these patches follow in 4.4.1 Applying Patches to Oracle E-Business Suite Release 12.2.
Oracle Forms 10g Technology Patch for Oracle E-Business Suite Release 12.2
4.2.3 Application Technology Patches for Oracle E-Business Suite Release 12.2
The following lists the minimum codelevels required to install Java Web Start on Oracle E-Business Suite Release 12.2.
For further information, see the following My Oracle Support Knowledge documents:
4.2.2 Oracle Forms 10g Technology Patch for Oracle E-Business Suite Release 12.2
Patch 25441839 - Merge Request On Top Of 10.1.2.3.2PSU For Bugs 24946444, 24620875, 25355211 is the minimum required
Oracle Forms 10g overlay patch that adds support for Java Web Start to Oracle Forms as part of the Oracle E-Business Suite
technology stack.
It is a cumulative Forms overlay patch on top of Oracle Forms 10.1.2.3.2. As these patches are cumulative, future Forms
overlay patches will directly include Patch 25441839. For the most recent Forms overlay patch, see "Section 4.1: Forms and
Reports 10.1.2.3 Patches and Bug Numbers" in Document 1594274.1, Oracle E-Business Suite Release 12.2: Consolidated List
of Patches and Technology Bug Fixes.
For further information, see My Oracle Support Knowledge Document 805965.1, Applying OracleAS 10g Forms and Reports
Patches to Oracle E-Business Suite Release 12.
4.2.3 Application Technology Patches for Oracle E-Business Suite Release 12.2
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=8b7ihnx2f_4&id=2188898.1 5/31
28/7/22, 14:43 Document 2188898.1
AD: Add Java Web Start support to Oracle E-Business Suite Patch 24498616:R12.AD.C
TXK: Add Java Web Start support to Oracle E-Business Suite Patch 25449925:R12.TXK.C
Oracle E-Business Suite Java Applets launching with Java Web Start Patch 25380324:R12.FND.C
The following product-specific patches are required for the following Oracle E-Business Suite Release 12.2 products which use
Java applets:
This section provides an overview of all patches required to install and configure Java Web Start on Oracle E-Business Suite
Release 12.1.
Instructions for applying these patches follow in 4.4.2 Applying Patches to Oracle E-Business Suite Release 12.1.
Oracle Forms 10g Technology Patch for Oracle E-Business Suite Release 12.1
4.3.3 Application Technology Patches for Oracle E-Business Suite Release 12.1
The following lists the minimum codelevels required to install Java Web Start on Oracle E-Business Suite Release 12.1.
For further information, see the following My Oracle Support Knowledge documents:
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=8b7ihnx2f_4&id=2188898.1 6/31
28/7/22, 14:43 Document 2188898.1
4.3.2 Oracle Forms 10g Technology Patch for Oracle E-Business Suite Release 12.1
Patch 25441839 - Merge Request On Top Of 10.1.2.3.2PSU For Bugs 24946444, 24620875, 25355211 is the minimum required
Oracle Forms 10g overlay patch that adds support for Java Web Start to Oracle Forms as part of the Oracle E-Business Suite
technology stack.
It is a cumulative Forms overlay patch on top of Oracle Forms 10.1.2.3.2. As these patches are cumulative, future Forms
overlay patches will directly include Patch 25441839. For the most recent Forms overlay patch, see "Step 2.1.2: Download
Additional Patches Required" in Document 437878.1, Upgrading OracleAS 10g Forms and Reports in Oracle E-Business Suite
Release 12.
For further information, see My Oracle Support Knowledge Document 805965.1, Applying OracleAS 10g Forms and Reports
Patches to Oracle E-Business Suite Release 12.
4.3.3 Application Technology Patches for Oracle E-Business Suite Release 12.1
AD: Add Java Web Start support to Oracle E-Business Suite Patch 24498616:R12.AD.B
TXK: Add Java Web Start support to Oracle E-Business Suite Patch 24319156:R12.TXK.B
Oracle E-Business Suite Java Applets launching with Java Web Start Patch 25380324:R12.FND.B
The following product-specific patches are required for the following Oracle E-Business Suite Release 12.1 products which use
Java applets:
This section describes the required steps for applying Java Web Start-related patches to Oracle E-Business Suite Release 12.2
or 12.1.
Java Web Start is not enabled by default after applying the patches, therefore after completing these steps, proceed with
Section 5: Configuring and Enabling Java Web Start.
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=8b7ihnx2f_4&id=2188898.1 7/31
28/7/22, 14:43 Document 2188898.1
Follow the instructions below to apply the required Oracle Forms 10g and application technology patches to Oracle E-Business
Suite Release 12.2 in preparation for Java Web Start.
$ adop phase=prepare
Use OPatch to apply the latest Oracle Forms 10g technology overlay patch against the OracleAS 10.1.2 ORACLE_HOME
as explained in 4.2.2 Oracle Forms 10g Technology Patch for Oracle E-Business Suite Release 12.2.
4. Apply the required Oracle E-Business Suite application technology patches (AD/TXK/FND) as previously listed in 4.2.3
Application Technology Patches for Oracle E-Business Suite Release 12.2.
5. Apply product-specific patches as needed, as previously listed in 4.2.4 Product-Specific Patches for Oracle E-Business
Suite Release 12.2 using adop for those products that are in use. These product-specific patches add support for Java
Web Start for non-Forms Java applets in Oracle E-Business Suite.
6. Use the AD Administration tool (adadmin) to regenerate JAR files with force option.
$ adop phase=finalize,cutover
run
$ source <EBS_ROOT>/EBSapps.env
$ adop phase=cleanup
9. Synchronize the patch file system with the new run file system.
$ adop phase=fs_clone
This step ensures that the Oracle Forms 10g overlay Patch 25441839 is propagated to the new patch file system.
Follow the instructions below to apply the required Oracle Forms 10g and application technology patches to Oracle E-Business
Suite Release 12.1 in preparation for Java Web Start.
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=8b7ihnx2f_4&id=2188898.1 8/31
28/7/22, 14:43 Document 2188898.1
$ source <APPL_TOP>/APPS<CONTEXT_NAME>.env
Use OPatch to apply the latest Oracle Forms 10g technology overlay patch against the OracleAS 10.1.2 ORACLE_HOME.
See 4.3.2 Oracle Forms 10g Technology Patch for Oracle E-Business Suite Release 12.1 for the recommended patch.
$ source <APPL_TOP>/APPS<CONTEXT_NAME>.env
5. Apply the required Oracle E-Business Suite application technology patches (AD/TXK/FND) as listed in 4.3.3 Application
Technology Patches for Oracle E-Business Suite Release 12.1 using adpatch.
6. (Conditional) Apply product-specific patches as needed, as previously listed in
4.3.4 Product-Specific Patches for Oracle
E-Business Suite Release 12.1 using adpatch for those products that are in use. These product-specific patches add
support for Java Web Start for non-Forms Java applets in Oracle E-Business Suite.
the AD Administration tool (adadmin) to regenerate JAR files with force option.
7. Use
$ adadmin
The installation of the patches does not enable Java Web Start. The Java Plug-in remains the default launch method for all
application users. Proceed with the instructions described in Section 5: Configuring and Enabling Java Web Start after having
applied the required patches.
4.5 Required Patches for Multiple Forms Session Support Using Java Web Start
Multiple Forms sessions are supported using Java Web Start on Windows and macOS. This section provides a summary of the
required patches and patch application instructions. For further information about multiple Forms session support, see 6.8
Using Multiple Forms Sessions with Java Web Start.
All required patches listed in 4.2 Required Patches for Oracle E-Business Suite Release 12.2 or 4.3 Required Patches for Oracle
E-Business Suite Release 12.1 must be applied before proceeding with the installation of the following patches.
The following table lists the required application technology patches for Oracle E-Business Suite Release 12.2:
Oracle E-Business Suite Java Applets Launching with Java Patch 29058008:R12.FND.C
Web Start Release 2
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=8b7ihnx2f_4&id=2188898.1 9/31
28/7/22, 14:43 Document 2188898.1
The following table lists the required application technology patches for Oracle E-Business Suite Release 12.1:
TXK: Consolidated Patch for Java Web Start Release 2 Patch 29124450:R12.TXK.B
Oracle E-Business Suite Java Applets Launching with Java Web Start Release 2 Patch 29058008:R12.FND.B
JWS: New Preference To Indicate Launch of New Forms Session Patch 29052441:R12.FWK.B
These patches add multiple Forms session support using Java Web Start to Oracle E-Business Suite. See 4.4 Patch Application
Instructions for detailed steps on how to apply patches to Oracle E-Business Suite.
4.6 Required Patches for Supporting Firefox ESR on macOS (Catalina and Earlier) Using Java Web Start
Note: This section describes the minimum required patches to run Java content using Java Web Start with Firefox ESR on
macOS Catalina and earlier. It is recommended to apply the patches listed in 4.7 Required Patches for Supporting
Firefox ESR on macOS (Big Sur and Earlier) Using Java Web Start. Those patches add support for running Java content in
Oracle E-Business Suite Releases 12.2 and 12.1 using Java Web Start with Firefox ESR on all supported macOS releases
(Big Sur, Catalina, ...).
Firefox ESR on macOS is supported with Oracle E-Business Suite using Java Web Start. This section provides a summary of the
required patches and patch application instructions.
Before proceeding with the installation of the following patches, you must apply all required patches listed in 4.2 Required
Patches for Oracle E-Business Suite Release 12.2 or 4.3 Required Patches for Oracle E-Business Suite Release 12.1.
The following table lists the required application technology patches for Oracle E-Business Suite Release 12.2:
Oracle E-Business Suite Java Applets launching with Java Web Start plus macOS Support using Patch
Firefox 28156520:R12.FND.C
The following table lists the required application technology patches for Oracle E-Business Suite Release 12.1:
Oracle E-Business Suite Java Applets launching with Java Web Start plus macOS Support using Patch
Firefox 28156520:R12.FND.B
These additional patches add support for Firefox ESR on macOS using Java Web Start. See 4.4 Patch Application Instructions
for detailed steps on how to apply patches to Oracle E-Business Suite.
4.7 Required Patches for Supporting Firefox ESR on macOS (Big Sur and Earlier) Using Java Web Start
4.7.1 Overview
4.7.2 Required
Patches for Oracle E-Business Suite Release 12.2
4.7.3 Required Patches for Oracle E-Business Suite Release 12.1
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=8b7ihnx2f_4&id=2188898.1 10/31
28/7/22, 14:43 Document 2188898.1
4.7.1 Overview
Firefox ESR on macOS is supported with Oracle E-Business Suite Releases 12.2 and 12.1 using Java Web Start. This section
lists the required patches for running the Forms application and other Java applets with Firefox ESR on all supported macOS
releases (Big Sur, Catalina, Mojave and High Sierra). For further information, see My Oracle Support Knowledge Document
1533334.1, Oracle E-Business Suite Release Notes for Apple macOS Clients, Release 12 and Document 389422.1,
Recommended Browsers for Oracle E-Business Suite.
Note: The following patches include the compatibility bugfix to use JRE 8 Update 291 and later with Oracle E-Business
Suite as described in 4.8 Required Patches for Compatibility with JRE 8 Update 291 and Later.
All required patches listed in 4.2 Required Patches for Oracle E-Business Suite Release 12.2 must be applied before proceeding
with the installation of the following patches.
Oracle Solaris on SPARC, IBM AIX on Power Systems, Linux x86-64 1, HP-UX Itanium Patch 32922089
1 If you are a Linux x86-64 customer, you must download the Linux x86 patch.
2 If you are a Microsoft Windows x64 customer, you must download the Microsoft Windows (32-bit) patch.
For further information, see My Oracle Support Knowledge Document 805965.1, Applying OracleAS 10g Forms and
Reports Patches to Oracle E-Business Suite Release 12.
The following table lists the required application technology patches for Oracle E-Business Suite Release 12.2:
Oracle E-Business Suite Java Applets launching with JWS for macOS Big Sur (and later) Patch
using Firefox ESR 32645734:R12.FND.C
Instructions for applying these patches follow in 4.4.1 Applying Patches to Oracle E-Business Suite Release 12.2.
All required patches listed in 4.3 Required Patches for Oracle E-Business Suite Release 12.1 must be applied before proceeding
with the installation of the following patches.
Patch
Platform
Number
Oracle Solaris on SPARC, IBM AIX on Power Systems, Linux x86-64 1, HP-UX Itanium, HP-UX PA- Patch 32922089
RISC
1 If you are a Linux x86-64 customer, you must download the Linux x86 patch.
2 If you are a Microsoft Windows x64 customer, you must download the Microsoft Windows (32-bit) patch.
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=8b7ihnx2f_4&id=2188898.1 11/31
28/7/22, 14:43 Document 2188898.1
For further information, see My Oracle Support Knowledge Document 805965.1, Applying OracleAS 10g Forms and
Reports Patches to Oracle E-Business Suite Release 12.
The following table lists the required application technology patches for Oracle E-Business Suite Release 12.1:
Oracle E-Business Suite Java Applets launching with JWS for macOS Big Sur (and later) Patch
using Firefox ESR 32645734:R12.FND.B
Instructions for applying these patches follow in 4.4.2 Applying Patches to Oracle E-Business Suite Release 12.1.
4.8 Required Patches for Compatibility with JRE 8 Update 291 and Later
4.8.1 Overview
4.8.2 Required
Patches for Oracle E-Business Suite Release 12.2
4.8.3 Required Patches for Oracle E-Business Suite Release 12.1
4.8.1 Overview
This section provides a summary of the required compatibility patches to use JRE 8 Update 291 and later with Oracle E-
Business Suite when using Java Web Start to run Java content on the client. These patches resolve the known issue described
as 7.20 Unable to Open URLs From the Forms Application or Java Applets When Using JRE 8 Update 291 or Later.
All required patches listed in 4.2 Required Patches for Oracle E-Business Suite Release 12.2 must be applied before proceeding
with the installation of the following patches.
Oracle Solaris on SPARC, IBM AIX on Power Systems, Linux x86-64 1, HP-UX Itanium Patch 32922089
1 If you are a Linux x86-64 customer, you must download the Linux x86 patch.
2 If you are a Microsoft Windows x64 customer, you must download the Microsoft Windows (32-bit) patch.
For further information, see My Oracle Support Knowledge Document 805965.1, Applying OracleAS 10g Forms and
Reports Patches to Oracle E-Business Suite Release 12.
Apply Applications Technology Patch 32902510:R12.FND.C JWS and JRE (8u291 and later) Compatibility Patch.
Instructions for applying these patches follow in 4.4.1 Applying Patches to Oracle E-Business Suite Release 12.2.
All required patches listed in 4.3 Required Patches for Oracle E-Business Suite Release 12.1 must be applied before proceeding
with the installation of the following patches.
Patch
Platform
Number
Oracle Solaris on SPARC, IBM AIX on Power Systems, Linux x86-64 1, HP-UX Itanium, HP-UX PA- Patch 32922089
RISC
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=8b7ihnx2f_4&id=2188898.1 12/31
28/7/22, 14:43 Document 2188898.1
1 If you are a Linux x86-64 customer, you must download the Linux x86 patch.
2 If you are a Microsoft Windows x64 customer, you must download the Microsoft Windows (32-bit) patch.
For further information, see My Oracle Support Knowledge Document 805965.1, Applying OracleAS 10g Forms and
Reports Patches to Oracle E-Business Suite Release 12.
Apply Applications Technology Patch 32902510:R12.FND.B JWS and JRE (8u291 and later) Compatibility Patch.
Instructions for applying these patches follow in 4.4.2 Applying Patches to Oracle E-Business Suite Release 12.1.
5.1 Overview
The technology and product-specific patches referenced in the previous section add a new method for launching the Forms
application and non-Forms Java applets in Oracle E-Business Suite.
Java Plug-in: The Java Plug-in runs within the web browser memory space. Browsers need to support the NPAPI
protocol to run Java applets using the Java Plug-in. It remains the default configuration after applying the Java Web
Start patches.
Java Web Start: Java applets launch as Java Web Start applications and these run in their own restricted environment,
known as a sandbox. It is launched from a web browser, but once it runs, it does not have any dependency on the web
browser.
The preferred launch method is configured by a combination of a new context file variable and two profile options.
Possible values:
s_forms_launch_method browser
Profile Options
Possible values:
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=8b7ihnx2f_4&id=2188898.1 13/31
28/7/22, 14:43 Document 2188898.1
<s_webentryurlprotocol>://
The URL for launching the Forms application. <s_webentrydomain>:
<s_active_webport>/forms/f
Possible values:
The profile options 'Enable Java Web Start' and 'ICX: Forms Launcher' are automatically set by AutoConfig at the site level and
should only be set at the user level when it is required to override the default configuration.
The previously described environment settings provide full control of how the Forms application and regular Java applets in
Oracle E-Business Suite are launched. The environment can use either Java Web Start or the Java Plug-in for the whole
environment, or a combination of both when configured accordingly at the user level.
Option 1: Set Java Web Start as the default for all application users
Option 2: Set Java Plug-in as the default and Java Web Start for specific application users
Option 3: Set Java Web Start as the default and Java Plug-in for specific application users
Option 1: Set Java Web Start as the default for all application users
Follow these instructions to enable Java Web Start in Oracle E-Business Suite:
$ sh <ADMIN_SCRIPTS_HOME>/adstpall.sh
$ sh <ADMIN_SCRIPTS_HOME>/adautocfg.sh
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=8b7ihnx2f_4&id=2188898.1 14/31
28/7/22, 14:43 Document 2188898.1
$ sh <ADMIN_SCRIPTS_HOME>/adstrtal.sh
Completing these steps sets Java Web Start as the default launch method for the environment. In step 3, AutoConfig updates
the two profile options at the site level accordingly:
Note: Do not modify these profile option values at the site level as those changes will always be updated by AutoConfig.
The configuration steps described above can also be performed to revert back to the Java Plug-in as the default for all
application users. In that case, specify browser for s_forms_launch_method in step 1.
It remains possible to use the Java Plug-in for some application users. See Option 3: Java Web Start as the default launch
method for all applications and Java Plug-in for specific users for the configuration steps.
Option 2: Set Java Plug-in as the default and Java Web Start for specific application users
This option enables Java Web Start only for a specific set of application users. This applies to an environment that has the Java
Plug-in set as the default launch method for all application users, as per the following environment configuration:
Context variable s_forms_launch_method is set to browser meaning that by default all application users use the Java
Plug-in.
Profile option values at the site level as a result of s_forms_launch_method being set to browser:
Enable Java Web Start is set to No
ICX: Forms Launcher set to <s_webentryurlprotocol>://<s_webentryhost>.<s_webentrydomain>:
<s_active_webport>/forms/frmservlet
To enable Java Web Start for one or more application users, set the following two profile options at the user level:
Note: The 'ICX: Forms Launcher' profile option gets ?config=jws appended at the user level as application users require
a launch method that is different from the site level configuration.
Option 3: Set Java Web Start as the default and Java Plug-in for specific application users
This option enables Java Plug-in only for a specific set of application users. This applies to an environment that has Java Web
Start set a default launch method for all application users, as per the following environment configuration:
Context variable s_forms_launch_method is set to jws, meaning that by default all application users use Java Web
Start.
Profile option values at the site level as a result of s_forms_launch_method being set to jws:
'Enable Java Web Start' is set to Yes
'ICX: Forms Launcher' set to <s_webentryurlprotocol>://<s_webentryhost>.<s_webentrydomain>:
<s_active_webport>/forms/frmservlet
To enable the Java Plug-in for one or more application users, set the following two profile options at the user level:
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=8b7ihnx2f_4&id=2188898.1 15/31
28/7/22, 14:43 Document 2188898.1
Note: The 'ICX: Forms Launcher' profile option gets ?config=browserMode appended at the user level as application
users require a launch method that is different from the site level configuration.
Forms Sessions with Java Web Start
6.8 Using Multiple
A few product-specific Java applets run directly within the web browser when using the Java Plug-in. The functional flows
involving those Java applets have been improved to support Java Web Start. As a result, these Java applets appear as a
separate Java window instead of being displayed directly within the web browser when running them with Java Web Start.
Internet Explorer supports both Java Web Start and the Java Plug-in for launching the Forms application and regular Java
applets as part of Oracle E-Business Suite.
Default behavior
Launching Java content with Java Web Start should provide a comparable user experience to that seen with the Java Plug-in.
The frmservlet.jnlp is downloaded to the web browser's cache directory and automatically removed from that location by
the Java Web Start Launcher.
Firefox ESR 68.x and Firefox ESR 78.1 and later supports Java Web Start for running the Forms application and regular Java
applets as part of Oracle E-Business Suite. Firefox ESR is supported on both Windows and macOS platforms.
Default behavior
By default, Firefox ESR requires the user to choose the appropriate action on what to do with the JNLP file that is downloaded
when launching, for example, the Forms application using Java Web Start.
1. Open Firefox.
2. Log in to Oracle E-Business Suite.
3. Choose a responsibility (for example, System Administrator).
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=8b7ihnx2f_4&id=2188898.1 16/31
28/7/22, 14:43 Document 2188898.1
4. Click on an Oracle Forms-based menu item (such as Security → User → Define) to initiate the download of the
frmservlet.jnlp file.
5. Firefox displays the following message: "What should Firefox do with this file?", as shown in the following image:
6. Choose the first option "Open with" and in the corresponding drop-down list, select 'Java(TM) Web Start Launcher
(default)."
7. Select the check box "Do this automatically for files like this from now on" in order to associate the JNLP file extension
with the Java Web Start Launcher executable on the client PC.
8. Click OK.
You only need to do this once: future instances of the Forms application or a Java applet will then always launch using Java
Web Start, providing a comparable user experience to that seen with the Java Plug-in.
Each new frmservlet.jnlp (Windows) or frmservlet-n (macOS) file is saved into the default download location as defined
in Firefox. The Java Web Start Launcher will automatically remove this file from that location.
Note (Windows only): If you had inadvertently chosen "Save As" and saved the JNLP file to the desktop, you will need to
manually launch it from the desktop.
The JNLP file association can also be manually configured by complete the following steps in Firefox:
1. Click Menu.
2. Click the Options icon.
3. Select the Applications tab.
4. Search for Content type "JNLP File."
5. In the Action drop-down list, select "Use Java(TM) Web Start Launcher (default)."
This section describes the behavior of Firefox ESR 78.x and earlier on macOS when launching an Oracle Forms application or
Java applet in an EBS environment that has the patches listed in 4.7 Required Patches for Supporting Firefox ESR on macOS
(Big Sur and Earlier) Using Java Web Start applied.
Oracle E-Business Suite uses the Java Web Start protocol handler on macOS clients to launch an Oracle Forms application or
Java applet. The Java Web Start protocol handler handles the custom URI schemes jnlp: and jnlps:. It runs the Java Web
Start launcher which downloads the frmservlet.jnlp, and then starts the Java Web Start application, for example, the Forms
application.
Note: If your Oracle E-Business Suite environment only has the patches listed in 4.6 Required Patches for Supporting
Firefox ESR on macOS (Catalina and Earlier) Using Java Web Start applied, then Firefox ESR behaves in the same way on
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=8b7ihnx2f_4&id=2188898.1 17/31
28/7/22, 14:43 Document 2188898.1
macOS and Windows. For further information about the default browser behavior of Firefox ESR, see "Default Behavior" in
6.3.1 Firefox ESR for Windows Users.
Default behavior
By default, Firefox ESR 78.x and earlier on macOS requires the user to choose the appropriate action on what to do when the
user launches the Forms application using Java Web Start.
1. Open Firefox.
2. Log in to Oracle E-Business Suite.
3. Choose a responsibility (for example, System Administrator).
4. Click on an Oracle Forms-based menu item (such as Security → User → Define).
5. A new browser tab opens, showing a page with the message "Launching Oracle forms-based application."
6. Firefox displays a Launch Application dialog window, as shown in the following image:
You only need to do this once: future instances of the Forms application or a Java applet will then always launch using Java
Web Start, providing a comparable user experience to that seen with the Java Plug-in.
The new browser tab in step 5 will close automatically after a short period, or you can close the tab manually at any time.
Google Chrome has not supported the Java Plug-in since release 45. Therefore, the Forms application and regular Java applets
as part of the Oracle E-Business Suite can only run with Java Web Start.
Google Chrome version 84 and later supports automatic opening of the Forms application and regular Java applets as part of
Oracle E-Business Suite offering the best user experience for the end users. This requires the configuration of two Chrome
policies.
AutoOpenFileTypes 1 List of file types that should be automatically opened on download. jnlp
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=8b7ihnx2f_4&id=2188898.1 18/31
28/7/22, 14:43 Document 2188898.1
1 Chrome policy AutoOpenFileTypes requires Windows clients to be joined to a Microsoft Active Directory domain,
running on Windows 10 Pro, or enrolled in Chrome Browser Cloud Management.
2It is recommended to match the exact hostname of the Oracle E-Business Suite web entry point. This is done by
adding a leading period. For example a value of .exacthost.example.com will match only the hostname
exacthost.example.com.
Chrome policies are centrally managed by system administrators as Group Policy Object (GPO) using Microsoft Active Directory
or Microsoft Intune. Deployment instructions supported by administrative templates (.admx) for Google Chrome are described
on the following Google Chrome Enterprise Help pages:
Chrome Browser on Windows (managed on premise), Chrome Browser Deployment Guide (Windows), section Policies
and Templates
Cloud-managed Chrome Browser, Manage Chrome Browser with Microsoft Intune
To properly configure these Chrome policies, please consult your system administrator. To confirm whether the Chrome policies
are correctly configured on the client, perform the following steps:
The following describes a common use case of launching the Forms application with Java Web Start using Google Chrome. The
same concept applies to regular Java applets.
Note: This warning message is expected due to restrictions enforced by Google Chrome.
A new frmservlet.jnlp file is downloaded each time the Forms application or a regular Java applet is launched. The file is
saved in the default download location as defined in Google Chrome. Upon launching frmservlet.jnlp, the Java Web Start
launcher will automatically remove this file.
Behavior when having a specific location for each download preference set
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=8b7ihnx2f_4&id=2188898.1 19/31
28/7/22, 14:43 Document 2188898.1
Google Chrome has the option to present a Save As dialog window for every file downloaded. This feature is described on the
Chrome Help page Download a file on Chrome. More specifically, the section "Change download locations" covers the "Ask
where to save each file before downloading" user preference.
The following describes a common use case of launching the Forms application with Java Web Start using Google Chrome
when the "Ask where to save each file before downloading" preference is enabled.
The Forms application and regular Java applets as part of Oracle E-Business Suite can run only with Java Web Start when
using the Microsoft Edge web browser. It has never supported NPAPI-based extensions such as the Java Plug-in.
Default behavior
The following describes a common use case of launching the Forms application with Java Web Start using Edge. The same
concept applies to regular Java applets.
The Java Web Start launcher automatically removes the downloaded frmservlet.jnlp file from the browser's download
folder.
The extra blank browser tab in step 5 remains open even after opening the Forms application. This is the expected behavior as
a result of web browser limitations. It is safe to close this browser tab that opened when downloading the frmservlet.jnlp
file.
Microsoft Edge (Chromium) version 83 and later requires the usage of Java Web Start to launch Oracle Forms based modules
and other Java applets that are part of Oracle E-Business Suite.
Microsoft Edge (Chromium) version 85 and later supports automatic opening of the Forms application and regular Java applets
as part of Oracle E-Business Suite offering the best user experience for the end users. This requires the configuration of two
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=8b7ihnx2f_4&id=2188898.1 20/31
28/7/22, 14:43 Document 2188898.1
AutoOpenFileTypes 1 List of file types that should be automatically opened on download. jnlp
1 Microsoft Edge policy AutoOpenFileTypes requires Windows clients to be joined to a Microsoft Active Directory domain,
running on Windows 10 Pro, or associated with Enterprise instances that are enrolled for device management.
2It is recommended to match the exact hostname of the Oracle E-Business Suite web entry point. This is done by
adding a leading period. For example a value of .exacthost.example.com will match only the hostname
exacthost.example.com.
Microsoft Edge policies are centrally managed by system administrators as Group Policy Object (GPO) using Microsoft Active
Directory or Microsoft Intune. Deployment instructions supported by administrative templates (.admx) for Microsoft Edge
(Chromium) are described on the following Microsoft Edge Enterprise pages:
To properly configure these Microsoft Edge policies, please consult your system administrator. To confirm whether the
Microsoft Edge policies are correctly configured on the client, perform the following steps:
The following describes a common use case of launching the Forms application with Java Web Start using Microsoft Edge
(Chromium). The same concept applies to regular Java applets.
Note: This warning message is expected due to restrictions enforced by Microsoft Edge (Chromium).
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=8b7ihnx2f_4&id=2188898.1 21/31
28/7/22, 14:43 Document 2188898.1
A new frmservlet.jnlp file is downloaded each time the Forms application or a regular Java applet is launched. The file is
saved in the default download location as defined in Microsoft Edge. Upon launching frmservlet.jnlp, the Java Web Start
launcher will automatically remove this file.
When using the Safari web browser on macOS, Oracle E-Business Suite always uses the Java Plug-in instead of Java Web Start
for launching the Forms application and Java applets. It automatically falls back to the Java Plug-in, even if the environment
(at the site level) is configured for Java Web Start.
6.8.1 Overview
6.8.2 Switching
Between Single or Multiple Forms Sessions
6.8.3 Comparison Between Java Web Start and Java Plug-in
Implementation
Oracle E-Business Suite Environments
6.8.4 Key Aspects of Multiple Forms Sessions Support When Accessing Multiple
Concurrently
6.8.1 Overview
Certain use cases benefit from running multiple Forms sessions of the same Oracle E-Business Suite environment concurrently
on the client. This functionality is available when using the Java Plug-in and Internet Explorer as described in Document
389422.1, Recommended Browsers for Oracle E-Business Suite, section 'Multiple EBS Java Sessions'.
Multiple Forms sessions using Java Web Start is supported with all supported web browsers on Windows, and Firefox on
macOS. It is required to apply the application technology patches as listed in 4.5 Required Patches for Multiple Forms Session
Support Using Java Web Start. The minimum JRE requirement on the client is described in 2.1 How Does Java Web Start
Impact the Oracle E-Business Suite Architecture? . Similar to the Java Plug-in, a user can run multiple Forms sessions of the
same Oracle E-Business Suite environment concurrently on the client using Java Web Start.
It is supported to run one or more Forms sessions of different Oracle E-Business Suite environments (for example, a
development and production environment) at the same time on the client tier using Java Web Start. This does not require
using different web browsers for each Oracle E-Business Suite environment.
A new user preference on the General Preferences page controls the behavior of launching the Forms application when using
Java Web Start.
Unchecked (default): Only single instance of the Forms application will run on the client. If it is already running, the
existing instance will be reused.
Checked: A new instance of the Forms application is created for every invocation of a Forms based form function (URL)
from an OAF/JSP/... page in the web browser.
The user preference is enabled only when the user is set up to use Java Web Start as described in Section 5: Enabling Java
Web Start. Otherwise, the user preference will be grayed out as the user is using the Java Plug-in to launch the Forms
application.
The following steps describe by example how to set the user preference to use multiple Forms sessions:
4. Choose Preferences.
5. Check the check box for "Always Launch New Forms Session".
6. Go back to the home page.
7. In the Navigator panel, click on Alert Manager, Vision Enterprises to expand.
8. Click on Distribution List.
→ The first Forms session is launched.
9. Go back to the browser.
10. In the navigator under Alert Manager, Vision Enterprises click on History.
→ A second Forms session is launched.
11. ...
New Forms sessions will continue to be opened when invoked from the web browser.
To switch back to a single Forms session, change the user preference back to unchecked. Note that existing Forms sessions
running on the client will remain as-is.
6.8.3 Comparison Between Java Web Start and Java Plug-in Implementation
The following table lists the key differences of run multiple Forms sessions on a client using Java Web Start or the Java Plug-in.
This new implementation of running multiple Forms instances concurrently on the client using Java Web Start does not rely on
of any browser-specific functionality. A user can continuously create new Forms instances with each activity within self service
/ the web browser that is linked to a Forms based functionality. Therefore, there is a one-to-many relationship between an
Oracle E-Business Suite browser session and the Forms sessions.
In comparison to the Java Plug-in approach using Internet Explorer, you create multiple Oracle E-Business Suite sessions by
launching each application session through a new browser session. These browser sessions are fully independent from one
another. For each one, a single Forms instance can be launched. In other words, there's always a one-to-one relationship
between an Oracle E-Business Suite browser session and a Forms session. The same behavior when using the Java Plug-in
cannot be achieved using Java Web Start.
6.8.4 Key Aspects of Multiple Forms Sessions Support When Accessing Multiple Oracle E-Business Suite
Environments Concurrently
This section summarizes some important aspects of multiple Forms sessions support when accessing multiple Oracle E-
Business Suite environments.
Forms application: There are no restrictions when connecting to two or more different Oracle E-Business Suite
environments (for example, PROD and DEV). Multiple Forms instances of each Oracle E-Business Suite environment can
run concurrently on the client using Java Web Start.
Product-specific Java applets (such as Help Builder, Workflow Status diagram, ...): Only one (1) instance of a product-
specific Java applet per Oracle E-Business Suite environment can run concurrent on the client using Java Web Start. For
example, when being connected to both a production and development environment, then for each of them a single
instance of the Help Builder can be running on the client.
Attempting to launch a Java applet which is already running will show the following message: "This Applet is already running.
Please close the Applet and try again."
This applies to the product specific Java applets (for example, Help Builder, Workflow Status diagram, ...) as part of Oracle E-
Business Suite, and does not apply to the Forms application. Using Java Web Start, only a single instance of each of these Java
applets can run on the client for a given Oracle E-Business Suite environment. For example, one or more instance of the Forms
application (with multiple Forms session support), one instance of the Help Builder, and one instance of the Workflow Status
diagram can run in parallel. Each of these product specific Java applets are launched from the same web browser, and thus
share the same application session.
In case of accessing different Oracle E-Business Suite environments using Java Web Start at the same time (either from the
same or different web browsers), only a single instance of each product specific Java applets per environment can run on the
client.
Internet Explorer users can run multiple Oracle E-Business Suite sessions by adding the -noframemerging parameter to the
browser launch command (iexplorer.exe) when using the Java Plug-in. Using this parameter with Java Web Start may bring
up the login form again requiring the user to log in again, when switching between the Forms application and any of the other
Java applets of Oracle E-Business Suite. It is advised to remove the -noframemerging parameter from the Internet Explorer
launch command if this problem occurs. For information on setting this parameter, see "Multiple EBS Sessions" in Document
389422.1, Recommended Browsers for Oracle E-Business Suite Release 12.
7.2 Single Forms Session Allowed Per Oracle E-Business Suite Environment
The initial release of Java Web Start for Oracle E-Business Suite allowed only a single instance of the Forms application of a
specific Oracle E-Business Suite environment to run on the client tier. For example, using Java Web Start to launch the Forms
application from Internet Explorer will start a single Forms session. After that happens, using Firefox ESR on the same client to
launch a Forms link from the same Oracle E-Business Suite environment (for example, PROD) will direct the focus to the Forms
application that was already launched by Internet Explorer. At the same time, it is possible to open a single Forms session for a
different Oracle E-Business Suite environment (for example, DEV) from any support web browser.
This limitation is resolved as part of multiple Forms session support. The application technology patches as listed in 4.5
Required Patches for Multiple Forms Session Support Using Java Web Start add support for running multiple Forms sessions for
a given Oracle E-Business Suite environment concurrently on the client. A new user preference allows an end user to control
whether to use a single or multiple Forms sessions of a specific Oracle E-Business Suite environment. For further information,
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=8b7ihnx2f_4&id=2188898.1 24/31
28/7/22, 14:43 Document 2188898.1
see 6.8 Using Multiple Forms Sessions with Java Web Start. This enhancement also allows running multiple Forms sessions for
different Oracle E-Business Suite environments (for example, DEV) at the same time.
The following exception may show in the Java Console when using Java Web Start against an SSL/TLS enabled environment:
at java.security.KeyStore.getInstance(Unknown Source)
at com.sun.deploy.services.WPlatformService$1.run(Unknown Source)
at com.sun.deploy.services.WPlatformService$1.run(Unknown Source)
at java.security.AccessController.doPrivileged(Native Method)
...
at java.lang.Thread.run(Unknown Source)
at sun.security.jca.GetInstance.getInstance(Unknown Source)
at java.security.Security.getImpl(Unknown Source)
... 26 more
This exception can be ignored as it has no impact on the usability of the environment. It is fixed in Java 8 Update 201 and
later.
7.4 Internet Explorer: Launching Java Applet Intermittent Fails Due to "frmservlet.jnlp might have been moved
or deleted"
Microsoft Internet Explorer may fail to download the JNLP file and as a result it does not launch the Forms application or Java
applet. Instead, the following error is shown in the notification bar: "frmservlet.jnlp might have been moved or deleted."
This is a very intermittent issue (Bug 24528971) which may require a workaround as described on the Microsoft Support
website. For further information, see File is "moved or deleted" or "cannot be found" error when you download PDF files in
Internet Explorer 11 in Windows.
7.5 Directly Opening the Forms Application Leaves a Blank Browser Window Open
When using Java Web Start, you may notice that a blank browser window opens and does not automatically close when
launching Forms-based applications (Bug 24954981). This occurs when directly accessing the Forms application via
<s_webentryurlprotocol>://<s_webentryhost>.<s_webentrydomain>:<s_active_webport>/forms/frmservlet as
described in Document 552301.1, How To Access Forms Directly In Oracle Applications R12. Most application users will not
launch the Forms application directly as this functionality is not enabled by default.
This is the expected behavior. It is safe to close the browser window after launching the Forms application.
7.6 Forms Socket Mode is Not Supported with Java Web Start
By default, Oracle E-Business Suite Release 12.2 and 12.1 supports Oracle Forms 10g in servlet mode only. The use of socket
mode as described in Document 384241.1, Using Forms Socket Mode with Oracle E-Business Suite Release 12 is not supported
with Java Web Start.
7.7 Browser Tabs Do Not Close After Uploading a File Attachment or Restoring the Session after a Forms
Session Timeout
Some functional flows in EBS open a browser tab/window from an Oracle Forms application. However, the browser tab/window
is unexpectedly left with an empty page after completing the transaction, and the following URL is shown in the browser's
address bar:
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=8b7ihnx2f_4&id=2188898.1 25/31
28/7/22, 14:43 Document 2188898.1
<s_webentryurlprotocol>://<s_webentryhost>.<s_webentrydomain>:<s_active_webport>OA_HTML/OALogout.jsp?
closeWindow=true&menu=Y
Examples of such functional flows are uploading a file attachment and EBS session timeout.
After the appropriate patch has been applied, the browser tab/window will display the message "Please close this browser tab
or window". (The browser tab/window cannot be closed automatically as a result of browser limitations, reported in Bug
24321183).
7.8 Issues Closing HTML Pages After Opening From Forms Application
In Microsoft Internet Explorer, an additional dialog box appears when closing an HTML page as shown in the following screen
shot:
The end user is expected to click OK to close the browser window or tab.
In Google Chrome, closing an HTML page leaves a blank tab or window open. This can safely be closed manually. These blank
tabs or windows may accumulate as you open/close further pages from the Forms application.
Launching the Forms application or a Java applet requires the download of a JNLP file frmservlet.jnlp, frmservlet (1-
n).jnlp). Browsers such as Mozilla Firefox, Google Chrome, and Microsoft Edge save these JNLP files in their respective
browser's download location on the local PC. These are automatically removed by Java Web Start when launched from the web
browser by following the instructions described in Section 6: Browser User Experience and Configuration.
A buildup of JNLP files on the local file system may occur if the end user does not launch the downloaded JNLP files. It is safe
to manually remove old JNLP files from the browser's download directory for those that were not used to launch the Forms
application or a regular Java applet.
The following product-specific features are only supported with the Java Plug-in:
Oracle Call Center Technology: the computer-telephone integration (CTI) feature that allows for integrations of Oracle
E-Business Suite with third-party telephone systems.
Oracle Demand Planning: the Demand Planning UI for managing Demand Planning objects such as documents,
measures, custom aggregates, saved selections, alerts, and scenarios.
7.11 Financial Dimension Hierarchy Manager Does Not Launch Using Java Web Start on Oracle E-Business
Suite Release 12.1.3
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=8b7ihnx2f_4&id=2188898.1 26/31
28/7/22, 14:43 Document 2188898.1
The Financial Dimension Hierarchy Manager fails to launch using Java Web Start on Oracle E-Business Suite Release 12.1.3.
The following exception is encountered when trying to launch it:
at sun.plugin2.applet.JNLP2Manager.prepareLaunchFile(Unknown Source)
at sun.plugin2.applet.JNLP2Manager.loadJarFiles(Unknown Source)
at sun.plugin2.applet.Plugin2Manager$AppletExecutionRunnable.run(Unknown Source)
at java.lang.Thread.run(Unknown Source)
Workaround: Create an empty $OA_JAVA/jbodatum111.jar file on the Oracle E-Business Suite application tier.
7.12 Patch Failure On afgstusr.sql When Applying Application Technology Patch or Product Specific Patch
In rare cases, a patch failure may be encountered when applying the application technology patch for FND, or any of the
product specific patch. The AD (online) patch utility will show the following:
Connected.
DECLARE
ERROR at line 1:
ORA-06508: PL/SQL: could not find program unit being called: "APPS.FND_WEB_SEC"
ORA-06512: at line 56
7.13 Oracle Discoverer Not Certified For Use With Java Web Start
Oracle Discoverer is not certified for use with Java Web Start on both Oracle E-Business Suite Release 12.2 and 12.1. The
impact is limited to Discoverer Plus as part of Oracle Discoverer.
Users should continue to run Discoverer Plus using the Java SE (JRE) Plug-in technology.
7.14 Unable to Launch Forms Application or Java applets using Java Web Start on Windows 10 Creators Update
via Internet Explorer 11
The Forms application and other Java applets in Oracle E-Business Suite fail to launch with Java Web Start when using Internet
Explorer 11 on the Windows 10 Creators Update. It is also not possible to manually run the JNLP file from Internet Explorer
11.
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=8b7ihnx2f_4&id=2188898.1 27/31
28/7/22, 14:43 Document 2188898.1
This is a known Java issue (JDK-8185661) that occurs only when having installed JRE 8 32-bit and 64-bit at the same time on
the Windows 10 Creators Update, and when attempting to launch Java Web Start applications using Internet Explorer 11.
This issue is resolved as of Java 8 Update 161. As a workaround: Uninstall the 64-bit JRE 8 so only the 32-bit JRE 8 is installed
on the client.
7.15 JNLP Files in the Browser's Download Folder are not Automatically Removed Using Firefox ESR on macOS
Launching the Forms application or a Java applet downloads a JNLP file frmservlet or frmservlet (1-n) to the Downloads
folder of the web browser. Firefox allows this JNLP file to be directly launched from the web browser using the Java Web Start
launcher. The JNLP file is not automatically removed by Java Web Start.
The solution will be included in a future Java release. It is safe to manually remove any old JNLP files from the browser's
download directory.
7.16 Java Console Shows java.lang.IllegalArgumentException When Using Java Web Start on macOS
The Java console log may show the following exception upon launching the Forms application or Java applet using Java Web
Start on macOS.
at java.util.EventObject.<init>(EventObject.java:56)
at java.awt.AWTEvent.<init>(AWTEvent.java:337)
at java.awt.event.ComponentEvent.<init>(ComponentEvent.java:120)
at java.awt.event.WindowEvent.<init>(WindowEvent.java:206)
at java.awt.event.WindowEvent.<init>(WindowEvent.java:251)
at java.awt.DefaultKeyboardFocusManager.dispatchEvent(DefaultKeyboardFocusManager.java:784)
...
This exception can be ignored as it has no impact on the usability of the environment. A fix for this issue is being worked upon
by development.
7.17 Generating a Graphical Display of Planning Data from the Planner Workbench Opens a Blank Browser
Window
Impacts: Google Chrome, Microsoft Edge, Firefox ESR (Windows and macOS)
A graphical representation of planning data can be generated from the Planner Workbench as part of Oracle Material
Requirements Planning (MRP). Generating such a horizontal plan graph from the Forms application opens a new browser
window or tab. A blank page is shown in the browser instead of the actual graph, and no errors are seen.
Workaround: Use the Planner Workbench which shows the same data in tabular format. Alternatively, use a web browser that
supports the Java Plug-in such as Internet Explorer.
7.18 A Web Page Launched from the Forms Application Opens in a New Browser Window Instead of a New
Browser Tab
Certain use cases, for example opening the Online Help, involve opening a web page from the Forms application. If Internet
Explorer is the browser that launched the Forms application, then the web page is opened in a new browser window instead of
a new browser tab.
This is the expected behavior as a result of web browser limitations. It is safe to close the newly created browser window
when it is no longer required.
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=8b7ihnx2f_4&id=2188898.1 28/31
28/7/22, 14:43 Document 2188898.1
7.19 Mozilla Firefox Extended Support Release (ESR) Shows a Warning Message When Launching Java Content
using Java Web Start
Due to a security fix introduced in Firefox ESR 68.0 and 68.1 a warning message is always shown when launching Java content
with Java Web Start on Windows clients:
Solution: The issue is resolved with Firefox ESR 68.2 and later. See 6.3 Mozilla Firefox Extended Support Release (ESR) for
further information about the default browser behavior of Firefox ESR 68.2 and later.
7.20 Unable to Open URLs From the Forms Application or Java Applets When Using JRE 8 Update 291 or Later
Attempting to open a URL from the Forms application or any other Java applet in Oracle E-Business Suite may appear to do
nothing, but no errors are seen. Example scenarios include accessing help; viewing concurrent request output or log files;
uploading file type type attachments; or navigating back to a self-service page.
The root cause is a change in behavior starting with JRE 8 Update 291 resulting in a potential failure when opening URLs from
the Forms application or Java applets when using Java Web Start. The unexpected behavior is typically observed with the
Microsoft Edge (legacy or Chromium) browser. However, other browsers supported with EBS may encounter similar issues
when attempting to open URLs from forms or Java applets.
Solution: See 4.8 Required Patches for Compatibility with JRE 8 Update 291 and later for the required patches to resolve this
issue.
The browser launches a Forms application or Java applet using Java Web Start by running the downloaded frmservlet.jnlp file.
If no Chrome browser policies are configured on the client to automate this process, you can run the frmservlet.jnlp file by
clicking on the frmservlet.jnlp file in the Chrome browser download bar.
With Google Chrome, trying to run the frmservlet.jnlp file by clicking on it in the download bar intermittently fails. No error
messages or indications of a failure are displayed. You should click again on the downloaded frmservlet.jnlp file, multiple times
if needed. After a few attempts, the file should run successfully and the Forms application launch as expected.
Solution: The issue is resolved in JRE 8 Update 301 b33, a bundle patch release available via My Oracle Support as Patch
33195274. The Java bug fix will be included in JRE 1.8.0_311 and higher, scheduled for release in October 2021. For further
information, see My Oracle Support Knownledge Document 1682574.1 Java SE Versions, Patch Updates and Schedules: CPUs,
PSUs, BPRs, Public v. Support Only Releases.
Section 8: References
Refer to the following My Oracle Support knowledge documents for further information:
Change Log
Date Description
Aug 6, 2020
Added Mozilla Firefox Extended Support Release (ESR) 78.x
Sep 7, 2018
Updated section 6.3 Mozilla Firefox Extended Support Release (ESR) due to end of end-of-life of
Firefox ESR 50.x
May 4, 2017
Updated section 7.2, clarifying that single Forms session limit is per EBS environment, not per client.
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=8b7ihnx2f_4&id=2188898.1 31/31