Documente Academic
Documente Profesional
Documente Cultură
1
Copyright (c) 2019, Oracle. All rights reserved. Oracle Confidential.
The most current version of this document can be obtained in My Oracle Support Knowledge Document 1375670.1. There is a
change record at the end of this document.
In This Document
Section 1: Overview
Oracle E-Business Suite Release 12.2 Architecture in a DMZ Configuration
Terminology
Section 2: Deployment Options
Section 2.1 DMZ Configuration with an Internal and an External Application Tier
Section 2.2 DMZ Configuration with a Reverse Proxy and an External Application Tier
Section 2.3: DMZ Configuration with Internal and External Application Tiers in the Intranet Sharing the
Application Tier File System
Section 2.4: DMZ Configuration with Multiple Internal/External Application Tiers in the Intranet and DMZ
Section 3: Required Patches for DMZ Configuration
Section 4: Common Configuration Steps for any Deployment Type
Section 4.1: Update Hierarchy Type
Section 4.2: Enable Distributed Oracle Java Object Cache Functionality
Section 4.3: Update Node Trust Level
Section 4.4: Update List of Responsibilities
Section 4.5: Configuring the Web Entry Point for Any Deployment Scenario
Section 4.6: Enable Distributed Oracle Java Object Cache Functionality
Section 4.7: SSH Connectivity Requirements for Online Patching
Section 5: Detailed Instructions to Configure the Supported Topologies
Section 5.1: DMZ Configuration with a Reverse Proxy and an External Application Tier
Section 5.1.1: Required Oracle E-Business Suite Patches
Section 5.1.2: Instructions to Add Additional Application Tier Nodes
Section 5.2: DMZ Configuration With Internal and External Application Tiers in the Intranet Sharing the Same
File System
Section 5.2.1: Required Oracle E-Business Suite Patches
Section 5.2.2: Instructions to Add Additional Application Tier Nodes
Section 5.3: DMZ Configuration with Multiple Internal/External Application Tiers in the Intranet and DMZ
Section 5.3.1: Required Oracle E-Business Suite Patches
Section 5.3.2: Instructions to Add Additional Application Tier Nodes
Section 6: List of External Facing Oracle E-Business Suite Products
Section 7: Oracle E-Business Suite Product Specific Configuration
Section 7.1: Set the Responsibility Trust Level and Update Required Profile Option Values
Section 7.2: Additional Configurations for Oracle iStore
Section 7.3: Forward Proxy Configurations
Section 7.4: Reverse Proxy Configurations
Section 7.5: Configuring the URL Firewall
Section 8: Oracle E-Business Suite DMZ Configuration in SSO Enabled Environment
Related Documentation
Known Issues
Change Record
SECTION 1: OVERVIEW
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 1/74
11/27/2019 Document 1375670.1
This document describes methods for making a subset of Oracle E-Business Suite Release 12.2 functionality accessible via the
Internet to external users. This document discusses supported network topologies and architectures for the E-Business Suite,
including the use of the following:
Hardware-based load-balancers for the deployment of multiple application servers for high availability
Reverse proxy servers in demilitarized zones (DMZ) for enhanced security
Multiple domains with multiple application servers
Single sign-on integration for internal user and external user authentication
This document is intended for administrators who perform Oracle E-Business Suite Release 12.2 administration. It assumes
knowledge of networking technologies. The procedures described in this document have security implications. Prior to the
implementation of any configuration options described this document, E-Business Suite system administrators are strongly
advised to review deployment architectures with their enterprise networking and security groups.
Note: Prior to proceeding with the Oracle E-Business Suite configuration in a DMZ for your environment, you should read
and implement security recommendations documented in My Oracle Support Knowledge Document 403537.1, Secure
Configuration Guide for Oracle E-Business Suite Release 12 . Pay particular attention to correcting issues that are
identified after executing the associated Secure Configuration Scripts.
When configuring Oracle E-Business Suite in a DMZ configuration, firewalls are deployed at various levels to ensure that only
authorized traffic is allowed to cross the firewall boundaries. The firewalls ensure that if intrusion attempts against machines in
the DMZ are successful, the intrusion is contained within the DMZ, leaving the machines in the intranet unaffected. The
deployment architecture described in this guide are secure because every functional group of software components is isolated
in its own demilitarized zone and all traffic is restricted by protocol and port.
Terminology
Below are definitions of some of the terms that are used in this document:
Firewall
Network firewalls control access between the internet and a corporation's internal network or intranet. Firewalls define which
internet communications will be permitted into the corporate network, and which will be blocked. A well-designed firewall can
foil many common internet-based security attacks.
DMZ
The DMZ, which stands for DeMilitarized Zone consists of the portions of a corporate network that are between the corporate
intranet and the Internet. The DMZ can be a simple one segment LAN or it can be broken down into multiple regions . The
main benefit of a properly-configured DMZ is better security. In the event of a security breach, only the area contained within
the DMZ is exposed to potential damage, while the corporate intranet remains somewhat protected.
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 2/74
11/27/2019 Document 1375670.1
Load Balancer
Load balancers distribute an application's load over many identically configured servers. This distribution ensures consistent
application availability even when one or more servers fail.
Reverse Proxy
A reverse proxy server is an intermediate server that sits between a client and the actual web server and makes requests to
the web server (origin server) on behalf of the client.
Service
A service is a functional set of Oracle E-Business Suite application processes running on one or more nodes.
Node
A node is referred to as a server that runs a set of E-Business Suite R12 application processes or database processes. In a
single node installation of Oracle E-Business Suite, all the application processes including the database processes run on one
node whereas in a multi node installation, the processes run on multiple nodes.
The internal applications tier is the server configured for internal users to access Oracle E-Business Suite. It runs the following
major application services:
The external applications tier is the server configured for external users for accessing Oracle E-Business Suite. It runs the
following application service:
The application technology stack for Oracle E-Business Suite 12.2 utilizes WebLogic Server. The Primary Application Tier Node
is the node that is running the WebLogic administration server.
The application technology stack for Oracle E-Business Suite 12.2 utilizes WebLogic Server. A secondary application tier node
or slave node is a node in a multi-node deployment of Oracle E-Business Suite. The slave node does not run the WebLogic
administration server.
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 3/74
11/27/2019 Document 1375670.1
In a Shared Application Tier Filesystem, the APPL_TOP, COMMON_TOP, OracleAS 10.1.2 Oracle Home, Oracle WebLogic
Server, and WebTier Oracle Home file systems are mounted on secondary application tier nodes either from the primary
application tier node or from an NFS server. For additional information, refer My Oracle Support knowledge Document
1375769.1 Sharing The Application Tier File System in Oracle E-Business Suite Release 12.2
Multiple Domains
Multiple domains may defined to allow different users the ability to access Oracle E-Business Suite via different Web Entry
Points.
URL Firewall
URL Firewall is a white list of URLs, for the externally exposed E-Business Suite Modules, that may be accessed from the
Internet.
The Java Object Cache provides caching for expensive or frequently used Java objects when the application servers use a Java
program to supply their content. Cached Java objects can contain generated pages or can provide support objects within the
program to assist in creating new content. The Java Object Cache automatically loads and updates objects as specified by the
Java application.
Java Object Cache (JOC) is used by some of the E-Business suite products to cache frequently used data at the Java layer. In
order not to serve the stale data, the products rely on "cache-invalidation" messages between the various application tiers in
the intranet and DMZ. When the application tier updates data that is part of cache data set, it will send cache invalidation
messages to its peer application tier so that they can throw away their cache and lookup the updated data for their cache.
OPMN
Oracle Process Manager and Notification Server (OPMN) is installed and configured on every tier designated to run the web
application. OPMN provides an integrated way to manage all Oracle Application Server components. OPMN consists of two
main pieces: the Process Manager and the Notification Server. The Process manager (PM) is the centralized process
management mechanism in Oracle Application Server and is used to manage the Oracle HTTP Server. The PM starts, restarts,
stops, and monitors every process it manages. It also performs death-detection and automatic restart of the processes. Oracle
Notification Server (ONS) is the transport mechanism for failure, recovery, startup, and other related notifications between
components in Oracle Application Server.
OHS
Oracle HTTP Server (OHS) is installed and configured on every tier that is designated to run the web application . It provides
the key infrastructure required for serving the static and dynamic content generated by Oracle E Business Suite products.
WebLogic Server
Oracle WebLogic Server is a scalable, enterprise-ready Java Platform, Enterprise Edition (Java EE) application server.
WebLogic Cluster
A WebLogic Server cluster consists of multiple WebLogic Server server instances running simultaneously and working together
to provide increased scalability and reliability. A cluster appears to clients to be a single WebLogic Server instance. The server
instances that constitute a cluster can run on the same machine, or be located on different machines..
The WebLogic proxy plug-in maintains a list of WebLogic Server instances that host a clustered servlet or JSP, and forwards
HTTP requests to those instances on a round-robin basis
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 4/74
11/27/2019 Document 1375670.1
WebLogic Domain
Administration Server
Every WebLogic domain has a server instance called Administration Server. It is used to configure all other server instances
and resources in the domain.
Managed Server
Managed Servers host the components and associated resources that constitute your applications—for example, JSPs and
EJBs. When a Managed Server starts up, it connects to the domain's Administration Server to obtain configuration and
deployment settings.
Node Manager
Node Manager is a Java utility that runs as separate process from WebLogic Server and allows you to perform common
operations tasks for a Managed Server, regardless of its location with respect to its Administration Server.
Web Entry Point refers to the host name which is designated to be used by all users to access the Oracle E-Business Suite
Release 12.2 system. By default, the web entry point is set to the hostname of the application server where Oracle E-Business
Suite is installed. In the case where a load-balancer is used, the Web Entry Point becomes the load-balancer's host name.
Oracle Access Manager (OAM) is Oracle Identity Management’s solution for web access management and user identity
administration.
1. Define server level profile values required for distinct Web entry points for internal and external users
2. Restrict access to a limited set of Oracle Applications responsibilities for users logging in via the Internet
3. Implement URL firewall to restrict access to only the subset of URLs required for external acces
1. The primary application tier node or the master node requires ssh connectivity to all the secondary application tier
nodes. If the external node is in the DMZ, then the network firewall must allow ssh protocol to pass through from the
internal primary application tier node to the external application tier nodes.
2. The secondary application tier or the slave nodes requires t3 ( tcp/ip) protocol connectivity to the WebLogic
Administration Server configured on the primary application tier node for both the run and patch edition of the
application tier file system. The network firewall must allow the tcp/ip protocol to pass through from the internal
primary application tier node to the external application tier nodes and vice versa for the Administration Server port
only. Please refer to the applications context variable s_wls_adminport on the run and patch edition file system to
determine the port configured. The default port numbers are 7001 and 7002 for a port pool selection of 0 and 1 .
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 5/74
11/27/2019 Document 1375670.1
3. The primary application tier node or the node that hosts concurrent manager service need to ping all the other servers
via the ping program that utilize the ICMP protocol. The firewall should allow the ICMP protocol to pass through.
4. The primary application node or the master node also requires connectivity to the node manager running on various
application tier nodes including the ones in the DMZ. Ensure the node manager port is also open for both the run and
patch edition file system. Please refer to the applications context variable s_nmport on the run and patch edition file
system to determine the port configured. The default port numbers are 5556 and 5557 for a port pool selection of 0
and 1 .
The diagrams in Sections 2.1 through 2.4 include traffic flows. The following describes the traffic flows denoted in the
diagrams:
See the deployment diagrams in Sections 2.1 through 2.4 for more details regarding ports that need to be opened on the
network firewall.
In all the drawings, you can see the flow of the web traffic (http/https) and the database traffic (sqlnet) . In addition to these
connections, there may be additional connection netflows related to the Java Object Cache ( JOC) . The JOC is used by some
of the E-Business suite products like iStore to cache frequently used data at the Java layer. In order not to serve the stale
data, they rely on "cache-invalidation" messages between the various application tiers in the intranet and DMZ. When the
application tier updates data that is part of cache data set, it will send cache invalidation messages to it's peer application tier
so that they can throw away their cache and lookup the updated data for their cache.
The opening of ports on the firewall related to Java Object Cache is not required for all products. It depends on the products
you deploy and how long your data is allowed to be stale in the cache. In some cases you may choose to disable the JOC by
setting a low MAX AGE (timeout) for the cache. Check Section 4.6: Enable Distributed Oracle Java Object Cache Functionality
and product specific documentation for details and recommendations.
Section 2.1: DMZ Configuration With an External and Internal Application Tier
The architecture diagram shown below represents a simple configuration with an external application tier configured in the
demilitarized zone (DMZ) for external users and an internal application tier in the intranet configured for internal users.
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 6/74
11/27/2019 Document 1375670.1
The default ports shown in the architecture diagram above is an example and may not reflect the actual values configured on
your environment. Please consult with your Oracle E-Business Suite administrator to obtain the correct port numbers
configured . The defaults shown above are for the following services
1. Ports 7001 and 7002 are the WebLogic Administration Server ports for the run and patch edition of the application tier
file system.
2. Ports 5556 and 5557 are the node manager ports for the run and patch edition of the application tier filesystem.
Known Restrictions
The configuration shown above does not allow sharing application tier file system between external and internal application
tier nodes.
Section 2.2: DMZ Configuration With a Reverse Proxy and an External Application Tier
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 7/74
11/27/2019 Document 1375670.1
The architecture diagram shown below represents a reverse proxy in the demilitarized zone (DMZ) behind an external firewall,
and an Oracle E-Business Suite Release 12.2 external application tier in another demilitarized zone behind an internal firewall.
1. Restrict access to a limited set of Oracle Applications responsibilities for users logging in via the Internet
2. Allow user access to only Oracle E-Business Suite Release 12 products that can be deployed for Internet access
3. Mask external application tier details from external users with the use of a reverse proxy server.
4. Terminate SSL connection at the reverse proxy if required
5. Implement URL firewall on the reverse proxy server to restrict access only to a subset of URLs
Known Restrictions
The configuration shown above does not allow sharing application tier file system between external and internal application
tier nodes.
Section 2.3: DMZ Configuration With Internal and External Application Tiers in the Intranet Sharing the
Application Tier File System
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 8/74
11/27/2019 Document 1375670.1
The architecture diagram shown below represents a load balancer configured in front of the external and internal application
tier nodes. These load balancers are configured to route/balance the http traffic received from the external and internal users
to the appropriate application tier nodes.
The application tier file systems can be shared among all nodes
There is no requirement to open WebLogic Administration Server port or node manager ports on the firewall
ssh connectivity among application tier nodes doesn't have to cross firewall
There is no requirement to open the Java Object Cache/FND Cache range ports used by JOC
Section 2.4: DMZ configuration with multiple Internal/External application tiers in the Intranet and DMZ
The architecture diagram shown below represents a configuration with multiple internal application tier nodes configured in
the intranet sharing a common application tier file system and multiple external application tier nodes configured in the DMZ
sharing another file system that is different from the ones shared by the internal application tier nodes. This configuration is
sometimes called as a Hybrid setup. There is a load balancer also configured in front of the internal and external application
tier nodes to route/balance the http traffic received from the external and internal users to the appropriate application tier
nodes.
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 9/74
11/27/2019 Document 1375670.1
This configuration in this section includes another firewall for an additional layer of proection. Ports will need to be opened to
this firewall for the following.:
Support Considerations
All customer configurations will be supported. However, the level of supportability will be dependent upon the implementation.
1. Customers who follow the instructions and implement a tested and certified topology as documented in this Note are
fully supported. Oracle recommends the use of one of the configurations or a variant of the configuration described in
this Note.
2. Customers who implement an alternative topology not listed in this note are supported on a best-efforts basis . The
Oracle Applications Technology Group will aim to provide an adequate solution to address a customer's problem.
Severity 1 bugs in this category will only be accepted for situations where a customer's production system is down.
Otherwise, an escalated Severity 2 status is the highest supported severity rating.
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 10/74
11/27/2019 Document 1375670.1
Note: For the configurations described in Section 2.3 and 2.4, you may also optionally front end the load-balancer with a
reverse proxy server.
Note:: All the deployment options discussed in this document allow for multiple domain s to be configured for both
internal and external application tiers. Also the internal/external users may access the Oracle E-Business Suite via URLs
that contain different domain names. For example partners.example.com for the external users and
employees.example.net for internal users.
R12.AD.C.Delta.4 and R12.TXK.C.Delta.4 Oracle E- Follow Instructions in Document 1617461.1 to apply the
Business suite required patches. If an update patch for AD/TXK is available,
AD/TXK Delta apply those instead of the minimum code level mentioned
4 Patches under Patch Number/Min Code Level.
This section provide the general configuration step that apply to any deployment model described in this document. Certain
common configuration steps must be carried out regardless of which deployment model is used. Some of them may have been
already executed as part of the setup that you may already have. Review the steps and perform the appropriate configuration
steps wherever necessary.
Several user profile options are used to construct various URLs in an E-Business Suite R12.2 environment. These user profiles
are as follows:
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 11/74
11/27/2019 Document 1375670.1
The default hierarchy type value for the above profile options is Server type . See diagram below:
The configuration of the E-Business Suite environment for DMZ requires these profile options hierarchy type to be set to
SERVRESP.
To change the profile options hierarchy type values to SERVRESP, execute the txkChangeProfH.sql SQL script as shown
below:
Source the Run Edition Environment file
$ . ./u01/install/APPS/EBSapps.env run
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 12/74
11/27/2019 Document 1375670.1
After the txkChangeProfH.sql script executes successfully, execute AutoConfig on all nodes to set the profile option values at
server level
Oracle E-Business Suite Release 12.2 is deployed in a multi-node configuration with one Database Server and many possible
application tier servers. The servers that communicate with an Oracle E-Business Suite instance include the regular application
tier servers running the Oracle HTTP Server, WebLogic components, Oracle forms,reports and also client programs such as
Application Desktop Integrator, Oracle Discoverer Admin Edition or an external SOA server. Any program which makes a
SQLNET connection to the Oracle E-Business Suite database needs to be trusted at some level. This security feature ensures
that such SQLNET connections are coming from trusted machines and/or trusted programs.
The Server Security feature supports authentication of application server machines and code modules in order to access the
database. When Server Security is activated, Application Servers are required to supply server IDs (like passwords) and/or
code IDs to access a database server. Server IDs identify the machine from which the connection is originating. Code IDs
identify the module and patch level from which the connection is originating. Code IDs are included in applications code by
development. The database server can be set to allow access only from specific machines and/or by code at a desired patch
level.
Ensure that value of application server security authentication autoconfig variable (s_appserverid_authentication) is set to
SECURE on all the application tier nodes.
Oracle E-Business Suite Release 12.2 has the capability to restrict access to a predefined set of responsibilities based on the
application tier server from which the user logs in. This capability is provided by tagging application tier servers with a trust
level indicated by the Node Trust Level (NODE_TRUST_LEVEL) server profile option. The Node Trust Level indicates the
level of trust associated with a particular application tier node. Currently, three trust levels are supported:
Administrative
Servers marked as Administrative are typically those used exclusively by system administrators. These servers
are considered secure and provide access to any and all E-Business Suite functions.
Normal
Servers marked as Normal are those used by employees within a company's firewall. Users logging in from
normal servers have access to only a limited set of responsibilities.
External
Servers marked as External are those used by customers or employees outside of a company's firewall. These
servers have access to an even smaller set of responsibilities.
The default value for this profile option for all E-Business Suite middle tiers is Normal. If you wish to learn more about the
Node Trust Level profile option, please refer to Oracle Applications System Administrators Guide .
Set the NODE_TRUST_LEVEL profile option value on the external application tier in your Oracle E-business Suite Release
12.2 environment to External. See diagram below.
To change the value of the Node Trust Level profile option value to External for a particular node, perform the following steps:
1. Login to Oracle E-Business Suite as sysadmin user using the internal URL
2. Select the System Administrator Responsibility
3. Select Profile / System
4. From the 'Find system profile option Values' window, select the server that you want to designate as the external web
tier
5. Query for %NODE%TRUST%. You will see a profile option named 'Node Trust Level'. The value for this profile option
at the site
level will be Normal. Leave this setting unchanged.
6. Set the value of this profile option to External at the server
level. The site level value should remain set to Normal
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 13/74
11/27/2019 Document 1375670.1
The steps described in this section are required only if you have marked any of the Oracle E-Business Suite Release 12.2
application tiers as External as described in section 4.2 above.
After updating the server-level profile value for Node Trust Level for the external application tier(s) to External, users can no
longer see any responsibilities when they login via the external application tier. In order for a responsibility to be available
from the external E-Business Suite application tier, set the Responsibility Trust Level profile option value for that responsibility
to External at the responsibility level. For information on additional product specific responsibilities that can be made
externally accessible from the external E-Business Suite middle tier, please refer to Appendix B1. Oracle E-Business Suite
Product Specific Configurations.
To change the value of the Responsibility Trust Level profile option at the responsibility level for a particular responsibility,
perform the following steps:
1. Login to Oracle E-Business Suite as sysadmin user using the internal URL
2. Select System Administrator Responsibility
3. Select Profile / System
4. From the 'Find system profile option Values' window, select the responsibility that you want to make available to users
logging in via the external application tier
5. Query for %RESP%TRUST%. You will see a profile option named 'Responsibility trust level'. The value for this
profile option at site
level will be Normal. Leave this setting unchanged.
6. Set the value of this profile option for the chosen responsibility to External at the responsibility
level. The site-level
value should remain Normal.
7. Repeat for all responsibilities that you want to make available from the external application tier.
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 14/74
11/27/2019 Document 1375670.1
4.5: Configuring the Web Entry Point for Any Deployment Scenario (Optional)
The deployment options you have chosen may involve configuring an additional Web Entry Point in front of the Oracle HTTP
Server running on the internal or external application tier nodes. The following configuration changes need to be performed in
the corresponding application tier context file for both the run and patch edition file system . Perform this step only if required.
s_webentryurlprotocol : set the web entry application tier context variable to point to the web entry
protocol
s_webentryhost : set the web entry application tier context variable to point to the web entry host name
s_webentrydomain : set the web entry application tier context variable to point to the web entry domain name
s_active_webport : set the web entry application tier context variable to point to the web entry port number
s_login_page : set the login page context variable to <webentry protocol>://<webentry host>.<webentry
domain>:<active web port>. Replace <webentry protocol>, <webentry host>, <webentry domain>, and <active web
port> with their respective values
s_endUserMonitoringURL : set the enduser monitoring url context variable to <webentry protocol>://<webentry
host>.<webentry domain>:<active web port>. Replace <webentry protocol>, <webentry host>, <webentry domain>,
and <active web port> with their respective values
s_external_url : set the external url context variable to <webentry protocol>://<webentry host>.<webentry
domain>:<active web port>. Replace <webentry protocol>, <webentry host>, <webentry domain>, and <active web
port> with their respective values
s_enable_sslterminator : set the ssl terminator context variable to remove the "#" where ssl connections are
terminated at the LBR or Reverse proxy configurations.
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 15/74
11/27/2019 Document 1375670.1
The opening of ports on the firewall related to Java Object Cache is not required for all products. It depends on the products
you deploy and how long your data is allowed to be stale in the cache. In some cases you may choose to reduce read
inconsistencies by setting a low MAX AGE (timeout) for the Java Object Cache. Check product specific documentation for
details and recommendations.
The following is the current list of known Oracle E-Business Suite products that use JOC: iProcurement, Oracle Configurator,
Oracle Contracts Core, Oracle Inventory Management, Oracle iStore, Oracle Leads Management, Oracle Profitability Manager,
Oracle Purchasing, Oracle Quoting, Oracle Sales Online, Oracle Scripting, Oracle Service, Oracle Sourcing and Oracle Transfer
Pricing.
If you are using one of the listed products, distributed caching functionality can be enabled in a DMZ environment through the
firewall to avoid data inconsistencies. To complete this configuration, follow the steps given below:
1. Identify the highest number of JVMs that serve the oacore JVM group in the internal and external middle tiers. For eg:
if there are 3 JVMs in the internal and 2 JVMs configured for the external middle tier, take the number as 3.
2. Identify the number of java processes spawned by the concurrent manager tier. For eg: if there are 3 JVMs spawned by
the ICM, take the number as 3 . Add this to the number of oacore JVMs . In the example given above, the total number
JVMs thus become 6 . So, six ports need to be opened in the firewall. You can use the 'pstree' command to check the
number of java processes spawned by the concurrent manager parent process. For eg: pstree -p 26258 where
26258 is the process ID of the FNDSM process.
3. Identify the ports to open in the firewall that separates the external application tier and the internal application tier .
For eg: if the JVM count is 3, you have to open 3 ports on this firewall.
)
4. This range of ports need to be specified as a value for the autoconfig variable ( s_fnd_cache_port_range . Please
make sure that the value is same in all the applications context files . The value should be specified as a range. For eg:
36500-36505. When AutoConfig completes the configuration, the value specified for this variable in the context file will
get updated in the FND_CACHE_PORT_RANGE profile option.
5. In addition to the ports specified above, you must ensure that the Java Object Cache Port specified as a value for the
autoconfig variable s_java_object_cache_port is also open on the firewall that separate the external and internal
application tiers. Please make sure that the value of the variable s_java_object_cache_port is same in all the
applications context files.
For additional information, refer My Oracle Support Document 1108093.1 ( Oracle E-Business Suite Java Caching Framework
Developer's Guide, Release 12).
The 12.2 online patching tool adop requires ssh connectivity between the primary application tier node often called as the
master node configured in the intranet with other application tier nodes configured in both the Intranet and in the DMZ. This
connectivity is required for the remote invocation of the patching procedures on all the nodes. See Set up Secure Shell on
Application tier Nodes in the Oracle E-Business Suite Maintenance Guide for more information.
Note: This document focuses on enterprise deployment in Linux environments. The same deployment may also be
configured on certified UNIX and Windows platforms. Sharing the application tier filesystem is not currently certified on
application tier server nodes running Windows.
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 16/74
11/27/2019 Document 1375670.1
Section 5.1: DMZ configuration with a reverse proxy and an external application tier
This section explains how to deploy the Oracle E-Business Suite 12.2 in a DMZ configuration with an internal and external
application tier . There are two configurations options described in this section
Section 2.1 DMZ Configuration with an Internal and an External Application Tier
Section 2.2 DMZ Configuration with a Reverse Proxy and an External Application Tier
The architecture diagram shown below in this section represents this setup.
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 17/74
11/27/2019 Document 1375670.1
The hostname's, the location of the file systems, the SID etc are chosen as an example to describe in detail how the setup
described above can be configured. The actual values of these parameters may differ on your environment.
Database Tier
DB HOSTNAME : db.example.net
INSTALL BASE : /u01/install/VISION
DB ORACLE_HOME : /u01/install/VISION/11.2.0
DBF Files : /u01/install/VISION/data
SID : VISION
Apply the required Oracle E-Business Suite patches as mentioned in Section 3: Required Patches for DMZ Configuration of this
document.
The implementation process described here assume that you have a fully-configured Oracle E-Business Suite Database Tier
and a Oracle E-Business Suite primary application tier installed on two separate machines via Rapid Install or Rapid Clone . A
two tier configuration as described in this document is the recommended approach for building a DMZ environment. Detailed
instruction on how to build a two tier installation from Rapid Install is described in My Oracle Support Document 1375769.1 .
See section 2, Planning Deployment options, and section 3, Installing a Shared Application Tier File System with 12.2 Rapid
Install.
The example given below will guide you through the process of adding the additional application tier nodes for the
configuration displayed in the diagram given in Section 5.1 DMZ configuration with a reverse proxy and an external application
tier
Existing Configuration
Database Tier
DB HOSTNAME : db.example.net
INSTALL BASE : /u01/install/VISION
DB ORACLE_HOME : /u01/install/VISION/11.2.0
DBF Files : /u01/install/VISION/data
SID : VISION
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 19/74
11/27/2019 Document 1375670.1
Section 5.1.2.1: Perform Sanity Tests On the Primary Application Tier Node
The process of implementing a multi-node configuration is complex and error prone. Before proceeding with the addition of
new nodes, you must ensure the integrity of the primary application tier node. Few of the tasks that you must perform before
proceeding are the following:
$ . ./u01/install/APPS/EBSapps.env run
$ adop phase=prepare
$ adop phase=cutover
Perform the following steps on the primary application tier node or the master node. See Section 4.1: Update Hierarchy Type
for more information.
$ . ./u01/install/APPS/EBSapps.env run
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 20/74
11/27/2019 Document 1375670.1
Switch the hirearchy type of the profile options to be of type server-responsibility
Section 5.1.2.3: Execute Adpreclone Utility on the run and patch edition File System
The adpreclone utility shipped with Oracle E-Business Suite packages the required application tier components to a staging
directory for subsequent clone and add node operations. You must run this utility before proceeding to the later section of
this document.
The adpreclone utility requires the WebLogic Administration process to be running from the file system where the utility is run.
This is required to package the Oracle Fusion Middleware components and its configuration. Execute the commands given
below on both the run and patch edition file systems:
$ . ./u01/install/APPS/EBSapps.env run
$ $INST_TOP/admin/scripts/adadminsrvctl.sh start
$ $INST_TOP/admin/scripts/adpreclone.pl appsTier
$ $INST_TOP/admin/scripts/adadminsrvctl.sh stop
$ $INST_TOP/admin/scripts/adnodemgrctl.sh stop
$ . ./u01/install/APPS/EBSapps.env patch
$ $INST_TOP/admin/scripts/adpreclone.pl appsTier
$ $INST_TOP/admin/scripts/adadminsrvctl.sh stop
$ $INST_TOP/admin/scripts/adnodemgrctl.sh stop
Section 5.1.2.4: Add the Secondary Application Tier Node to the Farm
The tasks listed in this section assume that you have completed all the steps mentioned above in this section. It is important
that you review the configuration before proceeding with the steps given below. The node to be added now will be known as
the secondary application tier node or the slave node. This node can be configured to run all services except for the Oracle
WebLogic Administration Server.
Note:
The fully qualified hostname of the application tier node to be added must be present in the sqlnet.ora file in the
<Database_Oracle_ Home>/network/admin<context-name> directory if it exists. (See tcp.invited_nodes
parameter.)
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 21/74
11/27/2019 Document 1375670.1
Section 5.1.2.4.1: Copy the Required Application Tier File System to the Secondary Nodes
Follow the instructions given below to copy the file system from the primary application tier node to the secondary application
tier node.
APPLICATION TIER HOST FROM WHERE FILE SYSTEM NEED TO BE COPIED: finance.example.net
APPLICATION TIER HOSTS TO WHICH FILE SYSTEM NEED TO BE COPIED : supplier.example.com
The following application tier file system from the INSTALL_BASE need to be copied from the
primary node to the secondary application tier node
Section 5.1.2.4.2: Execute the Post Clone Script on the Run File System
Follow the instructions given below to configure the secondary application tier node run file system . Answer the prompts as
shown in the table below. Replace the instance specific values wherever necessary.
$ cd <COMMON_TOP>/clone/bin
Provide the values required for creation of the new APPL_TOP Context file.
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 22/74
11/27/2019 Document 1375670.1
Target System Other File System Base set to /u01/install/APPS/fs2
Do you want the target system to have the same port values as the source system (y/n) [y] : y
1. /usr/tmp
2. /usr/tmp
3. /u01/install/PROD/11.2.0/appsutil/outbound/EBSDB_db
4. /usr/tmp
Choose a value which will be set as APPLPTMP value of the target node [1] : 1
Section 5.1.2.4.3: Execute the Post Clone Script on the Patch File System
Follow the instructions given below to configure the secondary application tier node patch file system . Answer the prompts as
shown in the table below. Replace the instance specific values wherever necessary.
$ cd <COMMON_TOP>/clone/bin
Provide the values required for creation of the new APPL_TOP Context file.
Do you want the target system to have the same port values as the source system (y/n) [y] : y
1. /usr/tmp
2. /usr/tmp
3. /u01/install/PROD/11.2.0/appsutil/outbound/EBSDB_db
4. /usr/tmp
Choose a value which will be set as APPLPTMP value of the target node [1] : 1
Section 5.1.2.4.4: Configure a Reverse Proxy Infront of the External Application Tier Node
The deployment option covered in this section has a reverse proxy server configured in front of the external application tier
node and it requires the Oracle E-Business Suite application tier nodes to be aware of the presence of the reverse proxy
server. The web entry point parameters in the application tier context file for both the run and patch edition file system need
to be updated to front end the external application tier node with the reverse proxy server. An example is provided in the
following table..
<webentryurlprotocol oa_var="s_webentryurlprotocol">https</webentryurlprotocol>
<webentryhost oa_var="s_webentryhost">partners</webentryhost>
<webentrydomain oa_var="s_webentrydomain">example.com</webentrydomain>
<activewebport oa_var="s_active_webport">443</activewebport>
<login_page oa_var="s_login_page">https://partners.example.com:443/OA_HTML/AppsLogin</login_page>
<EndUserMonitoringURL
oa_var="s_endUserMonitoringURL">https://partners.example.com:443/oracle_smp_chronos/oracle_smp_chronos_sdk.gif<
<externURL oa_var="s_external_url">https://partners.example.com:443/OA_HTML/AppsLogin</externURL>
$ . ./u01/install/APPS/EBSapps.env run
$ $INST_TOP/admin/scripts/adautocfg.sh
$ . ./u01/install/APPS/EBSapps.env patch
Please note there is no need to execute autoconfig on the patch file system.
Section 5.1.2.4.6: Sync Up the Context File and Update Configuration on All Nodes
Follow the instructions given below on all application tier nodes to sync up the context file and configuration files.
Login to all the application tier nodes and execute the the following scripts to sync up the context
file and configuration files for the run file system
Source the EBSapps.env file
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 25/74
11/27/2019 Document 1375670.1
$ . ./u01/install/APPS/EBSapps.env run
$ perl $AD_TOP/bin/adSyncContext.pl contextfile=$CONTEXT_FILE
If you are a later version of the AD/TXK Code level, follow the instructions given in
section 5.3.2.4-5.3.2.7 (Register the new topology from the newly added application tier
node) of My Oracle Support Document 1383621.1, Cloning Oracle E-Business Suite Release
12.2 with Rapid Clone, to register the new topology.
If you are a later version of the AD/TXK Code level, follow the instructions given in
section 5.3.2.4-5.3.2.7 (Register the new topology from the newly added application tier
node) of My Oracle Support Document 1383621.1, Cloning Oracle E-Business Suite Release
12.2 with Rapid Clone, to register the new topology.
Please note that the log file name may differ depending on the TXK code level present on your environment.
Perform the following sanity tests to check the health of the multi-node application tier system:
Start and stop the application tier processes from the current run file system. The processes must be started on the
primary application tier node first followed by the secondary application tier nodes. The application tier processes can
be started/stopped using the adstrtal.sh/adstpall.sh script from the <INST_TOP>/admin/scripts directory.
Sign on to Oracle E-Business Suite application from the multiple web entry points.
Choose a forms responsibility and launch forms.
Login to the WebLogic console and fusion middleware console using the WebLogic admin credentials. Make sure you
can view all the managed servers in RUNNING status from the servers menu.
Submit concurrent requests to make sure the concurrent requests can be executed and their output/log can be viewed
from the client.
Execute an empty online patching cycle using the online patching utility adop. An empty patching cycle can be executed
from the run edition file system by following the instructions given in the table below.
$ . ./u01/install/APPS/EBSapps.env run
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 26/74
11/27/2019 Document 1375670.1
$ adop phase=prepare
$ adop phase=cutover
Section 5.2: DMZ Configuration With Internal and External Application Tiers in the Intranet Sharing the Same File
System
This section explains how to deploy the Oracle E-Business Suite 12.2 in a DMZ configuration with internal and external
application tiers sharing the same application tier file system. The architecture diagram shown below in this section represents
the setup.
Database Tier
DB HOSTNAME : db.example.net
INSTALL BASE : /u01/install/VISION
DB ORACLE_HOME : /u01/install/VISION/11.2.0
DBF Files : /u01/install/VISION/data
SID : VISION
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 27/74
11/27/2019 Document 1375670.1
All the Secondary Application Tier nodes share the file system from finance.example.net . The file
system for the secondary nodes will be exported and mounted on the secondary application tier
nodes.
Apply the required Oracle E-Business Suite patches as mentioned in Section 3: Required Patches for DMZ Configuration of this
document.
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 28/74
11/27/2019 Document 1375670.1
The process of implementing a DMZ configuration for your E-Business Suite environment will vary depending on the topology
you need for your company. The implementation process described here assume that you have a fully-configured Oracle E-
Business Suite Database Tier and a Oracle E-Business Suite primary application tier installed on two separate machines via
Rapid Install or Rapid Clone . A two tier configuration as described in this document is the recommended approach for building
a DMZ environment. Detailed instruction on how to build a two tier installation from Rapid Install is described in My Oracle
Support Document 1375769.1. See section 2, Planning Deployment options, and section 3, Installing a Shared Application Tier
File System with 12.2 Rapid Install.
The example given below will guide you through the process of adding the additional application tier nodes for the
configuration displayed in the diagram given in Section 2.3: DMZ Configuration with Internal and External Application Tiers in
the Intranet Sharing the Application Tier File System
Existing Configuration
Database Tier
DB HOSTNAME : db.example.net
INSTALL BASE : /u01/install/VISION
DB ORACLE_HOME : /u01/install/VISION/11.2.0
DBF Files : /u01/install/VISION/data
SID : VISION
Section 5.2.2.1: Perform Sanity Tests On the Primary Application Tier Node
The process of implementing a multi-node configuration is complex and error prone. Before proceeding with the addition of
new nodes, you must ensure the integrity of the primary application tier node. Few of the tasks that you must Perform before
proceeding are the following:
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 29/74
11/27/2019 Document 1375670.1
LOCATION OF THE RUN CONTEXT_FILE :
/u01/install/APPS/fs1/inst/apps/VISION_finance/appl/admin/VISION_finance.xml
LOCATION OF THE PATCH CONTEXT_FILE :
/u01/install/APPS/fs2/inst/apps/VISION_finance/appl/admin/VISION_finance.xml
$ . ./u01/install/APPS/EBSapps.env run
$ adop phase=prepare
$ adop phase=cutover
Section 5.2.2.2: Perform Required Context File Updates On the run and patch edition File System
The topology described in Section 2.3: DMZ Configuration with Internal and External Application Tiers in the Intranet Sharing
the Application Tier File System assume that all application tier nodes share the same file system. This requires the
applications context variable "s_atName" to be same across all the application tier nodes in both run and patch edition
application context files. The value of the variable s_atName is defaulted to the hostname of the primary application tier
node. In addition to setting the s_atName to the hostname of the primary application tier, the value of the applications context
variable " s_shared_file_system" also need to be set to true if not already set. An example is provided in the following
table..
<APPL_TOP_NAME oa_var="s_atName">finance</APPL_TOP_NAME>
<shared_file_system oa_var="s_shared_file_system">true</shared_file_system>
Section 5.2.2.3: Configure a Load Balancer Infront of the Primary Application Tier Node
Oracle E-Business Suite multi-node configuration require an external load balancer in front of the application tier nodes to load
balance the http traffic from the clients. This requires the Oracle E-Business Suite application tier nodes to be aware of the
load balancing device. If you have such a configuration, ensure that the following required application tier context file
variables are updated. Please note that context file update need to be Performed on both the run and patch edition file system
application context file. An example is provided in the following table.
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 30/74
11/27/2019 Document 1375670.1
LOCATION OF THE RUN CONTEXT_FILE :
/u01/install/APPS/fs1/inst/apps/VISION_finance/appl/admin/VISION_finance.xml
LOCATION OF THE PATCH CONTEXT_FILE :
/u01/install/APPS/fs2/inst/apps/VISION_finance/appl/admin/VISION_finance.xml
LBR CONFIGURATION
<webentryurlprotocol oa_var="s_webentryurlprotocol">http</webentryurlprotocol>
<webentryhost oa_var="s_webentryhost">employees</webentryhost>
<webentrydomain oa_var="s_webentrydomain">example.net</webentrydomain>
<activewebport oa_var="s_active_webport">80</activewebport>
<login_page oa_var="s_login_page">http://employees.example.net:80/OA_HTML/AppsLogin</login_page>
<EndUserMonitoringURL
oa_var="s_endUserMonitoringURL">http://employees.example.net:80/oracle_smp_chronos/oracle_smp_chronos_sdk.gif</
<externURL oa_var="s_external_url">http://employees.example.net:80/OA_HTML/AppsLogin</externURL>
$ . ./u01/install/APPS/EBSapps.env run
$ $INST_TOP/admin/scripts/adautocfg.sh
$ . ./u01/install/APPS/EBSapps.env patch
Please note there is no need to execute autoconfig on the patch file system.
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 31/74
11/27/2019 Document 1375670.1
Perform the following steps on the primary application tier node or the master node. See Section 4.1: Update Hierarchy Type
for more information.
$ . ./u01/install/APPS/EBSapps.env run
Section 5.2.2.6: Execute Adpreclone Utility On the run and patch edition File System
The adpreclone utility shipped with Oracle E-Business Suite package the required application tier components to a staging
directory for subsequent clone and add node operations. You must run this utility before proceeding to the later section of
this document.
The adpreclone utility requires the WebLogic Administration process to be running from the file system where the utility is run.
This is required to package the Oracle Fusion Middleware components and its configuration. Perform the commands shown
below on both the run and patch edition file systems:
$ . ./u01/install/APPS/EBSapps.env run
$ $INST_TOP/admin/scripts/adadminsrvctl.sh start
$ $INST_TOP/admin/scripts/adpreclone.pl appsTier
$ $INST_TOP/admin/scripts/adadminsrvctl.sh stop
$ $INST_TOP/admin/scripts/adnodemgrctl.sh stop
$ . ./u01/install/APPS/EBSapps.env patch
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 32/74
11/27/2019 Document 1375670.1
$ $INST_TOP/admin/scripts/adpreclone.pl appsTier
$ $INST_TOP/admin/scripts/adadminsrvctl.sh stop
$ $INST_TOP/admin/scripts/adnodemgrctl.sh stop
Section 5.2.2.7: Add the Secondary Application Tier Nodes Using Shared File System
The tasks listed in this section assume that you have completed all the steps listed above in this section. It is important that
you review the configuration before proceeding with the steps given below. The node to be added now will be known as the
secondary application tier node or the slave node. This node can be configured to run all services except for the Oracle
WebLogic Administration Server.
Note:
The fully qualified hostname of the application tier node to be added must be present in the sqlnet.ora file in the
<Database_Oracle_ Home>/network/admin<context-name> directory if it exists. (See tcp.invited_nodes
parameter)
The database and TNS listener must be running.
In a shared file system, User ID and group ID should be consistent across all nodes to avoid file access permission
issues.
The same absolute path must be used for the shared file system mount points on each node.
Ensure that value of the AutoConfig variable "s_atName" is set to the hostname of the primary application tier
node.
Ensure that value of the AutoConfig variable " s_shared_file_system" is set to "true" ( without the quote) on the
primary application tier node. This variable will be automatically set to "true" if the shared file system option was
chosen during the Rapid Install.
The fully qualified hostname of the application tier nodes that you are going to add must be resolvable from the
primary application tier node and vice versa either via the Domain Naming System (DNS) or file based resolution.
Every application tier node must have a valid oraInst.loc file in the respective directory ( see Oracle Universal
Intaller guide for platform specific location) pointing to a global inventory location. The default location for the
Linux platform is /etc directory.
Section 5.2.2.8: Export the Required Application Tier File System From the Primary Application Tier Node
Follow the instructions given below to export the required application tier file system from the primary application tier node.
On a Linux system, execute the following commands as the root user to mount the application tier
file system to the secondary nodes. The export options described below may need to be adjusted per
security requirements of your company. Also, the available export options may differ on other
platforms.
/u01/install/APPS procurement.example.net(rw,sync,no_root_squash)
/u01/install/APPS supplier.example.com(rw,sync,no_root_squash)
/u01/install/APPS sourcing.example.com(rw,sync,no_root_squash)
/u01/install/OraInventory procurement.example.net(rw,sync,no_root_squash)
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 33/74
11/27/2019 Document 1375670.1
/u01/install/OraInventory supplier.example.com(rw,sync,no_root_squash)
/u01/install/OraInventory sourcing.example.com(rw,sync,no_root_squash)
If the NFS daemons are not running, execute the following command to start them:
Once the NFS daemons are running, execute the following command to export the application tier file
system:
$ /usr/sbin/exportfs -a
Ensure the application tier file systems are exported by executing the following command:
$ /usr/sbin/exportfs
Section 5.2.2.9: Mount the Required Application Tier File System to the Secondary Application Tier Nodes
Follow the instructions given below to mount the required application tier file system to the secondary application tier nodes.
The following application tier file system need to be mounted on the secondary application tier
node from the primary node.
If the NFS daemons are not running, execute the following command to start them:
Change the ownership and group permissions of these directories to be the same as that of the primary
application tier node. For example if oracle is the owner of the file system and is in the group dba,
you need to execute the commands shown below:
$ /bin/chown -R /u01/install/APPS
$ /bin/chown -R /u01/install/oraInventory
$ /bin/chgrp -R dba /u01/install/APPS
$ /bin/chgrp -R dba /u01/install/oraInventory
Use the following commands to mount the application tier file system from the primary node to the
secondary application tier nodes:
$ cd /u01/install/APPS
$ /bin/mount -t nfs -o rw,nointr,bg,hard,timeo=600,wsize=65536,rsize=65536,nfsvers=3,tcp
finance.example.net:/u01/install/APPS .
$ cd /u01/install/oraInventory
$ /bin/mount -t nfs -o rw,nointr,bg,hard,timeo=600,wsize=65536,rsize=65536,nfsvers=3,tcp
finance.example.net:/u01/install/oraInventory .
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 34/74
11/27/2019 Document 1375670.1
Add the remote file system to /etc/fstab so that file system are automatically mounted on the secondary
application tier on boot:
$ vi /etc/fstab
add the following lines to fstab
finance.example.net:/u01/install/APPS /u01/install/APPS nfs
rw,nointr,bg,hard,timeo=660,wsize=65536.rsize=65536,nfsvers=3,tcp 0 0
finance.example.net:/u01/install/oraInventory /u01/install/oraInventory nfs
rw,nointr,bg,hard,timeo=660,wsize=65536.rsize=65536,nfsvers=3,tcp 0 0
Please note that nfs version used here is V3 . Customers can also configure the mounted file
system to use NFS V4.
Section 5.2.2.10: Prepare the Pairs File for Addition Of the Secondary Application Tier Nodes
The primary decision that an administrator needs to make before proceeding with the steps given below is to decide which
services need to be configured on the secondary application tier nodes. The new node that you are planning to add can run
any service except for the WebLogic Administration Server, which is only configured on the primary application tier node.
Follow the steps given below to prepare the pairs file for adding the secondary application tier nodes.
Prepare the pairs file for configuring the run file system
A sample pairs file for the run file system is instantiated into the relevant instance home on the
primary application tier node . The name of the file is
<SID>_<primary_node_name>_<file_edition_type>.txt, located in the <INST_TOP>/appl/admin/ directory. For
example : for the configuration described in this case study, the file name is
/u01/install/APPS/fs1/inst/apps/VISION_finance/appl/admin/VISION_finance_run.txt
Create the required following directories, then copy the pairs file into a directory of your choice for
each of the application tier nodes. For example:
$ mkdir -p /u01/install/APPS/pairs/procurement
$ mkdir -p /u01/install/APPS/pairs/supplier
$ mkdir -p /u01/install/APPS/pairs/sourcing
$ cp /u01/install/APPS/fs1/inst/apps/VISION_finance/appl/admin/VISION_finance_run.txt
/u01/install/APPS/pairs/procurement
$ cp /u01/install/APPS/fs1/inst/apps/VISION_finance/appl/admin/VISION_finance_run.txt
/u01/install/APPS/pairs/supplier
$ cp /u01/install/APPS/fs1/inst/apps/VISION_finance/appl/admin/VISION_finance_run.txt
/u01/install/APPS/pairs/sourcing
Review and update the pairs file that was copied for each of the application tier nodes. The parameters
that need to be filled are under the sections [Instance Specific] and [Services] . The pairs file has
detailed instructions on how to fill the appropriate values.
For example for the node procurement, you would fill in the required parameters as shown below:
[Instance Specific]
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 35/74
11/27/2019 Document 1375670.1
s_temp=/u01/install/APPS/fs1/inst/apps/VISION_procurement/temp
s_contextname=VISION_procurement
s_hostname=procurement
s_domainname=example.net
s_cphost=finance
s_webhost=procurement
s_config_home=/u01/install/APPS/fs1/inst/apps/VISION_procurement
s_display=localhost:0.0
s_forms-c4ws_display=procurement:0.0
s_ohs_instance=EBS_web_VISION_OHS2
For example for the node supplier, you would fill in the required parameters as shown below.
[Instance Specific]
s_temp=/u01/install/APPS/fs1/inst/apps/VISION_supplier/temp
s_contextname=VISION_supplier
s_hostname=supplier
s_domainname=example.com
s_cphost=finance
s_webhost=supplier
s_config_home=/u01/install/APPS/fs1/inst/apps/VISION_supplier
s_display=localhost:0.0
s_forms-c4ws_display=supplier:0.0
s_ohs_instance=EBS_web_VISION_OHS3
For example for the node sourcing, you would fill in the required parameters as shown below. You
can notice here that the web entry point configuration is also included in addition because the
web entry points for the application tier nodes supplier and sourcing are different when compared
to nodes finance and procurement.
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 36/74
11/27/2019 Document 1375670.1
[Instance Specific]
s_temp=/u01/install/APPS/fs1/inst/apps/VISION_sourcing/temp
s_contextname=VISION_sourcing
s_hostname=sourcing
s_domainname=example.com
s_cphost=finance
s_webhost=sourcing
s_config_home=/u01/install/APPS/fs1/inst/apps/VISION_sourcing
s_display=localhost:0.0
s_forms-c4ws_display=sourcing:0.0
s_ohs_instance=EBS_web_VISION_OHS4
Prepare the pairs file for configuring the patch file system
A sample pairs file for the patch file system is instantiated into the relevant instance home on the
primary application tier node . The name of the file is
<SID>_<primary_node_name>_<file_edition_type>.txt, located in the <INST_TOP>/appl/admin/ directory. For
example : for the configuration described in this case study, the file name is
/u01/install/APPS/fs2/inst/apps/VISION_finance/appl/admin/VISION_finance_patch.txt
Review and update the pairs file that was copied for each of the application tier nodes. The parameters
that need to be filled are under the sections [Instance Specific] and [Services] . The pairs file has
detailed instructions on how to fill the appropriate values.
For example for the node procurement, you would fill in the required parameters as shown below:
[Instance Specific]
s_temp=/u01/install/APPS/fs2/inst/apps/VISION_procurement/temp
s_contextname=VISION_procurement
s_hostname=procurement
s_domainname=example.net
s_cphost=finance
s_webhost=procurement
s_config_home=/u01/install/APPS/fs2/inst/apps/VISION_procurement
s_display=localhost:0.0
s_forms-c4ws_display=procurement:0.0
s_ohs_instance=EBS_web_VISION_OHS2
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 37/74
11/27/2019 Document 1375670.1
s_batch_status=disabled
s_other_service_group_status=disabled
s_adminserverstatus=disabled
For example for the node supplier, you would fill in the required parameters as shown below.
[Instance Specific]
s_temp=/u01/install/APPS/fs2/inst/apps/VISION_supplier/temp
s_contextname=VISION_supplier
s_hostname=supplier
s_domainname=example.com
s_cphost=finance
s_webhost=supplier
s_config_home=/u01/install/APPS/fs2/inst/apps/VISION_supplier
s_display=localhost:0.0
s_forms-c4ws_display=supplier:0.0
s_ohs_instance=EBS_web_VISION_OHS3
For example for the node sourcing, you would fill in the required parameters as shown below. You
can notice here that the web entry point configuration is also included in addition because the
web entry points for the application tier nodes supplier and sourcing are different when compared
to nodes finance and procurement.
[Instance Specific]
s_temp=/u01/install/APPS/fs2/inst/apps/VISION_sourcing/temp
s_contextname=VISION_sourcing
s_hostname=sourcing
s_domainname=example.com
s_cphost=finance
s_webhost=sourcing
s_config_home=/u01/install/APPS/fs2/inst/apps/VISION_sourcing
s_display=localhost:0.0
s_forms-c4ws_display=sourcing:0.0
s_ohs_instance=EBS_web_VISION_OHS4
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 38/74
11/27/2019 Document 1375670.1
s_apcstatus=enabled
s_root_status=enabled
s_batch_status=disabled
s_other_service_group_status=disabled
s_adminserverstatus=disabled
Section 5.2.2.11: Prepare the Required Scripts for Adding the Secondary Application Tier Nodes
Create the following scripts for each node in their corresponding directories . For example for the
procurement node in /u01/install/APPS/pairs/procurement
addprocurementrun.sh
export PATH=/u01/install/APPS/fs1/FMW_Home/webtier/perl/bin:$PATH
cd /u01/install/APPS/fs1/EBSapps/comn/clone/bin
perl ./adclonectx.pl addnode
contextfile=/u01/install/APPS/fs1/inst/apps/VISION_finance/appl/admin/VISION_finance.xml \
pairsfile=/u01/install/APPS/pairs/procurement/pairs/VISION_finance_run.txt \
outfile=/u01/install/APPS/fs1/inst/apps/VISION_procurement/appl/admin/VISION_procurement.xml
addprocurementpatch.sh
export PATH=/u01/install/APPS/fs2/FMW_Home/webtier/perl/bin:$PATH
cd /u01/install/APPS/fs2/EBSapps/comn/clone/bin
perl ./adclonectx.pl addnode
contextfile=/u01/install/APPS/fs2/inst/apps/VISION_finance/appl/admin/VISION_finance.xml \
pairsfile=/u01/install/APPS/pairs/procurement/pairs/VISION_finance_patch.txt \
outfile=/u01/install/APPS/fs2/inst/apps/VISION_procurement/appl/admin/VISION_procurement.xml
For example for the sourcing node create the following scripts in /u01/install/APPS/pairs/sourcing
addsourcingrun.sh
export PATH=/u01/install/APPS/fs1/FMW_Home/webtier/perl/bin:$PATH
cd /u01/install/APPS/fs1/EBSapps/comn/clone/bin
perl ./adclonectx.pl addnode
contextfile=/u01/install/APPS/fs1/inst/apps/VISION_finance/appl/admin/VISION_finance.xml \
pairsfile=/u01/install/APPS/pairs/sourcing/pairs/VISION_finance_run.txt \
outfile=/u01/install/APPS/fs1/inst/apps/VISION_sourcing/appl/admin/VISION_sourcing.xml
addsourcingpatch.sh
export PATH=/u01/install/APPS/fs2/FMW_Home/webtier/perl/bin:$PATH
cd /u01/install/APPS/fs2/EBSapps/comn/clone/bin
perl ./adclonectx.pl addnode
contextfile=/u01/install/APPS/fs2/inst/apps/VISION_finance/appl/admin/VISION_finance.xml \
pairsfile=/u01/install/APPS/pairs/sourcing/pairs/VISION_finance_patch.txt \
outfile=/u01/install/APPS/fs2/inst/apps/VISION_sourcing/appl/admin/VISION_sourcing.xml
For example for the supplier node create the following scripts in /u01/install/APPS/pairs/supplier
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 39/74
11/27/2019 Document 1375670.1
addsupplierrun.sh
export PATH=/u01/install/APPS/fs1/FMW_Home/webtier/perl/bin:$PATH
cd /u01/install/APPS/fs1/EBSapps/comn/clone/bin
perl ./adclonectx.pl addnode
contextfile=/u01/install/APPS/fs1/inst/apps/VISION_finance/appl/admin/VISION_finance.xml \
pairsfile=/u01/install/APPS/pairs/supplier/pairs/VISION_finance_run.txt \
outfile=/u01/install/APPS/fs1/inst/apps/VISION_supplier/appl/admin/VISION_supplier.xml
addsupplierpatch.sh
export PATH=/u01/install/APPS/fs2/FMW_Home/webtier/perl/bin:$PATH
cd /u01/install/APPS/fs2/EBSapps/comn/clone/bin
perl ./adclonectx.pl addnode
contextfile=/u01/install/APPS/fs2/inst/apps/VISION_finance/appl/admin/VISION_finance.xml \
pairsfile=/u01/install/APPS/pairs/supplier/pairs/VISION_finance_patch.txt \
outfile=/u01/install/APPS/fs2/inst/apps/VISION_supplier/appl/admin/VISION_supplier.xml
Section 5.2.2.12: Add the secondary application tier nodes to the farm
Note: You must ensure that the WebLogic Administration Server is running from both the run and patch edition file
system on the primary application tier node before proceeding with the steps given below. You can check the status of the
Weblogic Administration Server for both the run and patch edition file system by executing the command
<INST_TOP>/admin/scripts/adadminsrvctl.sh status
Login to the secondary application tier nodes and execute the scripts to add the run and patch edition
file system. The scripts must be executed in serial mode on all the nodes for the run file system
followed by patch. Complete one node first before proceeding to the next.
For example:
Logon to the procurement.example.net node, execute
$ sh /u01/install/APPS/pairs/procurement/addprocurementrun.sh
$ sh /u01/install/APPS/pairs/procurement/addprocurementpatch.sh
Logon to the supplier.example.com node, execute
$ sh /u01/install/APPS/pairs/supplier/addsupplierrun.sh
$ sh /u01/install/APPS/pairs/supplier/addsupplierpatch.sh
Logon to the sourcing.example.com node, execute
$ sh /u01/install/APPS/pairs/supplier/addsourcingrun.sh
$ sh /u01/install/APPS/pairs/supplier/addsoucingpatch.sh
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 40/74
11/27/2019 Document 1375670.1
Section 5.2.2.13: Sync Up the Context File and Update Configuration On All Nodes
Follow the instructions given below on all application tier nodes to sync up the context file and configuration files.
Login to all the application tier nodes and execute the the following scripts to sync up the context
file and configuration files for the run file system
Source the EBSapps.env file
$ . ./u01/install/APPS/EBSapps.env run
$ perl $AD_TOP/bin/adSyncContext.pl contextfile=$CONTEXT_FILE
If you are a later version of the AD/TXK Code level, follow the instructions given in
section 5.3.2.4-5.3.2.7 ( Register the new topology from the newly added application tier
node) of My Oracle Support Document 1383621.1, Cloning Oracle E-Business Suite Release
12.2 with Rapid Clone, to register the new topology.
If you are a later version of the AD/TXK Code level, follow the instructions given in
section 5.3.2.4-5.3.2.7 ( Register the new topology from the newly added application tier
node) of My Oracle Support Document 1383621.1, Cloning Oracle E-Business Suite Release
12.2 with Rapid Clone, to register the new topology.
Perform the following sanity tests to check the health of the multi-node application tier system.
Start and stop the application tier processes from the current run file system. The processes must be started on the
primary application tier node first followed by the secondary application tier nodes. The application tier processes can
be started/stopped using the adstrtal.sh/adstpall.sh script from the <INST_TOP>/admin/scripts directory.
Sign on to Oracle E-Business Suite application from the multiple web entry points.
Choose a forms responsibility and launch forms.
Login to the WebLogic console and fusion middleware console using the WebLogic admin credentials. Make sure you
can view all the managed servers in RUNNING status from the servers menu.
Submit concurrent requests to make sure the concurrent requests can be executed and their output/log can be viewed
from the client.
Execute an empty online patching cycle using the online patching utility adop. An empty patching cycle can be executed
from the run edition file system by following the instructions given in the table below.
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 41/74
11/27/2019 Document 1375670.1
Run File System ( FS1) : /u01/install/APPS/fs1
Patch File System ( FS2) : /u01/install/APPS/fs2
INST_TOP 1 : /u01/install/APPS/fs1/inst
INST_TOP 2 : /u01/install/APPS/fs2/inst
LOCATION OF THE RUN CONTEXT_FILE :
/u01/install/APPS/fs1/inst/apps/VISION_finance/appl/admin/VISION_finance.xml
LOCATION OF THE PATCH CONTEXT_FILE :
/u01/install/APPS/fs2/inst/apps/VISION_finance/appl/admin/VISION_finance.xml
$ . ./u01/install/APPS/EBSapps.env run
$ adop phase=prepare
$ adop phase=cutover
Section 5.3: DMZ Configuration with Multilple Internal/External Application Tiers in the Intranet and DMZ
This section explains how to deploy the Oracle E-Business Suite 12.2 in a DMZ configuration with multiple internal application
tier nodes configured in the intranet sharing a common application tier file system and multiple external application tier nodes
configured in the DMZ sharing another file system that is different from the one shared by the internal application tier nodes.
The architecture diagram shown below epresents this setup .
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 42/74
11/27/2019 Document 1375670.1
Database Tier
DB HOSTNAME : db.example.net
INSTALL BASE : /u01/install/VISION
DB ORACLE_HOME : /u01/install/VISION/11.2.0
DBF Files : /u01/install/VISION/data
SID : VISION
Apply the required Oracle E-Business Suite patches as mentioned in Section 3: Required Patches for DMZ Configuration of this
document.
The process of implementing a DMZ configuration for your E-Business Suite environment will vary depending on the topology
you need for your company. The implementation process described here assume that you have a fully-configured Oracle E-
Business Suite Database Tier and a Oracle E-Business Suite primary application tier installed on two separate machines via
Rapid Install or Rapid Clone . A two tier configuration as described in this document is the recommended approach for building
a DMZ environment. Detailed instruction on how to build a two tier installation from Rapid Install is described in My Oracle
Support Document 1375769.1. See section 2, Planning Deployment options, and section 3, Installing a Shared Application Tier
File System with 12.2 Rapid Install.
The example given below will guide you through the process of adding the additional application tier nodes for the
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 44/74
11/27/2019 Document 1375670.1
configuration displayed in the diagram given in Section 2.4: DMZ Configuration with Multiple Internal/External Application Tiers
in the Intranet and DMZ of this document.
Existing Configuration
Database Tier
DB HOSTNAME : db.example.net
INSTALL BASE : /u01/install/VISION
DB ORACLE_HOME : /u01/install/VISION/11.2.0
DBF Files : /u01/install/VISION/data
SID : VISION
Section 5.3.2.1: Perform Sanity Tests on the Primary Application Tier Node
The process of implementing a multi-node configuration is complex and error prone. Before proceeding with the addition of
new nodes, you must ensure the integrity of the primary application tier node. Few of the tasks that you must perform before
proceeding are the following:
$ . ./u01/install/APPS/EBSapps.env run
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 45/74
11/27/2019 Document 1375670.1
$ adop phase=prepare
$ adop phase=cutover
Section 5.3.2.2: Perform Required Context File Updates on the run and patch edition File System
The topology described in Section 2.4: DMZ Configuration with Multiple Internal/External Application Tiers in the Intranet and
DMZ of this document assume that the internal and external application tier nodes share the application tier file system among
similar node type. For example all internal application tier nodes share one file system and all the external application tiers
share another file system. This configuration requires the applications context variable "s_atName" to be same across all the
application tier nodes that share the same file system. The value of the variable s_atName will be defaulted to the hostname
of the primary internal or external application tier node from where the file system is shared. For example for the configuration
described in this section, the value of s_atName and s_shared_file_system will be set as shown below
Section 5.2.2.3: Configure a Load Balancer Infront of the Primary Application Tier Node
Oracle E-Business Suite multi-node configuration require an external load balancer in front of the application tier nodes to load
balance the http traffic from the clients. This requires the Oracle E-Business Suite application tier nodes to be aware of the
load balancing device. If you have such a configuration, ensure that the following required application tier context file
variables are updated. Please note that context file update need to be Performed on both the run and patch edition file system
application context file. An example is provided in the following table.
LBR CONFIGURATION
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 46/74
11/27/2019 Document 1375670.1
CONTEXT VARIABLES TO BE CHANGED FOR THE ABOVE LBR CONFIGURATION
<webentryurlprotocol oa_var="s_webentryurlprotocol">http</webentryurlprotocol>
<webentryhost oa_var="s_webentryhost">employees</webentryhost>
<webentrydomain oa_var="s_webentrydomain">example.net</webentrydomain>
<activewebport oa_var="s_active_webport">80</activewebport>
<login_page oa_var="s_login_page">http://employees.example.net:80/OA_HTML/AppsLogin</login_page>
<EndUserMonitoringURL
oa_var="s_endUserMonitoringURL">http://employees.example.net:80/oracle_smp_chronos/oracle_smp_chronos_sdk.gif</
<externURL oa_var="s_external_url">http://employees.example.net:80/OA_HTML/AppsLogin</externURL>
$ . ./u01/install/APPS/EBSapps.env run
$ $INST_TOP/admin/scripts/adautocfg.sh
$ . ./u01/install/APPS/EBSapps.env patch
Please note there is no need to execute autoconfig on the patch file system.
Perform the following steps on the primary application tier node or the master node. See Section 4.1: Update Hierarchy Type
for more information.
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 47/74
11/27/2019 Document 1375670.1
INST_TOP 1 : /u01/install/APPS/fs1/inst
INST_TOP 2 : /u01/install/APPS/fs2/inst
LOCATION OF THE RUN CONTEXT_FILE :
/u01/install/APPS/fs1/inst/apps/VISION_finance/appl/admin/VISION_finance.xml
LOCATION OF THE PATCH CONTEXT_FILE :
/u01/install/APPS/fs2/inst/apps/VISION_finance/appl/admin/VISION_finance.xml
$ . ./u01/install/APPS/EBSapps.env run
Section 5.3.2.6: Execute Adpreclone Utility on the run and patch edition File System
The adpreclone utility shipped with Oracle E-Business Suite package the required application tier components to a staging
directory for subsequent clone and add node operations. You must run this utility before proceeding to the later section of
this document.
The adpreclone utility requires the WebLogic Administration process to be running from the file system where the utility is run.
This is required to package the Oracle Fusion Middleware components and its configuration. Perform the commands shown
below on both the run and patch edition file systems:
$ . ./u01/install/APPS/EBSapps.env run
$ $INST_TOP/admin/scripts/adadminsrvctl.sh start
$ $INST_TOP/admin/scripts/adpreclone.pl appsTier
$ $INST_TOP/admin/scripts/adadminsrvctl.sh stop
$ $INST_TOP/admin/scripts/adnodemgrctl.sh stop
$ . ./u01/install/APPS/EBSapps.env patch
$ $INST_TOP/admin/scripts/adpreclone.pl appsTier
$ $INST_TOP/admin/scripts/adadminsrvctl.sh stop
$ $INST_TOP/admin/scripts/adnodemgrctl.sh stop
Section 5.3.2.7: Add Secondary Internal Application Tier Nodes Using Shared File System
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 48/74
11/27/2019 Document 1375670.1
The configuration tasks listed below assume that you have completed all the steps listed in this section above. It is important
that you review the configuration before proceeding with the steps given below. The node to be added now will be known as
the secondary application tier node or the slave node. This node can be configured to run all services except for the Oracle
WebLogic Administration Server.
Note:
The fully qualified hostname of the application tier node to be added must be present in the sqlnet.ora file in the
<Database_Oracle_ Home>/network/admin<context-name> directory if it exists. (See tcp.invited_nodes
parameter.)
The database and TNS listener must be running.
In a shared file system, User ID and group ID should be consistent across all nodes to avoid file access permission
issues.
The same absolute path must be used for the shared file system mount points on each node.
Ensure that value of the AutoConfig variable "s_atName" is set to the hostname of the master node
Ensure that value of the AutoConfig variable " s_shared_file_system" is set to "true" ( without the quote) on the
primary application tier node. This variable will be automatically set to "true" if the shared file system option was
chosen during the Rapid Install.
The fully qualified hostname of the application tier nodes that you are going to add must be resolvable from the
primary application tier node and vice versa either via the Domain Naming System (DNS) or file based resolution.
Every application tier node must have a valid oraInst.loc file in the respective directory ( see Oracle Universal
Intaller guide for platform specific location) pointing to a global inventory location. The default location for the
Linux platform is /etc directory.
Section 5.3.2.8: Export the Required Application Tier File System From the Primary Internal Application Tier Node
Follow the instructions given below to export the required application tier file system from the primary application tier node.
On a Linux system, execute the following commands as the root user to mount the application tier
file system to the secondary nodes. The export options described below may need to be adjusted per
the security requirements of your company. Also, the available options may differ for other
platforms.
/u01/install/APPS procurement.example.net(rw,sync,no_root_squash)
/u01/install/OraInventory procurement.example.net(rw,sync,no_root_squash)
If the NFS daemons are not running, execute the following command to start them:
Once the NFS daemons are running, execute the following command to export the application tier file
system:
$ /usr/sbin/exportfs -a
Ensure the application tier file systems are exported by executing the following command:
$ /usr/sbin/exportfs
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 49/74
11/27/2019 Document 1375670.1
Section 5.3.2.9: Mount the Required Application Tier File System to the Secondary Internal Application Tier Nodes
Follow the instructions given below to mount the required application tier file system to the secondary application tier nodes
The following application tier file system need to be mounted on the secondary application tier
node from the primary node.
If the NFS daemons are not running, execute the following command to start them:
Change the ownership and group permissions of these directories to be the same as that of the primary
application tier node. For example if oracle is the owner of the file system and is in the group dba,
you need to execute the commands shown below:
$ /bin/chown -R /u01/install/APPS
$ /bin/chown -R /u01/install/oraInventory
$ /bin/chgrp -R dba /u01/install/APPS
$ /bin/chgrp -R dba /u01/install/oraInventory
Use the following commands to mount the application tier file system from the primary node to the
secondary application tier nodes:
$ cd /u01/install/APPS
$ /bin/mount -t nfs -o rw,nointr,bg,hard,timeo=600,wsize=65536,rsize=65536,nfsvers=3,tcp
finance.example.net:/u01/install/APPS .
$ /bin/mount -t nfs -o rw,nointr,bg,hard,timeo=600,wsize=65536,rsize=65536,nfsvers=3,tcp
finance.example.net:/u01/install/oraInventory .
Add the remote file system to /etc/fstab so that file system are automatically mounted on the secondary
application tier on boot:
$ vi /etc/fstab
add the following lines to fstab
finance.example.net:/u01/install/APPS /u01/install/APPS nfs
rw,nointr,bg,hard,timeo=660,wsize=65536.rsize=65536,nfsvers=3,tcp 0 0
finance.example.net:/u01/install/oraInventory /u01/install/oraInventory nfs
rw,nointr,bg,hard,timeo=660,wsize=65536.rsize=65536,nfsvers=3,tcp 0 0
Please note that nfs version used here is V3 . Customers can also configure the mounted file
system to use NFS V4.
Section 5.3.2.10: Prepare the Pairs File for Addition of the Secondary Internal Application Tier Nodes
The primary decision that an administrator needs to make before proceeding with the steps given below is to decide which
services need to be configured on the secondary application tier nodes. The new node that you are planning to add can run
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 50/74
11/27/2019 Document 1375670.1
any service except for the WebLogic Administration Server, which is only configured on the primary application tier node.
Follow the steps given below to prepare the pairs file for adding the secondary application tier nodes.
Prepare the pairs file for configuring the run file system
A sample pairs file for the run file system is instantiated into the relevant instance home on the
primary application tier node . The name of the file is
<SID>_<primary_node_name>_<file_edition_type>.txt, located in the <INST_TOP>/appl/admin/ directory. For
example : for the configuration described in this case study, the file name is
/u01/install/APPS/fs1/inst/apps/VISION_finance/appl/admin/VISION_finance_run.txt
Create the required following directories, then copy the pairs file into a directory of your choice for
each of the application tier nodes. For example:
$ mkdir -p /u01/install/APPS/pairs/procurement
$ cp /u01/install/APPS/fs1/inst/apps/VISION_finance/appl/admin/VISION_finance_run.txt
/u01/install/APPS/pairs/procurement
Review and update the pairs file that was copied for each of the application tier nodes. The parameters
that need to be filled are under the sections [Instance Specific] and [Services] . The pairs file has
detailed instructions on how to fill the appropriate values.
For example for the node procurement, you would fill in the required parameters as shown below:
[Instance Specific]
s_temp=/u01/install/APPS/fs1/inst/apps/VISION_procurement/temp
s_contextname=VISION_procurement
s_hostname=procurement
s_domainname=example.net
s_cphost=finance
s_webhost=procurement
s_config_home=/u01/install/APPS/fs1/inst/apps/VISION_procurement
s_display=localhost:0.0
s_forms-c4ws_display=procurement:0.0
s_ohs_instance=EBS_web_VISION_OHS2
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 51/74
11/27/2019 Document 1375670.1
Prepare the pairs file for configuring the patch file system
A sample pairs file for the patch file system is instantiated into the relevant instance home on the
primary application tier node . The name of the file is
<SID>_<primary_node_name>_<file_edition_type>.txt, located in the <INST_TOP>/appl/admin/ directory. For
example : for the configuration described in this case study, the file name is
/u01/install/APPS/fs2/inst/apps/VISION_finance/appl/admin/VISION_finance_patch.txt
Review and update the pairs file that was copied for each of the application tier nodes. The parameters
that need to be filled are under the sections [Instance Specific] and [Services] . The pairs file has
detailed instructions on how to fill the appropriate values.
For example for the node procurement, you would fill in the required parameters as shown below:
[Instance Specific]
s_temp=/u01/install/APPS/fs2/inst/apps/VISION_procurement/temp
s_contextname=VISION_procurement
s_hostname=procurement
s_domainname=example.net
s_cphost=finance
s_webhost=procurement
s_config_home=/u01/install/APPS/fs2/inst/apps/VISION_procurement
s_display=localhost:0.0
s_forms-c4ws_display=procurement:0.0
s_ohs_instance=EBS_web_VISION_OHS2
Section 5.3.2.11: Prepare the Required Scripts for Adding the Secondary Internal Application Tier Nodes
Create the following scripts for each node in their corresponding directories . For example for the
procurement node in /u01/install/APPS/pairs/procurement
addprocurementrun.sh
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 52/74
11/27/2019 Document 1375670.1
export PATH=/u01/install/APPS/fs1/FMW_Home/webtier/perl/bin:$PATH
cd /u01/install/APPS/fs1/EBSapps/comn/clone/bin
perl ./adclonectx.pl addnode
contextfile=/u01/install/APPS/fs1/inst/apps/VISION_finance/appl/admin/VISION_finance.xml \
pairsfile=/u01/install/APPS/pairs/procurement/pairs/VISION_finance_run.txt \
outfile=/u01/install/APPS/fs1/inst/apps/VISION_procurement/appl/admin/VISION_procurement.xml
addprocurementpatch.sh
export PATH=/u01/install/APPS/fs2/FMW_Home/webtier/perl/bin:$PATH
cd /u01/install/APPS/fs2/EBSapps/comn/clone/bin
perl ./adclonectx.pl addnode
contextfile=/u01/install/APPS/fs2/inst/apps/VISION_finance/appl/admin/VISION_finance.xml \
pairsfile=/u01/install/APPS/pairs/procurement/pairs/VISION_finance_patch.txt \
outfile=/u01/install/APPS/fs2/inst/apps/VISION_procurement/appl/admin/VISION_procurement.xml
Section 5.3.2.12: Add the Secondary Internal Application Tier Node to the Farm
Note: You must ensure that the WebLogic Administration Server is running from both the run and patch edition file
system on the primary application tier node before proceeding with the steps given below. You can check the status of the
Weblogic Administration Server for both the run and patch edition file system by executing the command
<INST_TOP>/admin/scripts/adadminsrvctl.sh status
Login to the secondary application tier nodes and execute the scripts to add the run and patch edition
file system. The scripts must be executed in serial mode on all the nodes for the run file system
followed by patch. Complete one node first before proceeding to the next.
For example:
Logon to the procurement.example.net node, execute
$ sh /u01/install/APPS/pairs/procurement/addprocurementrun.sh
$ sh /u01/install/APPS/pairs/procurement/addprocurementpatch.sh
The tasks listed in this section assume that you have successfully completed the configuration of the internal application tier
node . It is important that you review the configuration before proceeding with the steps given below. The node to be added
now will be known as the secondary external application tier node . This node can be configured to run all services except for
the Oracle WebLogic Administration Server and does not share the file system with the internal application tier nodes.
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 53/74
11/27/2019 Document 1375670.1
Note:
The fully qualified hostname of the application tier node to be added must be present in the sqlnet.ora file in the
<Database_Oracle_ Home>/network/admin<context-name> directory if it exists. (See tcp.invited_nodes
parameter.)
The database and TNS listener must be running.
In a shared file system, User ID and group ID should be consistent across all nodes to avoid file access permission
issues.
The same absolute path must be used for the shared file system mount points on each node..
The fully qualified hostname of the application tier nodes that you are going to add must be resolvable from the
primary application tier node and vice versa either via the Domain Naming System (DNS) or file based resolution.
Every application tier node must have a valid oraInst.loc file in the respective directory ( see Oracle Universal
Intaller guide for platform specific location) pointing to a global inventory location. The default location for the
Linux platform is /etc directory.
Section 5.3.2.14: Copy the Required Application Tier File System to the Secondary External Application
Tier Node
Follow the instructions given below to copy the file system from the primary application tier node to the secondary external
application tier node.
APPLICATION TIER HOST FROM WHERE FILE SYSTEM NEED TO BE COPIED: finance.example.net
APPLICATION TIER HOSTS TO WHICH FILE SYSTEM NEED TO BE COPIED : supplier.example.com
The following application tier file system from INSTALL_BASE need to be copied from the primary
node to the secondary application tier node
Section 5.3.2.15: Execute the Post Clone Script on the Run File System
Follow the instructions given below to configure the secondary application tier node run file system . Answer the prompts as
shown in the table below. Replace the instance specific values wherever necessary.
$ cd <COMMON_TOP>/clone/bin
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 54/74
11/27/2019 Document 1375670.1
Do you want to add a node (yes/no) : yes
Provide the values required for creation of the new APPL_TOP Context file.
Do you want the target system to have the same port values as the source system (y/n) [y] : y
1. /usr/tmp
2. /usr/tmp
3. /u01/install/PROD/11.2.0/appsutil/outbound/EBSDB_db
4. /usr/tmp
Choose a value which will be set as APPLPTMP value of the target node [1] : 1
Section 5.3.2.16: Execute the Post Clone Script on the Patch File System
Follow the instructions given below to configure the secondary application tier node patch file system . Answer the prompts as
shown in the table below. Replace the instance specific values wherever necessary.
$ cd <COMMON_TOP>/clone/bin
Provide the values required for creation of the new APPL_TOP Context file.
Do you want the target system to have the same port values as the source system (y/n) [y] : y
1. /usr/tmp
2. /usr/tmp
3. /u01/install/PROD/11.2.0/appsutil/outbound/EBSDB_db
4. /usr/tmp
Choose a value which will be set as APPLPTMP value of the target node [1] : 1
Section 5.3.2.17: Configure a Load Balancer Infront of the Secondary External Application Tier Node
Oracle E-Business Suite multi-node configuration require an external load balancer in front of the application tier nodes to load
balance the http traffic from the clients. This requires the Oracle E-Business Suite application tier nodes to be aware of the
load balancing device. If you have such a configuration, ensure that the following required application tier context file
variables are updated. Please note that context file update need to be performed both on the run and patch edition file system
application context file and AutoConfig utility executed to update the configuration. An example is provided in the following
table.
LBR CONFIGURATION
<webentryurlprotocol oa_var="s_webentryurlprotocol">https</webentryurlprotocol>
<webentryhost oa_var="s_webentryhost">partners</webentryhost>
<webentrydomain oa_var="s_webentrydomain">example.com</webentrydomain>
<activewebport oa_var="s_active_webport">443</activewebport>
<login_page oa_var="s_login_page">https://partners.example.com:443/OA_HTML/AppsLogin</login_page>
<EndUserMonitoringURL
oa_var="s_endUserMonitoringURL">https://partners.example.com:443/oracle_smp_chronos/oracle_smp_chronos_sdk.gif<
<externURL oa_var="s_external_url">https://partners.example.com:443/OA_HTML/AppsLogin</externURL>
Section 5.3.2.18: Export the Required Application Tier File System From the Primary External Application Tier Node
Follow the instructions given below to export the required application tier file system from the primary external application tier
node.
On a Linux system, execute the following commands as the root user to mount the application tier
file system to the secondary nodes. The export options described below may need to be adjusted per
the security requirements of your company. Also, the available options may differ for other
platforms.
/u01/install/APPS sourcing.example.com(rw,sync,no_root_squash)
/u01/install/OraInventory sourcing.example.com(rw,sync,no_root_squash)
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 57/74
11/27/2019 Document 1375670.1
If the NFS daemons are not running, execute the following command to start them:
Once the NFS daemons are running, execute the following command to export the application tier file
system:
$ /usr/sbin/exportfs -a
Ensure the application tier file systems are exported by executing the following command:
$ /usr/sbin/exportfs
Section 5.3.2.19: Mount the Required Application Tier File System to the Secondary External Application Tier Node
Follow the instructions given below to mount the required application tier file system to the secondary external application tier
node.
The following application tier file system need to be mounted on the secondary application tier
node from the primary node.
If the NFS daemons are not running, execute the following command to start them:
Change the ownership and group permissions of these directories to be the same as that of the primary
application tier node. For example if oracle is the owner of the file system and is in the group dba,
you need to execute the commands shown below:
$ /bin/chown -R /u01/install/APPS
$ /bin/chown -R /u01/install/oraInventory
$ /bin/chgrp -R dba /u01/install/APPS
$ /bin/chgrp -R dba /u01/install/oraInventory
Use the following commands to mount the application tier file system from the primary node to the
secondary application tier nodes:
$ cd /u01/install/APPS
$ /bin/mount -t nfs -o rw,nointr,bg,hard,timeo=600,wsize=65536,rsize=65536,nfsvers=3,tcp
supplier.example.net:/u01/install/APPS .
$ /bin/mount -t nfs -o rw,nointr,bg,hard,timeo=600,wsize=65536,rsize=65536,nfsvers=3,tcp
supplier.example.net:/u01/install/oraInventory .
Add the remote file system to /etc/fstab so that file system are automatically mounted on the secondary
application tier on boot:
$ vi /etc/fstab
add the following lines to fstab
supplier.example.net:/u01/install/APPS /u01/install/APPS nfs
rw,nointr,bg,hard,timeo=660,wsize=65536.rsize=65536,nfsvers=3,tcp 0 0
supplier.example.net:/u01/install/oraInventory /u01/install/oraInventory nfs
rw,nointr,bg,hard,timeo=660,wsize=65536.rsize=65536,nfsvers=3,tcp 0 0
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 58/74
11/27/2019 Document 1375670.1
Please note that nfs version used here is V3 . Customers can also configure the mounted file
system to use NFS V4.
Section 5.3.2.20: Prepare the Pairs File for Addition of the Secondary External Application Tier Node
The primary decision that an administrator needs to make before proceeding with the steps given below is to decide which
services need to be configured on the secondary application tier nodes. The new node that you are planning to add can run
any service except for the WebLogic Administration Server, which is only configured on the primary internal application
tier node. Follow the steps given below to prepare the pairs file for adding the secondary application tier nodes.
Prepare the pairs file for configuring the run file system
A sample pairs file for the run file system is instantiated into the relevant instance home on the
primary application tier node . The name of the file is
<SID>_<primary_node_name>_<file_edition_type>.txt, located in the <INST_TOP>/appl/admin/ directory. For
example : for the configuration described in this case study, the file name is
/u01/install/APPS/fs1/inst/apps/VISION_supplier/appl/admin/VISION_supplier_run.txt
Create the required following directories, then copy the pairs file into a directory of your choice for
each of the application tier nodes. For example:
$ mkdir -p /u01/install/APPS/pairs/sourcing
$ cp /u01/install/APPS/fs1/inst/apps/VISION_supplier/appl/admin/VISION_supplier_run.txt
/u01/install/APPS/pairs/sourcing/VISION_sourcing_run.txt
Review and update the pairs file that was copied for each of the application tier nodes. The parameters
that need to be filled are under the sections [Instance Specific] and [Services] . The pairs file has
detailed instructions on how to fill the appropriate values.
For example for the node sourcing, you would fill in the required parameters as shown below:
[Instance Specific]
s_temp=/u01/install/APPS/fs1/inst/apps/VISION_sourcing/temp
s_contextname=VISION_sourcing
s_hostname=sourcing
s_domainname=example.com
s_cphost=finance
s_webhost=sourcing
s_config_home=/u01/install/APPS/fs1/inst/apps/VISION_sourcing
s_display=localhost:0.0
s_forms-c4ws_display=sourcing:0.0
s_ohs_instance=EBS_web_VISION_OHS4
Prepare the pairs file for configuring the patch file system
A sample pairs file for the patch file system is instantiated into the relevant instance home on the
primary application tier node . The name of the file is
<SID>_<primary_node_name>_<file_edition_type>.txt, located in the <INST_TOP>/appl/admin/ directory. For
example : for the configuration described in this case study, the file name is
/u01/install/APPS/fs2/inst/apps/VISION_supplier/appl/admin/VISION_supplier_patch.txt
Review and update the pairs file that was copied for each of the application tier nodes. The parameters
that need to be filled are under the sections [Instance Specific] and [Services] . The pairs file has
detailed instructions on how to fill the appropriate values.
For example for the node sourcing, you would fill in the required parameters as shown below:
[Instance Specific]
s_temp=/u01/install/APPS/fs2/inst/apps/VISION_sourcing/temp
s_contextname=VISION_sourcing
s_hostname=sourcing
s_domainname=example.com
s_cphost=finance
s_webhost=sourcing
s_config_home=/u01/install/APPS/fs2/inst/apps/VISION_sourcing
s_display=localhost:0.0
s_forms-c4ws_display=sourcing:0.0
s_ohs_instance=EBS_web_VISION_OHS4
Section 5.3.2.21 Prepare the Required Scripts for Adding the Secondary External Application Tier Node
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 60/74
11/27/2019 Document 1375670.1
LOCATION OF THE RUN CONTEXT_FILE :
/u01/install/APPS/fs1/inst/apps/VISION_finance/appl/admin/VISION_supplier.xml
LOCATION OF THE PATCH CONTEXT_FILE :
/u01/install/APPS/fs2/inst/apps/VISION_finance/appl/admin/VISION_supplier.xml
Create the following scripts for each node in their corresponding directories . For example for the
sourcing node in /u01/install/APPS/pairs/sourcing
addsourcingrun.sh
export PATH=/u01/install/APPS/fs1/FMW_Home/webtier/perl/bin:$PATH
cd /u01/install/APPS/fs1/EBSapps/comn/clone/bin
perl ./adclonectx.pl addnode
contextfile=/u01/install/APPS/fs1/inst/apps/VISION_supplier/appl/admin/VISION_supplier.xml \
pairsfile=/u01/install/APPS/pairs/sourcing/pairs/VISION_sourcing_run.txt \
outfile=/u01/install/APPS/fs1/inst/apps/VISION_sourcing/appl/admin/VISION_sourcing.xml
addsourcingpatch.sh
export PATH=/u01/install/APPS/fs2/FMW_Home/webtier/perl/bin:$PATH
cd /u01/install/APPS/fs2/EBSapps/comn/clone/bin
perl ./adclonectx.pl addnode
contextfile=/u01/install/APPS/fs2/inst/apps/VISION_supplier/appl/admin/VISION_supplier.xml \
pairsfile=/u01/install/APPS/pairs/sourcing/pairs/VISION_sourcing_patch.txt \
outfile=/u01/install/APPS/fs2/inst/apps/VISION_sourcing/appl/admin/VISION_sourcing.xml
Section 5.3.2.22: Add the secondary external application tier node to the farm
Note: You must ensure that the WebLogic Administration Server is running from both the run and patch edition file
system on the primary application tier node before proceeding with the steps given below. You can check the status of the
Weblogic Administration Server for both the run and patch edition file system by executing the command
<INST_TOP>/admin/scripts/adadminsrvctl.sh status
Login to the secondary application tier node sourcing and execute the scripts to add the run and patch
edition file system. The scripts must be executed in serial mode on run file system followed by patch.
For example:
Logon to the sourcing.example.com node, execute
$ sh /u01/install/APPS/pairs/procurement/addsourcingrun.sh
$ sh /u01/install/APPS/pairs/procurement/addsourcingpatch.sh
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 61/74
11/27/2019 Document 1375670.1
Section 5.3.2.23: Sync Up the Context File and Update Configuration On All Nodes
Follow the instructions given below on all application tier nodes to sync up the context file and configuration files.
Login to all the application tier nodes and execute the the following scripts to sync up the context
file and configuration files for the run file system
Source the EBSapps.env file
$ . ./u01/install/APPS/EBSapps.env run
$ perl $AD_TOP/bin/adSyncContext.pl contextfile=$CONTEXT_FILE
If you are a later version of the AD/TXK Code level, follow the instructions given in
section 5.3.2.4-5.3.2.7 ( Register the new topology from the newly added application tier
node) of My Oracle Support Document 1383621.1, Cloning Oracle E-Business Suite Release
12.2 with Rapid Clone, to register the new topology.
If you are a later version of the AD/TXK Code level, follow the instructions given in
section 5.3.2.4-5.3.2.7 ( Register the new topology from the newly added application tier
node) of My Oracle Support Document 1383621.1, Cloning Oracle E-Business Suite Release
12.2 with Rapid Clone, to register the new topology.
Perform the following sanity tests to check the health of the multi-node application tier system.
Start and stop the application tier processes from the current run file system. The processes must be started on the
primary application tier node first followed by the secondary application tier nodes. The application tier processes can
be started/stopped using the adstrtal.sh/adstpall.sh script from the <INST_TOP>/admin/scripts directory.
Sign on to Oracle E-Business Suite application from the multiple web entry points to make sure multiple web entry
points work.
Choose a forms responsibility and launch forms.
Login to the WebLogic console and fusion middleware console using the WebLogic admin credentials. Make sure you
can view all the managed servers in RUNNING status from the servers menu.
Submit concurrent requests to make sure the concurrent requests can be executed and their output/log can be viewed
from the client.
Execute an empty online patching cycle using the online patching utility adop. An empty patching cycle can be executed
from the run edition file system by following the instructions given in the table below.
$ . ./u01/install/APPS/EBSapps.env run
$ adop phase=prepare
$ adop phase=cutover
Below is a list of Oracle certified E-Business Suite Release 12 products that can be deployed for external use. If you are
planning on deploying a product that is not listed in the table below, log a Service Request with Oracle Support requesting
certification of that product for external deployment. The "URL Firewall Rules" column indicate whether there are any special
rules that need to be enabled in the URL FW for the product to function. An "Yes" in the column indicates there are special
rules.
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 63/74
11/27/2019 Document 1375670.1
Section 7.1: Set the Responsibility Trust Level and Update Required Profile Option Values
If any of the following products are installed and configured, you must refer to the respective documents as shown in the table
below for more information on which responsibilities can be made externally accessible from the Internet.
Please refer to Section 4.3: Update List of Responsibilities for the necessary steps to make the responsibilities listed below
available for the external users.
To Perform any product-specific profile settings, you must refer to the respective product documents shown below.
iSupplier Portal
iSupplier Portal Full Access POS: External URL Oracle iSupplier Portal
POS Supplier Guest User POS: Internal URL Release Notes (Document
Plan to Pay Supplier View 1583748.1)
Plan, Source, Pay Supplier Enable Web Access By
View External Supplier Users to
Source to Pay Supplier Oracle iSupplier Portal and
View Oracle Sourcing (Document
Supplier Profile Manager 308271.1)
Procure to Pay Supplier
View
Oracle Sourcing
Sourcing Supplier PON: External Oracle Sourcing Release
Applications Notes for Release
Framework Agent 12.2.3 (Document 1605610.1
PON: External login )
URL Enable Web Access By
External Supplier Users to
Oracle iSupplier Portal and
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 64/74
11/27/2019 Document 1375670.1
iSupport
iSupport Business User Oracle iSupport
iSupport Guest User Implementation Guide
iSupport Individual User
iSupport Primary User
iSupport Site: Business
User
iSupport Site: Individual
User
iSupport Site: Guest User
iSupport Site: Primary
User
iStore
IBE_CUSTOMER IBE: iStore Secure Oracle iStore Implmentation
URL Guide
IBE: iStore Non
Secure URL
iRecruitment
iRecruitment External Site Oracle iRecruitment
Visitor Implementation and User
iRecruitment External Guide
Candidate
iRecruitment Employee
Site Visitor
iRecruitment Employee
Candidate
iRecruitment Agency
Oracle Learning
Management Learner Self-Service Oracle Learning Management
Implementation Guide
Oracle iReceivables
iReceivables Account Oracle iReceivables
Managament Implementation Guide
iReceivables 2.0
Anonymous Internal
Oracle
Transportation Transportation Execution Oracle Transportation
Execution Carrier User Execution User Guide
Oracle Partner
Relationship Partner Super User PV: Locator Server Oracle Partner Management
Management Default Partner User URL Implementation and
PV: System Login Administration Guide
URL
PV: iStore Login
URL
PV:Self Service URL
with Workflow
Notification
Oracle Marketing
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 65/74
11/27/2019 Document 1375670.1
Oracle Contracts
Core OKC: Contracts Online -
External Party Access
Oracle Service
Contracts Service Contracts
Electronic Renewals
Service Contracts Online
Acceptance
Oracle Collaborative
Planning Supply Chain Collaboration Oracle Collaborative Planning
Planner Implementation and User's
Supply Chain Collaboration Guide
Manager
Order Information
Portal Order Information OM: Records on
External User Summary Page for
External Users
OM: Customer
Service Feedback
OM: Customer
Service Report
Defect
Oracle Internet
Expenses Internet Expenses
Expenses Analysis and
Reporting
Oracle Payroll
Online Payslip (For
localizations)
W2 and W4 for US
Legislation
Oracle Quoting
Quoting User
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 66/74
11/27/2019 Document 1375670.1
iStore uses Java caching framework to cache frequently used objects in the JVM. Each JVM will have a copy of an object in the
Java Cache. When an object is updated by one JVM, it is invalidated in all JVMs across all Applications tier servers.
At the present time, cache updates in the Applications internal application tier server will not get reflected in the external
application tier server. There are a couple of options to work around this known issue:
1. Shutdown and restart the Oracle HTTP server/WebLogic Managed servers on the Applications external server when an
object in a cache is updated on the internal application tier server. When JVMs are restarted, objects will be freshly
fetched into the cache.
2. Set Time-To-Live values for certain cache components so that these cache objects are invalidated on a periodic basis.
Cache objects get refreshed when they are accessed for the first time after an invalidation. Since Time-To-Live values
themselves are cached, the Oracle HTTP server/WebLogic Managed servers on the external application tier server
needs to be bounced once
for the new values to take effect.
The exact Time-To-Live values will depend upon business requirements, how often objects in a cache component are
updated and what the tolerance level is for having stale objects in the cache. Information on setting up Time-To-Live
interval is available at:
Oracle Applications CRM System Administrator's Guide in the Virtual Applications Documentation Library
Sections Managing Component Caches and Editing Component Cache Details.
iStore uses Java Cache extensively to cache product catalog objects. Information on iStore Cache Components is
available at:
Oracle iStore Implementation and Administration Guide in the Virtual Applications Documentation Library
Section Component Caches for Oracle iStore in JTT.
For better performance, it is recommended to deploy iStore public pages under HTTP and employ HTTPS only for those pages
and processes that transmit sensitive data. In DMZ deployment, this requires the reverse proxy server to listen on two ports,
one for HTTP and the other for HTTPS. Both the HTTP and HTTPS reverse proxy listeners should be configured to forward the
requests to the external application tier server. In this configuration, values for profiles "IBE: iStore Non Secure URL" and
"IBE: iStore Secure URL" should point to HTTP and HTTPS reverse proxy server URL respectively.
If iStore public pages are also deployed via HTTPS, values of both the profiles "IBE: iStore Non Secure URL" and "IBE: iStore
Secure URL" should point to the HTTPS reverse proxy server and port and can not be left empty. Refer to section "Setting up
Secure Socket Layer Connections" of Oracle iStore Implementation and Administration Guide in the Virtual Applications
Documentation Library for more details.
Section 7.2.3: AltBatchValidateURL Setting for iStore Integration with Oracle Configurator
In a DMZ configuration, it is likely that the database installed in the intranet can not communicate with the external application
tier server due to fact that the external application tier server http port is not opened on the firewalls that separate the
intranet servers from dmz servers. In such situations, the AltBatchValidateURL should be set to the URL for the
configurator servlet on the internal application middle tier server.
iStore profile options IBE_SECURE_URL and IBE_NON_SECURE_URL are set at the site level for an E-Business Suite
environment.
Due to this restriction, deploying iStore in a DMZ configuration where the internal and external domains differ will result in
intermittent losses of end-user session information and user redirects to the incorrect minisites. This known issue is expected
to be resolved in future iStore releases.
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 67/74
11/27/2019 Document 1375670.1
The DMZ Forward Proxy should be configured whether or not a DMZ Reverse Proxy is used, and must be configured to handle
outbound DMZ-to-Internet and outbound DMZ-to-Intranet HTTP traffic.Oracle E-Business Suite Application Tier
configured in the DMZ must have access to a forward proxy server. This is required by the external modules configured in the
DMZ for connecting to external/internal sites to Perform certain tasks like resume parsing for iRecruitment. Other modules
that are known to use the forward proxy are Oracle Transportation Management and Oracle partner relationship
management.
Set the proxy variables in the applications context file as shown in the table below and run autoconfig:
All application tier nodes both in the DMZ and intranet must use the same proxy server . Please work with your system
administrator in obtaining the correct value for the proxy variables.
Firewall Impact:
1.If the DMZ Forward Proxy is separated from the DMZ by a DMZ outbound firewall, then customer needs to change the DMZ
outbound firewall configuration to allow for outbound DMZ-to-"DMZ Forward Proxy" HTTP communication.
2. If the DMZ Forward Proxy is within the DMZ, then the customer needs to change the DMZ outbound firewall configuration
to allow for outbound "DMZ Forward Proxy"-to-Internet and outbound "DMZ Forward Proxy"-to-Intranet HTTP
communication.
Note: Oracle does not certify specific reverse proxy solutions from third-party vendors. The instructions included in this
document are generally applicable to third-party reverse proxy solutions, including (but not restricted to) Apache,
Microsoft Proxy Server, and other products.Always use the latest version of the software wherever applicable for security
reasons.
A reverse proxy server is an intermediate server that sits between a client and the actual web server and makes requests to
the web server on behalf of the client. The client is unaware of the presence of the reverse proxy.
Adds a level of isolation between the client and the actual server
Allows using standard web port numbers (80 and 443) on the external interface while running the actual web server on
higher numbered ports thus avoiding having to start the actual web application server processes as root.
Allows certain rules (or filters) to limit the http requests that are presented to the actual web server
Optionally allows for caching of contents
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 68/74
11/27/2019 Document 1375670.1
There are pros and cons for each of these solutions, and the customer must choose according to preferences, supportability,
existing IT standards and local policies.
Sample instructions to configure a reverse proxy server are given in the following link
The purpose of the URL Firewall is to ensure that only URLs required for the externally exposed functionality can be accessed
from the internet.
The URL firewall is implemented as a whitelist list of URLs required; any URL request that is not matched in the whitelist list is
refused. This will limit the exposure of your Oracle E-Business Suite deployment by reducing the attack surface available to
external parties.
The URL Firewall can be deployed on the external application tier or in the reverse proxy. If you are deploying a reverse proxy
that can process mod_rewrite rules, we recommend that the URL Firewall be deployed on the reverse proxy in order to reject
un-authorized requests as early as possible.
The URL Firewall is shipped as an apache configuration file containing rewrite rules interpreted by mod_rewrite. The URL
Firewall configuration file (url_fw.conf) will be generated on all the application tiers by the AutoConfig utility. To Include this
configuration file in Oracle HTTP Server configuration file (httpd.conf), Perform the following steps:
Change value of the autoconfig variable s_enable_urlfirewall. By default the value of this variable is set to '#' which
indicates that the URL firewall is disabled. To enable the URL firewall, the pound sign '#' must be removed .
You must ensure that for nodes that are marked as external, this configuration file should be included in the http server
configuration.
The file consists of blocks of URLs that may be required depending on the deployed product mix and ends with a rule that
rejects the request if it has not been matched by one of the enabled rules. You will have to manually edit this file to enable the
URLs in the block that corresponds to the product(s) you are deploying for external access.
You will always need the STATIC, COMMON and LOCAL blocks. Depending on the product(s) you are deploying, you may need
additional blocks of URLs enabled. This is summarized in the table below.
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 69/74
11/27/2019 Document 1375670.1
In addition to uncommenting the blocks of URLs specified above you will have to consider and decide how to handle the
following for your deployment:
The syntax of the ErrorDocument directive in url_fw.conf need modification (to use double quotes), if you have configured
apache2 as the reverse proxy server.
In the shipping version of url_fw.conf external users will be presented with the standard Apps Login page when they go to /
(actually http://yoursite.example.com ) on your external site.
If you are deploying products that allow users to surf part of the site prior to authentication, presenting them with a login
page may not make any sense. For example if you are deploying iStore, users have an expectation to be able to browse the
goods without logging in. If you are deploying iRecruitment, maybe external users can browse available job postings prior to
identifying themselves.
If you are integrating the external access to E-Business Suite via an existing company website, you may want to include a new
page with your corporate branding and links to the appropriate entry points of Oracle Applications.
To change the initial (/) page, locate the INITIAL PAGE block and change the first line in that block to provide the page of your
choice.
the rule says: upon a request for /, redirect ([R]edirect) to /OA_HTML/AppsLogin and stop further rewriting ([L]ast).
If your deployment is only iRecruitment or only iStore the above rule could be replaced with one of the following
For help in selecting an appropriate initial page, see the Implementation Guide for the products you are deploying externally.
Section 7.5.2: URL Firewall Configuration for Webservices Deployed in the DMZ
A Webservices URL Firewall configuration file url_fw_ws.conf must be generated in the application tier nodes that host the
external modules to prevent unauthorized access to SOAprovider servlet. This configuration file can be generated by
Performing the following steps:
$ txkrun.pl -script=GenWebServiceUrlFwConf
Successful completion of the the script given above will generate url_fw_ws.conf at Oracle HTTP Server Instance Home
. This configuration file will then be automatically included when autoconfig is executed on the external nodes.
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 70/74
11/27/2019 Document 1375670.1
Related Documentation
Oracle Tested Load Balancers, Firewalls and SSL Accelerators
Document 1388152.1, Overview of Single Sign -On Integration Options for Oracle E-Business Suite
Document 1576425.1, Integrating Oracle E-Business Suite 12.2 with Oracle Access Manager
Document 1371932.1, Integrating Oracle E-Business Suite 12.2 with Oracle Internet Directory 11gR1
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 71/74
11/27/2019 Document 1375670.1
Known Issues
Known
Date Resolution
Issue
February Support The workaround is to the ensure that the following configuration updates are made:
24, 2014 for .
clusters
based Customize the Oracle E-Business Suite applications context file on each node to remove the cluster d
on Web cluster. For example see s_oacore_nodes, s_forms_nodes,s_oafm_nodes,s_forms-c4ws_no
Entry
Point: Customize the Oracle HTTP Server configuration files like mod_wl_ohs.conf, apps.conf present i
that are not participating in the cluster configuration.
An example is given below to illustrate the change required in applications context file and config files. The
server setup. Similar changes must be done for all the managed servers. Perform the required changes on
The changes will be carried over automatically to the patch edition of the file system during an online patch
The default configuration laid down by Rapid Install/Rapid Clone will include all nodes in the cluster configu
desirable as the application tier nodes in the configuration belong to two different entry points.
<oacore_nodes
oa_var="s_oacore_nodes">finance.example.net:7203,procurement.example.net:7203,sourcing.example.co
mod_wl_ohs.conf
WebLogicCluster finance.example.net:7203,procurement.example.net:7203,supplier.example.com.com:720
apps.conf
BalancerMember http://finance.example.net:7203/OA_HTML/classes
BalancerMember http://procurement.example.net:7203/OA_HTML/classes
BalancerMember http://supplier.example.com:7203/OA_HTML/classes
BalancerMember http://sourcing.example.com:7203/OA_HTML/classes
You need to make manual updates to the application context files on all nodes and the configuration files (
unwanted nodes from the cluster configuration. For example on nodes finance/procurement, the adjusted c
<oacore_nodes oa_var="s_oacore_nodes">finance.example.net:7203,procurement.example.net:7203</oa
mod_wl_ohs.conf
WebLogicCluster finance.example.net:7203,procurement.example.net:7203
apps.conf
BalancerMember http://finance.example.net:7203/OA_HTML/classes
BalancerMember http://procurement.example.net:7203/OA_HTML/classes
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 72/74
11/27/2019 Document 1375670.1
<oacore_nodes oa_var="s_oacore_nodes">sourcing.example.com:7203,supplier.example.com:7203</oaco
mod_wl_ohs.conf
WebLogicCluster supplier.example.com.com:7203,sourcing.example.com:7203
apps.conf
BalancerMember http://supplier.example.com:7203/OA_HTML/classes
BalancerMember http://sourcing.example.com:7203/OA_HTML/classes
Change Record
Date Description
Documentation Accessibility
For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at
https://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.
Oracle customers have access to electronic support through My Oracle Support. For information, visit
https://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit https://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if
you are hearing impaired.
Copyright © 2014, 2019, Oracle and/or its affiliates. All rights reserved.
This software and related documentation are provided under a license agreement containing restrictions on use and disclosure
and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law,
you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or
display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless
required by law for interoperability, is prohibited.
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 73/74
11/27/2019 Document 1375670.1
The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any
errors, please report them to us in writing.
If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the
U.S. Government, the following notice is applicable:
U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs
installed on the hardware, and/or documentation, delivered to U.S. Government end users are “commercial computer
software” pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such,
use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated
software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license
restrictions applicable to the programs. No other rights are granted to the U.S. Government.
This software or hardware is developed for general use in a variety of information management applications. It is not
developed or intended for use in any inherently dangerous applications, including applications that may create a risk of
personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all
appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates
disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.
Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective
owners.
Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under
license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD
Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The
Open Group.
This software or hardware and documentation may provide access to or information on content, products, and services from
third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with
respect to third-party content, products, and services. Oracle Corporation and its affiliates will not be responsible for any loss,
costs, or damages incurred due to your access to or use of third-party content, products, or services.
REFERENCES
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=mycvoxfi5_506&id=1375670.1 74/74